Communitygithub.com

motion-educator

Créez des vidéos éducatives animées premium (explications, leçons, courts métrages) entièrement codées, avec storyboard détaillé, narration, musique et effets sonores, rendues image par image en MP4.

Qu'est-ce que motion-educator ?

Motion Educator est un agent spécialisé dans la création de films éducatifs animés de haute qualité (20 à 120 secondes, paysage 16:9 ou portrait 9:16), entièrement construits en code. Il est idéal pour les développeurs et créateurs de contenu souhaitant produire des explications visuelles soignées (science, mathématiques, histoire, finance, concepts produits) avec un rendu professionnel : scène éclairée, panneaux de verre, typographie métallique, objets 3D, diagrammes, graphiques, sous-titres, narration, musique et effets sonores. Le processus est rigoureux : un storyboard illustré et vérifié est réalisé en premier, chaque affirmation est sourcée, la narration est écrite comme un discours (en indonésien ou anglais) et interprétée en une seule prise via ElevenLabs, puis l'image est calée sur la voix. L'agent utilise un kit technique (Node.js, Three.js, GSAP, FFmpeg, Python) pour construire, animer et rendre chaque plan de manière déterministe. Il supporte Claude Code, Cursor, Codex et toute interface pouvant exécuter Node.js et ces dépendances. Chaque film est une page web avec une timeline figée, chaque image étant dessinée par seek, garantissant zéro image perdue et une correction/re-rendu indépendant de chaque plan.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/zeative/motion-educator/tree/HEAD

Demander à votre IA préférée

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

Documentation

Motion Educator

Vous créez de courts films éducatifs (20 à 120 secondes, vidéos explicatives paysage ou courts métrages portrait) qui ont l'air coûteux et qui enseignent bien une seule chose. Le film est une page web avec une seule timeline figée : chaque image est dessinée en la recherchant, donc rien n'est jamais perdu et chaque plan peut être corrigé et rendu de nouveau indépendamment. Le kit dans cette compétence est ce moteur. examples/ contient des films terminés réalisés en suivant cette compétence, chacun avec son storyboard, sa source, sa feuille de repérage et sa narration : langit-biru (sous-titres uniquement, le plus révisé) et petir-guntur (un court métrage narré) sont ceux à lire en premier.

Lisez uniquement la référence dont vous avez besoin pour l'étape en cours.

ÉtapeÀ lire
Décider quoi enseigner et dans quel ordrereferences/pedagogy.md
Écrire et dessiner le storyboard (la porte)references/storyboard.md
Choisir le look, l'accent, la lumière de scène, la 3Dreferences/look.md
Construire le film avec le kitreferences/engine.md, puis references/motion.md
Écrire la narration : du discours, pas des sous-titres ; registre indonésien et anglaisreferences/narration.md
La voix : la choisir, interpréter une seule prise avec ElevenLabs, couper le film dessusreferences/voice.md
Musique, effets sonores, le mixagereferences/sound.md
Vérifier le rendu, révision indépendantereferences/review.md
Rendu avec raea au lieu du navigateurreferences/raea.md

Ce qui ne plie jamais

  1. Storyboard d'abord, et il est dessiné. Aucun fichier film n'est écrit tant que storyboard.json ne passe pas kit/tools/storyboard.mjs avec zéro erreur et que la personne n'a pas vu le storyboard. Chaque plan a des images dessinées (comment il commence, ce qui se passe, comment il finit), esquissées dans les coordonnées réelles du cadre, afin que la construction puisse être coupée directement à partir d'elles. Si la personne a demandé une exécution sans surveillance, envoyez le storyboard et continuez ; sinon attendez leur oui.
  2. Vrai, avec sources. Chaque nombre et chaque affirmation à l'écran se trouve dans la fiche d'information du storyboard avec leur origine. Si vous ne pouvez pas trouver la source, ne le dites pas. Ce qui est dessiné correspond à ce qui est écrit : une barre, un compteur ou un chemin qui représente un nombre est calculé à partir de ce nombre, un diagramme qui n'est pas à l'échelle le dit à l'écran, et un nombre apparaît à sa valeur (sans compter à travers des valeurs qui sont fausses).
  3. Il s'explique en muet. L'image et les mots à l'écran portent l'explication ; la voix et le son la font atterrir. Un spectateur novice avec le son coupé peut dire ce qu'il a appris. L'étape sur laquelle repose toute l'explication est dessinée comme un mécanisme (ce qui entre, ce qu'il rencontre, ce qui sort, où il aboutit), jamais laissée au seul sous-titre.
  4. Une seule horloge. Chaque valeur animée est une fonction du temps de la timeline. Pas d'animations CSS, pas de boucles requestAnimationFrame, pas de Date.now(), pas d'aléatoire non initialisé.
  5. Le storyboard est la source du temps. Le film lit les débuts et fins de plan depuis storyboard.json ; les sous-titres et le rail de chapitre sont générés à partir de lui. Changez le plan là, jamais à la main dans le film. Dans un film qui parle, la prise enregistrée écrit ces temps (voice.mjs).
  6. Vous ne notez pas votre propre travail. Les arrêts sur image de chaque plan sont examinés avant un rendu complet, des mesures sont effectuées sur le rendu, et un nouveau relecteur qui n'a pas construit le film juge le résultat (references/review.md).
  7. Un film qui parle est écrit comme un discours et interprété en une seule prise. Le script est écrit en entier et dit à voix haute avant qu'aucun plan n'existe ; il est interprété une fois, du début à la fin, et l'image est coupée sur la voix. Jamais une phrase par plan, jamais un enregistrement par phrase, jamais une pause ajustée pour correspondre à un plan.
  8. Dites ce qui n'a pas été vérifié. Vous ne pouvez pas entendre. Dites que le mixage a été réglé par mesure, nommez ce à quoi une personne doit prêter attention, et livrez une version sans musique à côté du mixage complet.

Flux de travail

0. Un espace de travail

Le kit est copié dans le projet de la personne, jamais utilisé depuis le dossier de la compétence elle-même.

node <skill>/kit/tools/new.mjs <workspace> <film-name>   # copie kit/ et package.json si manquant, crée la structure films/<film-name>/
cd <workspace> && npm install                            # three.js, GSAP, les polices
sh kit/audio/fetch.sh                                    # la bibliothèque sonore (non commitée : licence)

Nécessite Node 20+, Playwright avec Chromium, FFmpeg, et Python 3 avec numpy pour le mixage. node kit/tools/doctor.mjs vérifie tout et dit quoi installer. Ajoutez --portrait à new.mjs pour un court métrage 1080x1920.

1. Brief (quelques lignes, dans l'en-tête du storyboard)

Qui regarde, ce qu'ils savent déjà, et la promesse : la phrase qu'ils peuvent dire après avoir regardé. Un film, une promesse. Si le sujet nécessite deux promesses, ce sont deux films. Choisissez la langue que le public lit, le format (paysage pour une leçon, portrait pour un court métrage) et si le film parle ou explique avec des sous-titres seuls.

2. Recherche et fiche d'information

Listez chaque affirmation que le film fera, chacune avec sa source, comme facts dans storyboard.json. Préférez les sources primaires et institutionnelles. Faites le calcul vous-même et montrez-le (un nombre comme "5,9x" est écrit avec ce à partir de quoi il est calculé). Écrivez ce que vous simplifiez et décidez comment le film sera honnête à ce sujet.

3. Le script, si le film parle

Suivez references/narration.md : une question, écrite comme un discours continu dans le registre du public, dite à voix haute et chronométrée, avant qu'il n'y ait une liste de plans. Puis coupez-la en plans : la voice de chaque plan parlant est son extrait du script.

4. Le storyboard : la porte

Suivez references/storyboard.md. En bref : actes, puis plans (une nouvelle image toutes les trois secondes environ), chaque plan avec ce qu'il enseigne, son sous-titre, ce qui est à l'écran, le mouvement, ce qui passe au plan suivant, la transition, le son, quoi vérifier, les faits qu'il cite, et deux ou trois images dessinées. Coupez sur le temps de la musique.

node kit/tools/storyboard.mjs films/NAME --png     # zéro erreur, puis montrez films/NAME/storyboard/*.png

Envoyez les pages à la personne. Les feuilles de contact (tout le film en images) vont en premier.

5. La prise, si le film parle

Suivez references/voice.md : choisissez une voix native de la langue (laissez la personne en entendre deux ou trois si possible), interprétez tout le script en une seule prise, et coupez le film dessus. Les temps du storyboard sont désormais ceux de la prise.

node kit/audio/voice.mjs films/NAME --script                       # la prise à interpréter
node kit/audio/voice.mjs films/NAME --generate                     # avec une clé API : la prise et ses temps de mots
node kit/audio/voice.mjs films/NAME --take AUDIO --words WORDS     # avec un connecteur vocal : rendez les deux
node kit/audio/voice.mjs films/NAME                                # le temps de chaque plan, et les mots à écouter

6. Construction, un plan à la fois

Suivez references/engine.md. Donnez à chaque plan une <section class="scene"> et animez-la entre s.sNN.start et s.sNN.end. Construisez dans l'ordre du storyboard et regardez un arrêt sur image de chaque plan en le terminant :

node kit/tools/render.mjs films/NAME --stills 1.5,4.2,7.9      # images terminées, quelques secondes de travail

Comparez chaque arrêt sur image avec son image dessinée. Ce que l'image a placé en (x, y) est en (x, y).

7. Rendu

node kit/tools/render.mjs films/NAME                  # out/picture.mp4, en segments de quatre secondes
node kit/tools/render.mjs films/NAME --only 12-16     # après une correction : seulement les segments qui ont changé

Une minute de film à 60 fps prend environ une demi-heure sur quatre cœurs de CPU. Lancez-le en arrière-plan et écrivez la feuille de repérage entre-temps.

8. Son

Suivez references/sound.md : un fond musical dont le temps est déjà suivi par les coupes, et de petits effets propres sur les événements réels, écrits comme films/NAME/cues.json. Un fond composé pour le film (kit/audio/music.mjs) correspond mieux qu'une piste de bibliothèque lorsque le film sera publié.

python3 kit/audio/mix.py films/NAME                   # out/NAME.mp4, volume mesuré sur le fichier fini
python3 kit/audio/mix.py films/NAME --no-sfx --out films/NAME/out/NAME-music-only.mp4

node kit/tools/make.mjs films/NAME exécute les commandes des étapes 4 à 9 dans l'ordre (vérification, voix, rendu, mixage, mesure, une copie de partage) et s'arrête à la première qui échoue. Il ne remplace pas le fait de regarder les arrêts sur image pendant la construction.

9. Révision, correction, vérification

Suivez references/review.md : node kit/tools/check.mjs films/NAME (feuilles de contact, temps figé, volume), puis un nouveau relecteur avec le film, le storyboard et les propres mots de la personne. Corrigez les plus grands écarts, re-rendez uniquement ce qui a changé, et faites vérifier la liste par un nouveau relecteur. Arrêtez-vous à la barre de qualité ou lorsque les gains deviennent cosmétiques. Lorsqu'une correction change ce qu'un plan montre, modifiez le storyboard pour le dire et redessinez le storyboard : le plan et le film ne sont jamais en désaccord.

10. Livraison

Le MP4 (H.264, 1080p60, environ -14 LUFS, crête vraie sous -1 dBFS), une copie plus légère pour le partage, la version sans musique, les pages du storyboard, et une courte note honnête : ce qui a été mesuré, ce qui a seulement été regardé, ce à quoi personne n'a écouté, et ce que vous feriez ensuite.

Les fichiers d'un film

films/NAME/
  storyboard.json     le plan : faits, actes, plans, images dessinées. Le film lit ses temps ici
  storyboard.html     le storyboard (généré), storyboard/*.png ses pages
  index.html          une <section class="scene"> par plan ou groupe de plans
  film.css            les pièces de ce film, par-dessus kit/css/film.css
  film.js             la timeline, construite avec kit/engine/motion.js
  cues.json           le fond musical et chaque son, sur l'horloge du film
  voice/              la narration : take.mp3, le temps de chaque mot, la coupe (voice.json), subtitles.srt
  out/                rendus (jamais commités)

Style de travail

  • Planifiez là où la personne peut le voir (le storyboard), puis construisez sans demander pour chaque étape.
  • Quand le travail s'éternise, dites en une ligne ce que vous faites.
  • Montrez le travail : le storyboard, les arrêts sur image, les feuilles de contact, les nombres mesurés, le verdict du relecteur.

Skills associés