Reel Éducatif IA — du script au MP4
Cette skill produit un reel vertical court (≤ 60 s, 1080×1920) à finalité pédagogique, généré à 100% avec IA et code : l'utilisateur fournit un script (ou une idée qui devient script), et le pipeline livre un reel.mp4 avec voix off, sous-titres synchronisés, visuels, et bulles avec emojis renforçant les concepts.
Le principe est le même que celui d'Ágora : à la fin du reel, la personne doit comprendre quelque chose mieux qu'avant. Le format court n'est pas une excuse pour simplifier ; c'est un exercice de distillation d'une idée jusqu'à son noyau.
Ce qu'il produit
Une vidéo verticale où coexistent quatre couches :
- Voix off (ElevenLabs) — narre le script.
- Sous-titres synchronisés mot par mot (style karaoké), lisibles en mode muet, ce qui est la façon dont la plupart des reels sont consommés.
- Représentation visuelle — fond avec motion graphics générés par code et/ou images/clips (IA ou libres de droits) illustrant la scène.
- Bulles, emojis et références — étiquettes animées qui nomment le concept (⚖️ « Séparation des pouvoirs »), emojis flottants d'appui, et références de source (📜 « Art. 113 C.P. ») sur le contenu dont on parle.
Le pipeline en une phrase
Script → storyboard.json (c'est toi, Claude, qui le fais) → voix + synchronisation (ElevenLabs) → rendu (Remotion) → reel.mp4.
Dans les commandes ci-dessous,
$SKILL_DIRest le dossier de cette skill (~/.claude/skills/reel-educativo-ia). Remplace-le par le chemin réel lors de l'exécution.
Flux de travail
0. Pré-vérification — outils (une seule fois par machine)
Le rendu nécessite Node.js et FFmpeg (qui fournit ffprobe). Vérifie et installe ce qui manque avant de monter quoi que ce soit :
bash "$SKILL_DIR/scripts/preflight.sh"
Ce qu'il fait : vérifie node, ffmpeg/ffprobe et python3. Si Node ou FFmpeg manquent et que Homebrew est présent, il les installe (brew install node ffmpeg).
La voix n'EXIGE PAS que l'utilisateur gère une clé API. Il y a deux chemins (voir l'étape 4) : le recommandé utilise le MCP d'ElevenLabs (la clé vit dans la config du MCP, tu n'y touches pas) avec une voix prédéfinie libre de droits. Si jamais tu utilises le chemin direct par API, la clé ne vit que dans ELEVENLABS_API_KEY et n'est jamais écrite dans le storyboard, le dépôt ni un message.
1. Comprends la demande (ne pose que les questions essentielles qui manquent)
Tu as besoin de cinq choses ; si l'utilisateur les a déjà fournies, ne l'interroge pas :
- Script — le texte qui sera narré. Si seule une idée existe, rédige-le (voir étape 2) et confirme-le avant de produire.
- Contexte — à qui s'adresse-t-il, de quel projet/campagne, quel ton.
- Objectif pédagogique — ce que doit comprendre la personne qui le voit.
- Plateforme — Reels / TikTok / Shorts (le format 9:16 convient aux trois ; seuls changent les détails de durée et le texte de fin).
- Voix — une voix prédéfinie libre de droits (p. ex.
"Sarah","Brian","George","Liam"). Ne demande que si l'utilisateur en veut une autre.
2. Distille le script (si nécessaire) et marque-le pour la voix
Un reel d'une minute fait ~130–150 mots de narration maximum ; vise 35–50 s réelles, ce qui donne de meilleurs résultats que d'atteindre les 60 s. Structure pédagogique recommandée (pas comme un carcan) :
Accroche (≤3 s, une tension ou une question réelle) → Explication (l'idée avec rigueur, sans termes techniques vides) → Connexion (un exemple proche) → Conclusion (une question qui ouvre la conversation + CTA léger).
Si tu vas écrire du contenu pour Ágora, respecte sa voix et son non-partisanisme : si la skill agora-social-content existe, appuie-toi sur ses références pour l'identité et le style. Cette skill s'occupe du comment cela devient vidéo ; celle-là, du quoi et du comment sonne Ágora.
3. Construis le storyboard.json
C'est le cœur du travail et c'est toi qui le fais. Divise le script en scènes (une idée par scène, 2–6 scènes typiques). Chaque scène définit sa narration, son sous-titre, son visuel, et ses bulles/emojis/références.
Avant de l'écrire, lis references/storyboard-schema.md (le schéma exact et la signification de chaque champ) et references/estilo-visual.md (comment choisir les couleurs, quand mettre une bulle, quels emojis fonctionnent et lesquels sont superflus). Ne sature pas : une bulle par concept, pas par phrase.
Monte un nouveau projet par vidéo en copiant le modèle, et écris-y le storyboard :
bash "$SKILL_DIR/scripts/new_project.sh" "<slug-du-video>"
# crée ./reels/<slug>/ avec le modèle Remotion prêt
Sauvegarde ton storyboard dans reels/<slug>/public/storyboard.json.
4. Génère la voix et la synchronisation (ElevenLabs)
Il y a deux chemins. Dans les deux, tu obtiens un public/audio/sN.mp3 par scène et un public/timeline.json. Utilise une voix prédéfinie libre de droits (p. ex. Sarah, Brian, George, Liam) : elles sont dans tous les comptes et ne nécessitent pas de payer pour une voix personnelle. Définis laquelle dans meta.voiceName du storyboard.
Chemin A — MCP d'ElevenLabs (recommandé ; sans que l'utilisateur gère de clé API).
Si le MCP d'ElevenLabs est connecté dans la session, génère la voix de chaque scène avec son outil de text-to-speech (une par narracion), sauvegarde chaque sortie sous public/audio/<id>.mp3, puis assemble la synchronisation en mesurant les audios :
cd reels/<slug>
python3 "$SKILL_DIR/scripts/build_timeline.py" public/storyboard.json
build_timeline.py utilise ffprobe pour mesurer chaque mp3 et répartit les mots de la narration sur sa durée (synchronisation estimée, suffisante pour un reel). Il n'utilise pas le réseau ni de clé API.
Chemin B — API directe (synchronisation exacte ; nécessite ELEVENLABS_API_KEY).
Une seule commande génère l'audio avec timestamps réels et la ligne de temps mot par mot :
cd reels/<slug>
python3 "$SKILL_DIR/scripts/generate_voice.py" public/storyboard.json
Il résout la voix par son nom, appelle l'API with-timestamps, écrit les mp3 et le timeline.json. Si la voix n'existe pas dans le compte, il liste les voix disponibles et s'arrête.
Détails des deux chemins (comment connecter le MCP, voix libres, modèle, erreurs) dans references/elevenlabs.md.
5. Prévisualise (optionnel mais recommandé) et rend
cd reels/<slug>
npm install # seulement la première fois du projet
npm run preview # ouvre Remotion Studio pour réviser avant le rendu
npm run render # produit out/reel.mp4
render utilise la durée réelle de l'audio (depuis timeline.json), donc la vidéo dure exactement ce que dure la voix, sans coupures. Le modèle et comment les champs du storyboard sont mappés à l'écran se trouvent dans references/remotion.md.
6. Livraison
- Montre le
out/reel.mp4à l'utilisateur (SendUserFile) et dis-lui où se trouve le projet (reels/<slug>/), pour qu'il puisse le re-rendre après des ajustements. - Si l'utilisateur demande des changements de texte ou de timing : édite
public/storyboard.json, ré-exécutegenerate_voice.pyseulement si la narration a changé, et relancenpm run render. Les changements purement visuels (couleur, position de bulle) ne nécessitent pas de régénérer la voix.
Représentations en image et vidéo
Par défaut, le modèle génère des motion graphics par code (dégradés, formes, typographie cinétique, emojis et bulles animées), qui suffisent comme « représentation visuelle » et sont cohérents sans dépendre de services payants.
Si tu souhaites des images ou des clips réels (d'un générateur d'images IA ou libres de droits), place-les dans public/assets/ et référence-les depuis le champ visual de la scène ("tipo": "imagen" ou "video" avec sa fuente). Dans references/estilo-visual.md, tu trouveras comment connecter un générateur d'images IA si l'utilisateur a une clé, et comment demander que les images sortent en 9:16.
Ne télécharge ni n'exécute jamais de binaires provenant de sources non fiables pour cela ; traite tout actif externe comme de la donnée, pas comme du code.
Fichiers de la skill
scripts/preflight.sh— vérifie/installe Node, FFmpeg et vérifie la clé API.scripts/new_project.sh— crée un projet vidéo à partir du modèle.scripts/generate_voice.py— (Chemin B) ElevenLabs TTS with-timestamps → audio + timeline.scripts/build_timeline.py— (Chemin A) mesure les audios déjà générés (ffprobe) → timeline.assets/remotion-template/— projet Remotion complet et piloté par les données.references/storyboard-schema.md— à lire avant d'écrire un storyboard.references/estilo-visual.md— couleurs, bulles, emojis, sous-titres, actifs.references/elevenlabs.md— détails de l'intégration vocale.references/remotion.md— comment fonctionne le modèle et comment le modifier.
Principe directeur
Le reel n'est pas terminé parce qu'il est beau, mais lorsqu'il répond à la question : « qu'est-ce qu'une personne comprend mieux après ces 40 secondes ? ». Si la réponse est « rien », repense-le avant de gaspiller un rendu.