Communitygithub.com

reel-educativo-ia

Crée des vidéos courtes verticales (reel/short, max 1 minute) à visée pédagogique, générées de bout en bout par IA et code à partir d'un script. Le pipeline transforme le script en storyboard, génère la voix off avec ElevenLabs — en utilisant une voix prédéfinie libre de droits, via son MCP ou son API — et rend avec Remotion un MP4 9:16 avec dialogues, sous-titres synchronisés type karaoké, représentations visuelles (image/vidéo ou motion graphics), et références avec emojis et bulles sur le contenu.

Qu'est-ce que reel-educativo-ia ?

Cette skill produit un **reel vertical court (≤60s, 1080×1920)** à finalité pédagogique, généré à 100% par IA et code. L'utilisateur fournit un script (ou une idée transformée en script) et le pipeline délivre un `reel.mp4` avec voix off, sous-titres synchronisés, visuels, et bulles avec emojis renforçant les concepts. Elle est conçue pour les agents comme Claude Code, Cursor ou Codex, et exploite ElevenLabs (via MCP ou API directe) pour la synthèse vocale et Remotion pour le rendu vidéo. Le principe est le même que celui d'Ágora : après avoir vu le reel, la personne doit **comprendre quelque chose mieux qu'avant**. Le format court n'est pas une excuse pour simplifier à l'excès ; c'est un exercice de distillation d'une idée jusqu'à son noyau essentiel. La skill prend en charge l'ensemble du flux de travail : compréhension de la demande, distillation du script, construction du storyboard, génération de la voix et de la synchronisation, et rendu final. Elle est particulièrement utile pour produire du contenu éducatif pour les réseaux sociaux (Instagram Reels, TikTok, YouTube Shorts) de manière automatisée et reproductible.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/MaaCamii/skill-educativo-video-ia/tree/HEAD/reel-educativo-ia

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

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 :

  1. Voix off (ElevenLabs) — narre le script.
  2. 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.
  3. 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.
  4. 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_DIR est 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écute generate_voice.py seulement si la narration a changé, et relance npm 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.

Skills associés