Communitygithub.com

cskwork/motion-graphics-skill

Créez des vidéos de motion design pilotées par le code, rendues à partir d'HTML, précises à la trame et reproductibles.

Qu'est-ce que motion-graphics-skill ?

Cette compétence permet de générer des vidéos de motion design professionnelles en écrivant du code HTML/CSS/JavaScript, chaque frame étant une fonction pure du temps `t`. Le rendu est effectué via Chromium sans tête et encodé avec ffmpeg, garantissant une précision absolue et une reproductibilité parfaite. Elle est idéale pour produire des vidéos de lancement de produit, des bandes-annonces d'applications, des démos à la Apple/Google, ou des contenus verticaux pour YouTube Shorts, Reels et TikTok. Le workflow comprend la création d'un dossier de projet structuré, la composition avec des API JavaScript dédiées (scènes, transitions, animations), un rendu multiprocessus, l'ajout audio avec mixage et normalisation, et une phase de QA rigoureuse avec génération de planches contact et vérifications de conformité. La compétence est conçue pour être utilisée avec des agents IA comme Claude Code, Cursor ou Codex, et chaque vidéo est conçue comme une création originale sans réutilisation de travaux antérieurs.

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

Demander à votre IA préférée

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

Documentation

motion-graphics

Une vidéo est une page HTML dont chaque pixel est une fonction pure du temps t, rendue image par image dans Chromium sans tête et encodée avec ffmpeg. Le niveau d'exigence est celui du showreel d'un senior motion designer, jamais un diaporama.

1. Choisir le format

DemandeLire
Lancement, promo, pub, démo produit, bande-annonce d'application réelleformats/launch-video.md
Shorts, Reels, TikTok, vidéo explicative verticale ou storyformats/shorts.md

Suivez le fichier de format pour le brief, les étapes de contenu et la structure des séquences. Il renvoie ici pour la construction. Lisez aussi references/pitfalls.md avant d'écrire la composition.

Nouveau concept à chaque exécution. Chaque vidéo a sa propre idée, son script et son apparence. Lorsque l'utilisateur demande de ne pas regarder les travaux précédents, laissez les vidéos et compositions antérieures dans l'espace de travail non ouvertes.

2. Dossier de travail

Créez <slug>-<AAAAMMJJ>/ là où l'utilisateur le souhaite (par défaut : le répertoire courant) :

brief.md          paramètres issus du tableau de brief du format
beats.md          la feuille de séquences (temps, texte, asset, mouvement, transition, accent rythmique)
assets/           captures, images, polices, audio
assets/manifest.md  une ligne par fichier asset : source, licence ou "capturé depuis <surface>", ce qu'il montre
motion.html       la composition
motion.json       {"size": [L, H], "fps": 60, "duration": 30, "stills": [temps des séquences], "captions": []}
engine/           copié depuis le dossier engine de cette compétence
out/              images fixes, rendus, planche contact

Configurez le moteur une fois par dossier :

cp -R <cette-compétence>/engine engine && (cd engine && npm install && npx playwright install chromium)

3. Composer

motion.html charge engine/runtime.css et engine/runtime.js, construit son DOM, enregistre les scènes, puis appelle MG.ready().

AideUtilisation
MG.scene(début, fin, fn, el)fn(local, t, dur) s'exécute tant que start <= t < end ; el est masqué ailleurs. Définissez chaque propriété animée à chaque appel.
MG.always(fn)S'exécute à chaque image : arrière-plans, grain, barres de progression.
MG.prog(t, a, b, ease)Progression 0..1 avec easing. Eases : MG.ease.* (linear, in/out/inOut Quad, Cubic, Quart, Expo, inBack, outBack, outElastic, outBounce) ou toute fonction.
MG.tween(t, [[t0, v0], [t1, v1, ease], …])Keyframes ; les valeurs peuvent être des tableaux.
MG.spring(t, {stiffness, damping})Progression physique 0 → 1 avec dépassement.
`MG.split(el, "grapheme""word")`
MG.set(el, {x, y, s, sx, sy, r, o, blur, ...css})Un seul appel par élément par image.
MG.clip(videoEl, start, rate)Joue un enregistrement d'écran avec précision image par image à partir de start.
MG.rng(seed), MG.noise(x, seed)Aléatoire déterministe et tremblement.
MG.fmt(n, {decimals})Formatage de nombres pour les compteurs (localisé).
MG.captions()Dessine les sous-titres de motion.json au-dessus du bloc UI du bas.

Déterminisme : pas de Date, performance.now(), requestAnimationFrame ou Math.random dans la logique de rendu. Les @keyframes CSS sont autorisés ; le moteur les met en pause à t, donc synchronisez-les avec animation-delay. Utilisez uniquement les polices et images listées dans le manifeste.

Prévisualiser une image : open "motion.html?w=1920&h=1080&t=3.2&guides=1" (les guides montrent les zones de sécurité). Temps réel : ?play=1. Les sous-titres n'apparaissent que dans les rendus.

4. Niveau d'exigence

  • L'image 0 est déjà en mouvement. Pas de fondu depuis le noir, pas d'intro logo.
  • Quelque chose de significatif change toutes les 0,8 à 2 s : mise en page, échelle, couleur, nombre ou caméra.
  • Les entrées utilisent des ressorts ou des ease-out-expo avec un léger dépassement ; décalages de 30 à 60 ms ; linear uniquement pour les tickers.
  • Flou de mouvement uniquement pendant les déplacements rapides ; léger zoom avant (échelle 1 → 1,04) sur les plans fixes ; parallaxe sur 2 à 3 couches de profondeur.
  • Une famille d'arrière-plan, une couleur de texte, un accent. Ajoutez du grain ou du bruit de gradient pour éviter les bandes après compression.
  • Le texte reste à l'écran assez longtemps pour être lu deux fois ; le texte clé reste dans les zones de sécurité.
  • Les séquences tombent sur le son : un whoosh, un impact ou un temps musical à chaque changement.

5. Rendu

node engine/render.mjs --html motion.html --config motion.json --stills <t1,t2,...> --stills-dir out/stills
node engine/render.mjs --html motion.html --config motion.json --out out/video.mp4 --workers 4

Validez d'abord la mise en page avec les images fixes : une par séquence, une à l'intérieur de chaque tween, une à chaque pic de dépassement du ressort. Lancez un rendu complet à la fois (environ 10 minutes pour 25 s à 1080p60 avec 4 workers).

6. Audio

Utilisez uniquement la musique et les SFX listés dans le manifeste avec une licence autorisant l'utilisation, ou les fichiers fournis par l'utilisateur. Sans eux, livrez sans son et mentionnez-le. Mélangez les pistes, puis muxez :

ffmpeg -i music.wav -i whoosh.wav -filter_complex \
  "[0]volume=-16dB[m];[1]adelay=1200|1200,volume=-8dB[a];[m][a]amix=inputs=2:normalize=0[out]" -map "[out]" out/mix.wav
ffmpeg -i out/video.mp4 -i out/mix.wav -map 0:v -map 1:a -c:v copy \
  -af "loudnorm=I=-14:TP=-1.5:LRA=11" -c:a aac -b:a 256k -shortest -movflags +faststart out/final.mp4
ffmpeg -i out/final.mp4 -af ebur128=peak=true -f null - 2>&1 | grep -E "^ +(I|Peak):"

Visez environ −14 LUFS intégré et un pic vrai à ou en dessous de −1 dBFS. Les SFX se situent entre −6 et −14 dB, la musique entre −14 et −18 dB. La musique sous le texte à l'écran est instrumentale.

7. QA

  1. La durée, la taille et le fps de ffprobe correspondent au brief.
  2. Planche contact : ffmpeg -i out/final.mp4 -vf "fps=2,scale=360:-1,tile=10x6" -frames:v 1 out/contact.png. Consultez-la et une image en pleine taille à chaque changement de séquence (ffmpeg -ss <t> -i out/final.mp4 -frames:v 1 out/check-<t>.png).
  3. Chaque image : rien de coupé sur les bords, pas d'image vide ou à moitié fondue, pas de guides oubliés, pas de fautes ou de texte factice, rien de statique plus de 2 secondes.
  4. Les vérifications propres au fichier de format.

Corrigez et refaites le rendu jusqu'à ce que toutes les vérifications passent. Ajoutez toute nouvelle leçon à references/pitfalls.md dans la compétence sous la forme date · vidéo · leçon.

Livraison

Rapportez le chemin du MP4 final, sa durée, sa taille et son fps, ce qu'il montre, le statut audio avec les crédits nécessaires, et les commandes de re-rendu. Conservez le dossier de travail. Téléchargez ou publiez uniquement sur demande de l'utilisateur.

Skills associés