Communitygithub.com

explainer-video

Créez des vidéos explicatives techniques verticales (9:16) de 2 à 3 minutes pour un public non technique, présentées par le personnage de dessin animé « Hellboy », dans le style des bobines de référence (suivi de chapitres, diagrammes, sous-titres karaoké, personnage synchronisé, voix indienne-anglaise). Utilisez cette compétence pour réaliser, scénariser, storyboarder, rendre ou améliorer une vidéo explicative / reel / court métrage sur n'importe quel sujet technique.

Qu'est-ce que explainer-video ?

Cette compétence transforme un sujet technique unique en une vidéo MP4 verticale (1080×1920) de 2 à 3 minutes, compréhensible dès la première visualisation par un public non technique. Le style visuel, le rythme et la structure du script sont clonés à partir d'une chaîne de référence, mais le personnage (Hellboy) et la voix sont fixes. Vous rédigez uniquement un fichier de script (`script.md`) et un fichier `storyboard.json` ; le moteur s'occupe de la voix, des sous-titres, de l'animation, du personnage, de la musique et du rendu. Le processus est entièrement automatisé : génération du projet, validation stricte (0 erreurs requises), prévisualisation d'une image par scène, puis rendu final. Des valeurs non négociables garantissent la cohérence et la qualité : Hellboy n'est jamais redessiné, la voix est fixée dans la configuration, la longueur du récit est limitée à 360–470 mots (2:00–2:50), chaque phrase modifie l'écran, et la simplicité prévaut sur la simplification trompeuse. La compétence prend en charge plusieurs plateformes (Claude, Cursor, Codex, etc.) grâce à sa conception basée sur des fichiers texte et des outils en ligne de commande.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/bhuvanchandmaddi/video-generator-skill/tree/HEAD/skills/explainer-video

Demander à votre IA préférée

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

Documentation

Compétence de Vidéo Explicative (Hellboy)

Vous transformez un sujet technique en une vidéo MP4 1080×1920 de 2 à 3 minutes qu'une personne non technique comprend dès la première visualisation. Le style visuel, le rythme et la structure du script sont clonés à partir d'une chaîne de référence (analysée dans docs/01-style-bible.md). Deux éléments sont délibérément les nôtres : le personnage (Hellboy) et la voix.

Vous écrivez uniquement des fichiers texte (un script et un storyboard.json). Le moteur dans engine/ gère la voix, les sous-titres, l'animation, le personnage, la musique et le rendu.


Lorsque l'utilisateur donne juste un sujet

Faites tout le travail sans poser de questions supplémentaires :

  1. Créez un slug à partir du sujet (how-dns-works) et exécutez python engine/make_video.py new videos/<slug>.
  2. Écrivez videos/<slug>/script.md (docs/02), puis videos/<slug>/storyboard.json (docs/03 + docs/04). Copiez les modèles de examples/upi-explained/.
  3. Exécutez python engine/validate_storyboard.py videos/<slug>. Corrigez chaque ERREUR et répétez jusqu'à ce que la sortie affiche 0 error(s).
  4. Exécutez python engine/make_video.py preview videos/<slug>. Si vous voyez des images, vérifiez build/preview.png par rapport à la section B de docs/06 et corrigez.
  5. Exécutez python engine/make_video.py render videos/<slug>. Répondez avec le chemin output/<slug>.mp4, la durée et un résumé de 2 lignes.

Les non-négociables

  1. Hellboy n'est jamais redessiné. Il provient uniquement de character/hellboy/hellboy.js. Vous pouvez définir show, arm (down/point/explain) et expression, rien d'autre. Lisez character/hellboy/CHARACTER_BIBLE.md une fois.
  2. La voix est fixe dans engine/config.json. Ne la modifiez pas par vidéo.
  3. Longueur : 360–470 mots de narration, 2:00–2:50. Phrases ≤ 20 mots.
  4. Chaque phrase change quelque chose à l'écran. Les éléments apparaissent sur leur mot-clé parlé ("at").
  5. Correct plutôt que simple. Simplifiez en omettant des éléments, jamais en disant quelque chose de faux.
  6. Le validateur doit passer (0 erreurs) avant le rendu.

Flux de travail (à faire dans l'ordre)

#ÉtapeLireSortie
1Échafauder–python engine/make_video.py new videos/<slug>
2Planifier + écrire le scriptdocs/02-script-writing.mdvideos/<slug>/script.md (360–470 mots, 7 temps)
3Planifier les visuelsdocs/03-visual-planning.mdliste des scènes : narration → type, titre, personnage
4Écrire le storyboarddocs/04-storyboard-reference.mdvideos/<slug>/storyboard.json (ou meta.json + scenes.jsonl → assemble)
5Valider–python engine/validate_storyboard.py videos/<slug> → corriger jusqu'à 0 erreurs
6Prévisualiser + QAdocs/06-qa-checklist.mdmake_video.py preview videos/<slug> → inspectez build/preview.png, corrigez
7Rendredocs/05-production.mdmake_video.py render videos/<slug> → output/<slug>.mp4
8QA finaldocs/06-qa-checklist.mdscore ≥ 85, tous les éléments OBLIGATOIRES passent

Petit modèle local ? Suivez docs/07-small-model-playbook.md au lieu des étapes 2–5. Il découpe le travail en invites d'une scène à la fois.

Le script en 7 temps (à mémoriser)

Accroche (≤ 22 mots : "X expliqué." / "Comment fonctionne X en réalité ?" / affirmation surprenante / action relatable) → Tension (le mystère) → Feuille de route ("Suivons…") → Corps (3–6 chapitres : concept → sens simple → exemple quotidien → conséquence ; UN exemple récurrent avec une personne nommée) → Rebondissement ("Mais voici la partie intéressante…") → Récapitulation ("Souvenez-vous-en comme ceci." une ligne par chapitre) → Chute (fragments qui font écho à l'accroche : "Un scan. Quatre acteurs. Deux secondes.").

Recette de scène (à mémoriser)

  • 1 scène = 1–3 phrases (8–28 mots, 3–8 s) ; 20–32 scènes par vidéo.
  • Choisissez visual.type dans la table de décision dans docs/03-visual-planning.md. Utilisez 7–12 types différents par vidéo.
  • Montrez Hellboy dans 40–70 % des scènes (toujours : première scène, rebondissement, récapitulation, dernière scène). Cachez-le pour sequence, hub, diagram, compare.
  • Construisez de grands diagrammes sur 2–4 scènes avec "continue": true + objets "shown": true et le même titre.
  • Titres de 2–6 mots avec un mot *accentué*. Étiquettes à l'écran de 1–4 mots.

Commandes (depuis la racine du dépôt)

# activer d'abord :  source .venv/bin/activate   |   Windows : .\.venv\Scripts\Activate.ps1
python engine/make_video.py new       videos/<slug>   # modèles
python engine/make_video.py assemble  videos/<slug>   # meta.json + scenes.jsonl -> storyboard.json
python engine/validate_storyboard.py  videos/<slug>   # doit être 0 erreurs
python engine/make_video.py preview   videos/<slug>   # build/preview.png (1 image par scène)
python engine/make_video.py render    videos/<slug> [--fast]

Première fois sur une machine : ./setup.sh (Linux/macOS) ou setup.ps1 (Windows). Les vidéos terminées atterrissent dans output/<slug>.mp4.

Documentation de référence

  • examples/upi-explained/ (papier chaud) et examples/load-balancer-explained/ (plan) — exemples complets. Copiez leurs modèles.
  • templates/ — script.template.md, storyboard.template.json.
  • docs/01-style-bible.md — ce que fait la référence, mesuré (pourquoi les règles existent).
  • engine/icon_names.txt — tous les 2 359 noms d'icônes autorisés (Lucide).

Skills associés