Communitygithub.com

science-video

Créez des vidéos explicatives animées par code (sciences, langues, vie quotidienne, produits…) avec Remotion et Python. Posez une idée et obtenez trois storyboards, puis une production complète.

Qu'est-ce que science-video ?

Cette compétence permet à un agent IA (Claude Code, Cursor, Codex…) de réaliser des vidéos explicatives animées en pur code, destinées à la vulgarisation scientifique, l'apprentissage des langues, les explications de produits ou tout autre sujet. L'agent commence par interroger l'utilisateur sur son projet (idée, article, produit, code, vidéo de référence) et effectue des recherches documentaires vérifiées. Il propose ensuite trois concepts visuellement distincts (A : animation Flash/plat, B : pixel art / rétro jeu, C : adapté au sujet) avec une image clé ou un extrait de 2–4 secondes pour chaque. Après validation, il rédige un brief détaillé (`brief.md`), puis réalise chaque plan un par un avec auto-vérification, synchronise les effets sonores sur le rythme de la musique de fond, mixe et exporte un fichier MP4. Enfin, il génère les pochettes 3:4 et 4:3. La compétence exploite Remotion pour toutes les scènes et Python pour l'audio, garantissant une qualité professionnelle, reproductible et entièrement modifiable par l'utilisateur.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/dominoeffect/science-video-skill/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

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" dans scenes.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 :

  1. Vérifie l'environnement (scripts/check_env.py). Imprime ce qui manque ; demande l'accord de l'utilisateur avant d'installer.
  2. Crée le répertoire de travail.
  3. Copie le modèle.
  4. Copie les polices.
  5. Exécute npm install.
  6. Détecte les battements et écrit src/grid.json.
  7. 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 dans source/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 :

ConceptStyleTechniqueNarration
AAnimation Flash (illustrations vectorielles plates)Remotion + composants SVG platsSûre : question → expérience/données → conclusion → retenir trois choses
BPixel art / rétro jeu (console rétro + vieille télé CRT)Canvas 2D pixel → WebGL shader CRTLudique : choisir une cartouche = choisir un niveau, HUD affiche les données, dialogues pour les conclusions, écran de fin
CSuggestion du moment : choisir le plus adapté au sujet dans la table candidate de plans.md, ou en proposer un réalisable avec RemotionDifférent de A et BAutre 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

  1. 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 dans PixelStage.
    • C est nouveau, suivez l'écriture de PlanC.tsx : l'image ne dépend que de t, un plan complet.
  2. 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:clip pour 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.
  3. 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.
  4. 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

  1. É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.
  2. Pour chaque plan, écrivez :

    • Style Flash : dans src/scenes/*.tsx écrivez le composant, puis enregistrez-le dans src/scenes/index.ts.
    • Style Pixel : dans src/pixel/scenes.ts, écrivez la fonction de tracé (c, f) => void dans PIXEL_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 de PixelFilm.tsx.
    • Écrivez tout le texte dans src/captions.json, tous les effets sonores dans src/sfx.json, utilisant la même notation de mesure.
  3. Après chaque plan terminé, exécutez dans l'ordre :

    • npm run typecheck
    • npm 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.

  4. 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.

  5. Règles de style : voir references/style-flash.md et references/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 rep pour 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-db et --sfx-db pour produire plusieurs versions de comparaison à choisir. Remplacez uniquement la piste audio, ne re-rendez pas les images.

Étape 7 : Rendu et validation

  1. Rendu : npm run sfx, puis npm 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.
  2. Vérifiez la résolution, le framerate, le nombre d'images et la durée avec ffprobe, mesurez la loudness avec ebur128.
  3. Produisez la planche contact : python tools/qa_sheet.py out/film.mp4 ../qa/final (sous Windows, utilisez tools/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).
  4. Auto‑évaluation selon la checklist de references/craft.md sur 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.
  5. 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 dans vfilm/scenes.tsx via VSCENE_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 par beat_grid.py dans grid.json section segments.
  • 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 » dans references/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 :
    1. Placez son code dans assets/template/src/<nom_du_style>/.
    2. Rédigez references/style-<nom_du_style>.md.
    3. Marquez-le comme « enregistré » dans la table candidate de plans.md.
    4. Ajoutez une ligne dans la table des concepts de ce fichier.
  • 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)

FichierContenu
references/plans.mdFormat des trois concepts, table candidate de C, règles d'aperçu, rédaction lors de la soumission à l'utilisateur
references/brief-template.mdModèle des 7 sections de brief.md
references/style-flash.mdStyle animation Flash : normes, composants, pochettes
references/style-pixel.mdStyle pixel / rétro : points importants, palette, doubles résolutions, police matricielle, sprites, CRT, pochettes
references/craft.mdRè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.mdStructure du modèle, système de mesures, API de chaque composant, commandes courantes
references/audio.mdBattements, table des timbres (y compris timbres chip), niveau de mixage final, procédure de réglage
references/research.mdMéthode de recherche et vérification des sources
references/pitfalls.mdPièges déjà rencontrés (à lire avant de commencer)
references/credits.mdSources d'inspiration et licences des polices
references/publish-copy.mdTexte 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.pyCré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)

Skills associés