Vidéos explicatives animées par code
Toutes les scènes sont dessinées en pur code avec Remotion, l'audio est synthétisé avec Python. Proposez d'abord trois concepts avec aperçus, puis après validation, écrivez brief.md, et réalisez plan par plan.
Règles strictes
- Utilisez uniquement les méthodes de cette compétence. Ne remplacez pas les étapes décrites ici par d'autres workflows ou pratiques provenant d'autres projets.
- Les sources doivent être réelles et liées. Ouvrez ou téléchargez chaque source pour vérification. Si impossible, indiquez « non vérifié ». Pour les interprétations secondaires, précisez qui les a lues. N'inventez pas de chiffres, n'écrivez pas d'affirmations sans source.
- Obtenez l'approbation de l'utilisateur à chaque étape : inventaire des sources → trois concepts + aperçus → son → pochettes. Après avoir rédigé
brief.md, indiquez où il se trouve. - Pas de voix off (sauf demande explicite de l'utilisateur). Toute l'information repose sur le texte visuel. La musique de fond est fournie par l'utilisateur (qui doit en avoir les droits). Les effets sonores sont synthétisés et calés sur le rythme. Aucun fichier musical n'est joint au dépôt.
- Texte : ne doit pas se chevaucher, doit être lisible, rester suffisamment longtemps à l'écran, et ne pas comporter de longs blocs. L'image doit être riche ; les personnages (humains, animaux ou objets) doivent être dessinés avec soin et détails.
- Par défaut : paysage 1920×1080, 30 ips ; pour portrait / TikTok / vidéos courtes, utiliser 1080×1920 (
style="vflash"dansscenes.json). La durée est celle de la musique de fond (sans musique, on peut spécifier durée et BPM).
Répertoire de travail
<theme>/ ex. : ~/videos/<theme>
demo.mp3 / demo.mp4 musique de fond fournie par l'utilisateur, vidéo de référence (optionnel)
source/ sources.md (inventaire des sources), ref-notes.md (analyse de la vidéo de référence), matériel brut
previews/ plan-a.png, plan-b.mp4, plan-c.png (aperçus des trois concepts)
brief.md concept complet validé, aussi un prompt réutilisable
video/ projet Remotion (généré par new_project.py ou new_project.ps1)
qa/ images clés plan par plan, images extraites de la vidéo entière, review_log.md
<titre>.mp4 vidéo finale
pochettes/ pochette_3_4_portrait.jpg, pochette_4_3_paysage.jpg
Étape 0 : Créer le projet
python <skill>/scripts/new_project.py --project "<répertoire du thème>"
# Sans musique : ... --no-music --duration 60 --bpm 120
Sous Windows, on peut aussi utiliser scripts/new_project.ps1. Ce script effectue les opérations suivantes dans l'ordre :
- Vérifie l'environnement (
scripts/check_env.py). Imprime ce qui manque ; demande l'accord de l'utilisateur avant d'installer. - Crée le répertoire de travail.
- Copie le modèle.
- Copie les polices.
- Exécute npm install.
- Détecte les battements et écrit
src/grid.json. - Génère la première version du mixage.
L'ensemble prend 1 à 3 minutes. Dans un environnement nécessitant l'exécution de longues commandes en arrière-plan, lancez en arrière-plan et interrogez la sortie (voir references/pitfalls.md).
Le modèle contient un exemple générique d'environ 12 secondes pour vérifier que le projet peut être rendu. Après avoir changé le thème, réécrivez les scènes, les sous-titres et les effets sonores. Un exemple multi‑plan complet se trouve dans examples/bait-color/ (optionnel, ce n'est pas le contenu par défaut).
Étape 1 : Définir le projet
L'utilisateur peut fournir n'importe quel mélange des éléments suivants :
- Idée : même un thème en une phrase.
- Contenu original : article, script parlé, URL du produit, dépôt de code, tableau de données.
- Vidéo de référence, musique de fond.
Posez au maximum 3 questions, uniquement celles qui modifient le concept : durée, format, voix off, couleurs ou polices spécifiques. Si l'utilisateur ne précise rien, utilisez les valeurs par défaut et indiquez-les dans le concept pour qu'il puisse les modifier.
Traitement des éléments :
- Sujets scientifiques, factuels : recherchez et vérifiez selon
references/research.md, écrivez danssource/sources.md, soumettez à l'utilisateur. - Articles, scripts parlés : extrayez les informations principales, le public cible et les faits qui doivent apparaître. Les faits proviennent uniquement des éléments fournis ; si incertain, n'écrivez pas.
- URL de produit : lisez la page, notez le nom du produit, les fonctionnalités, le slogan et les couleurs de la marque. Pour les captures d'écran, demandez d'abord l'autorisation.
- Dépôt de code : lisez le README et les fichiers clés, extrayez les fonctionnalités sans en inventer.
- Vidéo de référence :
- Demandez d'abord l'autorisation avant de télécharger le lien.
- Mesurez les spécifications avec
ffprobe. - Trouvez les transitions de plans avec
ffmpeg -vf "select='gt(scene,0.3)',showinfo". - Extrayez 1 image par seconde pour créer une planche contact.
- Notez la structure des plans, le rythme, les couleurs, les polices et les techniques dans
source/ref-notes.md. - N'empruntez que la structure et les techniques, pas les éléments visuels ni le texte.
- Musique de fond : le script de création de projet a déjà détecté les battements et imprime BPM, limites des sections et dérive. Le concept et le storyboard sont organisés en fonction.
Étape 2 : Proposer trois concepts
Suivez references/plans.md. La répartition des concepts est fixe :
| Concept | Style | Technique | Narration |
|---|---|---|---|
| A | Animation Flash (illustrations vectorielles plates) | Remotion + composants SVG plats | Sûre : question → expérience/données → conclusion → retenir trois choses |
| B | Pixel art / rétro jeu (console rétro + vieille télé CRT) | Canvas 2D pixel → WebGL shader CRT | Ludique : choisir une cartouche = choisir un niveau, HUD affiche les données, dialogues pour les conclusions, écran de fin |
| C | Suggestion du moment : choisir le plus adapté au sujet dans la table candidate de plans.md, ou en proposer un réalisable avec Remotion | Différent de A et B | Autre approche : plan séquence, personnage principal tout au long du film, flashback, une métaphore pour tout expliquer |
Chaque concept doit indiquer : nom, résumé en une phrase, style (valeurs de couleur et police), spécifications, combinaison technique, résumé plan par plan (avec intervalles de temps), sonorisation, temps de rendu estimé, difficultés et risques, et pourquoi il convient à ce matériau.
Les trois concepts doivent être clairement distincts en style, technique et narration, et pas seulement par un changement de couleurs.
Étape 3 : Produire un aperçu pour chaque concept
- Dans
video/src/preview/PlanA.tsx,PlanB.tsx,PlanC.tsx, montez chacun un plan représentatif du concept, démarrant à t=0, durant 2–4 secondes. Ces trois fichiers dans le modèle sont des exemples génériques ; modifiez-les :- A utilise les composants SVG de
src/art/,src/ui/. - B utilise le moteur
src/pixel/, dessinez dansPixelStage. - C est nouveau, suivez l'écriture de
PlanC.tsx: l'image ne dépend que de t, un plan complet.
- A utilise les composants SVG de
- Exécutez :
node tools/preview.mjs --out ../previews --estimate A:2.4 B:2.5 C:3.9- Par défaut, chaque concept produit une image clé ; le nombre après les deux-points est la seconde à laquelle l'image est extraite.
- Pour les concepts dont l'intérêt est le mouvement lui-même, écrivez
B:clippour produire un extrait de 3 secondes. - Le script imprime le temps par image et une estimation du temps de rendu total ; indiquez cette estimation dans le concept.
- Vérifiez d'abord vous-même l'aperçu : le texte déborde‑t‑il ? les éléments sont-ils tassés ? l'image est-elle trop vide ? les trois styles sont-ils vraiment distincts ? Corrigez avant de soumettre à l'utilisateur.
- Soumettez le texte des trois concepts et leurs aperçus à l'utilisateur (intégrez les aperçus dans la réponse ; selon l'assistant, la méthode peut varier). L'utilisateur peut en choisir un, demander un mélange ou une modification ; en cas de changement, revenez à l'étape 2 ou 3 jusqu'à validation.
Étape 4 : Rédiger brief.md
Après validation, rédigez <theme>/brief.md selon references/brief-template.md. Il comporte sept sections : <role> <inputs> <direction> <structure> <build> <gotchas> <start>. Remplissez tout ce qui a été confirmé, et pour les valeurs par défaut, précisez qu'elles le sont. Une fois écrit, informez l'utilisateur de l'emplacement du fichier.
La production suit strictement le brief. Pour toute modification en cours de route, modifiez d'abord le brief, puis le code. Si l'utilisateur change de sujet ou souhaite utiliser le brief dans un autre outil, il peut le réutiliser tel quel.
Étape 5 : Réaliser plan par plan
-
Écrivez d'abord
src/scenes.json:style:"flash"ou"pixel"; Root l'utilise pour choisir l'ensemble d'images.- La table des scènes utilise la notation de mesure ; les transitions sont placées aux limites des sections.
-
Pour chaque plan, écrivez :
- Style Flash : dans
src/scenes/*.tsxécrivez le composant, puis enregistrez-le danssrc/scenes/index.ts. - Style Pixel : dans
src/pixel/scenes.ts, écrivez la fonction de tracé(c, f) => voiddansPIXEL_SCENES. - Style C : développez le code de l'aperçu de l'étape 3, reliez-le dans
Film.tsx, ou créez un autre composant complet à l'image dePixelFilm.tsx. - Écrivez tout le texte dans
src/captions.json, tous les effets sonores danssrc/sfx.json, utilisant la même notation de mesure.
- Style Flash : dans
-
Après chaque plan terminé, exécutez dans l'ordre :
npm run typechecknpm run check(vérification des sous-titres, doit être sans erreur)node tools/stills.mjs --out ../qa <entrée en secondes> <action principale en secondes> <sortie en secondes>
Examinez chaque image pour : occultation, sortie du cadre, texte qui chevauche les visages, texte qui se chevauche. Corrigez avant de passer au plan suivant.
-
Pour une durée supérieure à 30 secondes, après avoir assemblé tous les plans, produisez d'abord une version basse résolution :
node tools/render.mjs --scale 0.5 --out out/draft.mp4. Vérifiez le rythme et les transitions, puis affinez les détails. -
Règles de style : voir
references/style-flash.mdetreferences/style-pixel.md; règles générales :references/craft.md.
Étape 6 : Son
Règles dans references/audio.md :
- Les effets sonores et les actions visuelles sont écrits sur la même mesure.
- Pour le style pixel, utilisez les timbres
chip_*. - Pour l'effet machine à écrire, utilisez le champ
reppour que l'effet se répète. - Le niveau par défaut est la valeur finale.
- Si l'utilisateur trouve le son trop fort, trop faible ou strident, utilisez
--music-dbet--sfx-dbpour produire plusieurs versions de comparaison à choisir. Remplacez uniquement la piste audio, ne re-rendez pas les images.
Étape 7 : Rendu et validation
- Rendu :
npm run sfx, puisnpm run render. La durée dépend de l'estimation de l'étape 3 ; pour 3200 images, le style Flash prend environ 1,8 min, le style Pixel environ 6 min. - Vérifiez la résolution, le framerate, le nombre d'images et la durée avec
ffprobe, mesurez la loudness avecebur128. - Produisez la planche contact :
python tools/qa_sheet.py out/film.mp4 ../qa/final(sous Windows, utiliseztools/qa_sheet.ps1). Deux images sont générées : une planche contact complète et une version mobile (360 px de large par cellule). - Auto‑évaluation selon la checklist de
references/craft.mdsur 7 critères, chaque critère doit être ≥ 8 :- Listez les 3 problèmes les plus graves avec leurs instants.
- Ne re‑rendez que la partie problématique (
node tools/render.mjs --frames début-fin), puis réassemblez. - Notez chaque série de scores et problèmes dans
qa/review_log.md.
- Copiez la vidéo finale dans
<theme>/<titre>.mp4.
Points importants pour les vidéos courtes en portrait (style = vflash)
- Le composant complet se trouve dans
src/vfilm/: VFilm, VOverlay, cartes et étiquettes génériques, pochette minimaliste. Les scènes sont enregistrées dansvfilm/scenes.tsxviaVSCENE_MAP. - Zone de sécurité du texte : x 40–1040, y 240–1640 ; durée d'affichage par défaut ≥ 3,5 s, pour les cartes courtes ≥ 3 s.
- Ne superposez pas les sources sur l'image ; les sources ne figurent que dans
source/sources.md. Au maximum, indiquez « illustration ». - Fin suggérée : révision numérotée / vote + incitation à suivre. Règles de texte dans
references/publish-copy.md(titre ≤ 30 caractères, description ≤ 100 caractères avec hashtags). - Loudness finale : -16 LUFS, pic réel ≤ -2 dBTP :
python tools/loudnorm.py out/film.mp4. La musique de fond doit être nettement audible. - Les transitions se calent sur le premier temps de la mesure :
python tools/sync_check.py. La courbe de vitesse est écrite parbeat_grid.pydansgrid.jsonsectionsegments. - Pochette pour portrait :
npm run vcover34/vcover43.
Étape 8 : Pochettes
Deux styles, chacun avec une version 3:4 et 4:3 ; pour portrait, un jeu de pochettes minimalistes :
- Style Flash (composition paysage) :
npm run cover34,npm run cover43 - Style Pixel :
npm run pixelcover34,npm run pixelcover43 - Portrait minimaliste :
npm run vcover34,npm run vcover43
Toutes sont exportées en 2× la résolution. Règles de mise en page dans la documentation du style correspondant et dans references/publish-copy.md. Pour les pochettes de vidéos courtes, évitez le coin inférieur gauche (zone de compteur de vues) et n'utilisez pas de bandeau de liste en bas.
Livraison
Informez l'utilisateur de :
- Le chemin de la vidéo finale, celui de
brief.md, et le répertoire du projet. - Les décisions créatives clés de cette réalisation.
- Les limites connues.
- Le temps de rendu.
- Les faits incertains qui nécessitent sa vérification, listés séparément.
Modifier le style, ajouter un nouveau style
- Pour une seule vidéo : modifiez uniquement les fichiers de cette vidéo dans
video/, sans toucher au modèle de la compétence. Où se trouve chaque composant, voir « Répartition des styles dans les fichiers » dansreferences/craft.md. Produisez d'abord 4 à 6 images clés représentatives pour que l'utilisateur valide le style, puis réalisez la vidéo complète. - Pour utiliser un style C à l'avenir :
- Placez son code dans
assets/template/src/<nom_du_style>/. - Rédigez
references/style-<nom_du_style>.md. - Marquez-le comme « enregistré » dans la table candidate de
plans.md. - Ajoutez une ligne dans la table des concepts de ce fichier.
- Placez son code dans
- Style impossible à réaliser : ce flux de travail ne fait que dessiner des images vectorielles et pixel ; il ne peut pas produire de prises de vue réelles, de 3D réaliste ni de personnages réalistes. Prévenez l'utilisateur en amont. Si un personnage réaliste est nécessaire, l'utilisateur peut d'abord générer une séquence sur fond vert avec un modèle vidéo, et le code ne se chargera que du décor et du texte.
Fichiers de référence (à lire au besoin)
| Fichier | Contenu |
|---|---|
references/plans.md | Format des trois concepts, table candidate de C, règles d'aperçu, rédaction lors de la soumission à l'utilisateur |
references/brief-template.md | Modèle des 7 sections de brief.md |
references/style-flash.md | Style animation Flash : normes, composants, pochettes |
references/style-pixel.md | Style pixel / rétro : points importants, palette, doubles résolutions, police matricielle, sprites, CRT, pochettes |
references/craft.md | Règles de storyboard, règles de sous-titrage, auto‑vérification plan par plan, auto‑évaluation de la vidéo entière, checklist de validation, répartition des styles dans les fichiers |
references/remotion-kit.md | Structure du modèle, système de mesures, API de chaque composant, commandes courantes |
references/audio.md | Battements, table des timbres (y compris timbres chip), niveau de mixage final, procédure de réglage |
references/research.md | Méthode de recherche et vérification des sources |
references/pitfalls.md | Pièges déjà rencontrés (à lire avant de commencer) |
references/credits.md | Sources d'inspiration et licences des polices |
references/publish-copy.md | Texte de publication pour portrait, fin par vote, zone de sécurité, loudness |
scripts/new_project.py, new_project.ps1, check_env.py, beat_grid.py, music_rms.py, qa_sheet.py | Création de projet, vérification d'environnement, détection des battements, mesure de niveau, extraction d'images |
assets/template/ | Modèle de projet Remotion (contient tous les composants génériques des deux styles et les exemples génériques) |
assets/fonts/ | Police matricielle Fusion Pixel 12px (OFL) |
examples/bait-color/ | Exemple complet multi‑plan (optionnel, pas le modèle par défaut) |