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 ordre | references/pedagogy.md |
| Écrire et dessiner le storyboard (la porte) | references/storyboard.md |
| Choisir le look, l'accent, la lumière de scène, la 3D | references/look.md |
| Construire le film avec le kit | references/engine.md, puis references/motion.md |
| Écrire la narration : du discours, pas des sous-titres ; registre indonésien et anglais | references/narration.md |
| La voix : la choisir, interpréter une seule prise avec ElevenLabs, couper le film dessus | references/voice.md |
| Musique, effets sonores, le mixage | references/sound.md |
| Vérifier le rendu, révision indépendante | references/review.md |
| Rendu avec raea au lieu du navigateur | references/raea.md |
Ce qui ne plie jamais
- Storyboard d'abord, et il est dessiné. Aucun fichier film n'est écrit tant que
storyboard.jsonne passe paskit/tools/storyboard.mjsavec 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. - 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).
- 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.
- Une seule horloge. Chaque valeur animée est une fonction du temps de la timeline. Pas d'animations CSS, pas de boucles
requestAnimationFrame, pas deDate.now(), pas d'aléatoire non initialisé. - 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). - 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). - 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.
- 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.