Communitygithub.com

Code Animation

Transforme un concept abstrait en un court métrage d'animation de 1 à 2 minutes. **Ce n'est pas une vidéo générative** – chaque image est une image vectorielle calculée dans le navigateur, reproductible image par image et modifiable localement.

Qu'est-ce que Code Animation ?

Ce skill permet de créer des animations scientifiques de haute qualité (format MP4) à partir d'un storyboard structuré, en utilisant du code pour générer des graphiques vectoriels dans le navigateur. Chaque image est calculée et reproductible, offrant un contrôle précis sur chaque élément visuel. Le processus en trois étapes (validation, rendu, contrôle qualité) garantit un résultat professionnel, avec des seuils de qualité quantifiables pour éviter les approximations. Le skill est particulièrement adapté à la vulgarisation scientifique (physique, mathématiques), aux démonstrations techniques et à la narration de données. Il est conçu pour les agents comme Claude Code, Cursor ou Codex, et fournit des scripts pour la construction, le rendu, la mesure de la qualité et même la composition musicale procédurale. Le système à six couches (fond, structure, objet principal, annotations, texte, post-traitement) permet de créer des animations avec une esthétique « instrument de mesure » professionnelle, et huit modèles de plans prêts à l'emploi couvrent les besoins courants (orbites, distorsion de l'espace-temps, trous noirs, etc.).

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Shang-en-yee/code-animation-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

Atelier d'Animation par Code (Code Animation)

Transformez un concept abstrait en un court métrage d'animation de 1 à 2 minutes. Ce n'est pas une vidéo générative – chaque image est une image vectorielle calculée dans le navigateur, reproductible image par image et modifiable localement.

Le résultat est un fichier MP4, accompagné d'un storyboard.json réutilisable.


Processus en trois étapes

# 1. Valider le storyboard
python scripts/lint.py storyboard.json

# 2. Construire + Rendre (environ 0,5 seconde/image)
python scripts/build.py storyboard.json out.html
python scripts/render.py --html out.html --duration 117 --fps 30 --out film.mp4

# 3. Contrôle qualité, échoue avec un code d'erreur si les seuils ne sont pas atteints
python scripts/measure.py film.mp4 --thresholds reference/thresholds.json

Si le contrôle qualité échoue, corrigez. Ne validez pas « parce que ça a l'air bien ».

Ajouter de la musique (optionnel, mais fortement recommandé)

La musique est également calculée, sans échantillon de bibliothèque – le même principe que pour l'image.

# 1. Synthétiser la musique (numpy, environ 40 secondes)
python scripts/make_audio.py score.wav --storyboard storyboard.json

# 2. Intégrer dans la vidéo, compresser au passage en H.264
python scripts/mux.py --video film.mp4 --audio score.wav --out final.mp4 --crf 23

La musique par défaut est une base spatiale/physique : nappes longues en ré mineur + accords changeant à chaque plan + impulsion cardiaque toutes les 8 secondes + quelques pincements épars, avec un balayage de bruit aux transitions et des impacts graves aux sections.

Pour un thème différent, adaptez les paramètres de la musique, ne réutilisez pas tels quels :

ThèmeModification de la musique
Physique / AstronomieConserver les valeurs par défaut : mineur, notes longues, épars
Mathématiques / AlgorithmesPasser en majeur ou mode lydien, ajouter quelques arpèges réguliers
Histoire / Sciences humainesSupprimer les impulsions, ralentir les nappes, ajouter quelques intervalles dissonants
Produit / TechniqueSupprimer les nappes longues, remplacer par une pulsation synthé à 90–110 BPM

Les paramètres se trouvent dans les trois constantes SCALE / ROOT / bpm en haut de make_audio.py, et dans le tableau chords de build().


storyboard.json

{
  "title": "Gravité",
  "fps": 30,
  "palette": { "bg": "#08090F", "ink": "#E6DCCB", "dim": "#8A8177", "accent": "#E0813C" },
  "scenes": [
    {
      "id": "open",
      "kind": "title",
      "dur": 6.0,
      "cn": "引力",
      "en": "GRAVITY"
    },
    {
      "id": "newton",
      "kind": "orbit",
      "dur": 16.0,
      "chapter": ["I", "苹果与月亮", "THE APPLE AND THE MOON"],
      "subs": [
        [0.6,  "1687 年,牛顿用一个公式,把苹果和月亮绑在了一起。"],
        [7.4,  "引力与质量成正比,与距离的平方成反比。"]
      ]
    }
  ]
}
ChampDescription
kindNom du modèle de plan, voir tableau ci-dessous
durDurée du plan (secondes), recommandé 12–20
chapter[numéro, chinois, ENGLISH], affiché en haut à gauche
subsTableau [seconde de début, texte] ; prévoir 5–6 secondes par écran
cn / enUtilisé pour les plans de titre

Modèles de plans (8)

kindImageUtilisation
titleGrand titre + sous-titre en anglaisOuverture
outroDeux lignes de conclusionGénérique de fin
orbitOrbite elliptique + grille polaireMouvement périodique, gravité
precessFleur de précession + rapporteur d'angleDéviation mineure, précession
elevatorBoîte + échelle interneRéférentiel, principe d'équivalence
warpGrille d'espace-temps en perspective + lignes de champCourbure, champ
evidenceAnneaux concentriques de lentille + onde chirpPreuve, signal
blackholeDisque d'accrétion + anneau de photons + échelle annulaireObjet céleste extrême

Les paramètres des modèles se trouvent dans templates/shots/*.json.


Architecture à six couches (pourquoi cet ordre)

L5 Post-traitement    bloom → vignettage → grain
L4 Texte              Titre de section / grand titre / formule / sous-titres
L3 Annotations        Lignes de champ + petites étiquettes + boîtes de lecture
L2 Sujet              Graphique principal du plan
L1 Structure          Grille / échelle / axes de coordonnées
L0 Arrière-plan       Nébuleuse / points / poussière / étoiles lointaines

Ce sont les couches L1 et L3 qui donnent l'impression de « professionnalisme », pas L2. Une image avec seulement le sujet semble sommaire ; en ajoutant la structure et les annotations, la même image devient immédiatement une « interface d'instrument ».

base.html implémente déjà les six couches ; pour un nouveau plan, il suffit d'écrire la fonction de dessin de L2.


Seuils de validation

reference/thresholds.json :

{
  "frame_diff_min": 1.5,
  "moving_ratio_min": 0.70,
  "coverage_min": 0.20,
  "luma_range": [16, 30]
}
IndicateurSignificationPourquoi
frame_diffDifférence moyenne entre images consécutivesEn dessous de 1,5, c'est un « diaporama », pas une animation
moving_ratioProportion d'images avec mouvementEn dessous de 70 %, sensation de « blocage »
coverageProportion de pixels avec structure localeEn dessous de 20 %, l'image semble vide
lumaLuminance moyenneEn dessous de 16, toute la structure se noie dans le noir ; au-dessus de 30, on perd le fond sombre

Ces seuils ont été calibrés sur des séquences de référence réelles. Ne les modifiez pas à la légère. Voir reference/findings.md.


Pièges connus (tirés de l'expérience)

1. N'utilisez jamais ctx.shadowBlur. Avec des dizaines d'ombres calculées image par image en rendu logiciel, le temps par image passe de 20 ms à 5 secondes. Utilisez bloom() dans base.html – réduisez le canvas à 1/6, puis agrandissez et superposez, deux drawImage, presque gratuit.

2. Les paramètres doivent provenir de la même source.

Il y a déjà eu un bug où « la particule sortait de la ligne » : la ligne était calculée avec p², la particule avec p. Le chemin d'un même élément et sa tête doivent être pilotés par la même variable.

3. Le grain détermine la taille du fichier.

Le bruit aléatoire image par image a une entropie très élevée, que le codec vidéo ne peut pas compresser. Avec un α=0,03 pour le grain, une image 1080p30 fait environ 50 Ko – un film de deux minutes fait environ 300 Mo. Pour réduire, diminuez α (environ 0,015) ou la fréquence d'images, n'attendez pas miraculeusement du codec.

4. Utilisez le format JPEG pour les images, pas PNG.

L'encodage PNG avec grain est plus de 4 fois plus lent que JPEG (mesuré : 2,0 s/image contre 0,5 s/image).

5. La luminosité n'est pas un filtre.

N'utilisez pas CSS brightness() pour éclaircir – cela blanchirait aussi le texte. Pour éclaircir, augmentez l'alpha des couches de contenu (grille, nébuleuse, poussière), en respectant les proportions de reference/palette.json.


Étendre avec un nouveau plan

  1. Ajoutez un case dans drawScene() de base.html
  2. Écrivez uniquement L2 (le sujet) ; utilisez polarGrid / ringTicks / axisTicks / drawInstrument pour L1, et drawLeader pour L3
  3. Extrayez les paramètres ajustables dans un objet, et stockez-le dans templates/shots/<name>.json
  4. Lancez measure.py – le plan n'est considéré comme terminé que si les trois indicateurs sont atteints

Exemple

examples/gravity.storyboard.json – Le storyboard complet pour un film de deux minutes intitulé « Gravité », avec les huit plans utilisables. Il peut servir de point de départ en modifiant simplement le texte.

Skills associés