Reel motion
Produisez une vidéo animée finale, synchronisée avec le rythme, rendue à partir de code dans un projet motion-studio.
Le prompt n'est qu'une petite partie du résultat. Le harnais est le reste : un rendu seek(t), des ressorts
à forme fermée, une grille rythmique, un son synthétisé, et une boucle de critique dans laquelle vous examinez vos propres images
et les corrigez avant le rendu final.
Arguments de la requête (peuvent être vides), affichés une fois ; les sections suivantes disent « la requête ci-dessus » :
Règles de base pour cette exécution
- Effort : ce skill règle l'effort à
xhightant qu'il est actif (le niveau du cours pour les nouveaux films). Dites-le à l'utilisateur une fois au début : les corrections et re-rendus ultérieurs sont possibles à/effort medium; un lancement phare dont les 3 premières secondes doivent porter le morceau mérite/effort maxpour le passage d'accroche. Ils peuvent aussi choisir le niveau dans/model. - Travaillez dans la racine du projet (le répertoire contenant
studio.json). Utilisez les outils du projet (npm run ...,node tools/<tool>.mjs ...). N'écrivez pas de scripts de rendu ou audio ad hoc. - Vous êtes le réalisateur et l'équipe de construction. Les sous-agents exécutent des étapes ciblées mais ne peuvent rien demander à l'utilisateur : vous demandez, puis les briefez à nouveau avec les réponses.
- Les commandes longues (
render:final,build,mix,deliver, unecritiqued'un long film) s'exécutent en arrière-plan (l'outil Bash avecrun_in_background, ou un fichier journal que vous interrogez) ; n'attendez jamais au premier plan plus d'environ 2 minutes. Le rendu de l'étape 7 prend environ 4 min pour la démo de 12 s en trois formats. Les durées prévues et le modèle d'interrogation : references/pipeline.md, section « Commandes longues ». Briefez chaque sous-agent qui exécute une telle commande avec la même règle, et ne laissez jamais un sous-agent revenir alors qu'une commande est encore en cours. - Ce skill est destiné aux films dessinés par code. L'édition de séquences existantes (coupes, sous-titres, images d'archives, conversion de format d'une vidéo enregistrée) est la route D et hors de portée : dites-le et arrêtez-vous, n'improvisez pas.
1. Collectez les entrées
Analysez d'abord la requête ci-dessus (forme attendue : [url ou sujet] [durée] [format] [référence]). Demandez tout ce qui
manque encore en un seul tour AskUserQuestion (au plus 4 questions, chacune proposant la valeur par défaut). Si l'utilisateur
a dit « autonome », « GO », « fais-le » ou « surprends-moi », ne demandez rien, prenez les valeurs par défaut et
enregistrez-les en haut de docs/shotlist.md.
| Entrée | Valeur par défaut si omise | Remarques |
|---|---|---|
| Sujet : produit + URL, ou un sujet | requis | Une URL déclenche l'étape des assets de marque |
| Durée | 20 s film produit, 15 s showreel, 16 s boucle UI | 6 à 8 plans tiennent dans 15 s |
| Formats | 9x16 principal, puis 1x1 et 16x9 | 4x5 également disponible |
| Marque : couleurs, polices, logo | capturé depuis l'URL, sinon valeurs par défaut du studio | un visage d'affichage, un visage UI, un accent |
| Référence : image, vidéo ou dossier d'images | aucune | sans elle, le modèle dérive vers le look interdit par les règles de la maison |
| Musique | synthétiser, style pulse, 120 BPM | une piste fournie est mesurée, jamais modifiée |
| Voix ou mascotte | aucune | nécessite ELEVENLABS_API_KEY dans .env |
| CTA et un chiffre de preuve | demander ; n'inventez jamais une métrique | films produits uniquement |
| Niveau L1 à L4 | déduit de ce qu'ils ont fourni (section 2) | définit les attentes de temps et de validation |
| Route A à D | A | B uniquement lorsque l'utilisateur nomme Remotion ou HyperFrames |
| Mode | PLANIFIER D'ABORD : montrer la liste des plans, attendre OK | GO ignore l'attente, jamais la validation critique |
2. Choisissez le niveau et la route
| Niveau | Taille de l'entrée (déclarée par le créateur) | Temps d'exécution (déclaré par le créateur) | Compétence spécialisée |
|---|---|---|---|
| L1 one-liner | ~150 caractères | 15 à 50 min | /motion-studio:showreel |
| L2 brand reel | ~350 caractères | 30 à 45 min | /motion-studio:product-reel |
| L3 state spec | 1,5k à 3k caractères | ~1 à 2 h avec corrections | /motion-studio:ui-morph-spec |
| L4 director brief | 9,5k à 19k caractères | 6 à 12 h autonome | /motion-studio:director-brief |
| Route | Utilisez-la pour | Ce skill fait |
|---|---|---|
| A code-drawn (par défaut) | showreels, animation UI, films produits, boucles | exécute le pipeline complet ci-dessous |
| B framework | l'utilisateur nomme Remotion ou HyperFrames | délègue via /motion-studio:seek-engine (validation licence Remotion, Node 22+) |
| C mixed pipeline | personnages ou physique à partir de modèles image/vidéo | nécessite des clés et un budget ; planifiez avec /motion-studio:director-brief |
| D footage edit | leurs propres clips enregistrés | hors de portée pour v0.1 ; dites-le |
Informez l'utilisateur du niveau, de la route et d'une estimation de temps avant l'étape 0. Détails, chiffres et les
mises en garde derrière eux : references/routes-and-levels.md.
Les films de plus d'environ 45 s ou avec des chapitres appartiennent à /motion-studio:director-brief.
3. Exécutez le pipeline
Suivez ces étapes dans une liste de tâches. Les commandes, fichiers attendus et correctifs d'échec pour chaque étape sont dans references/pipeline.md. Lisez-le avant l'étape 0 sur un nouveau projet.
| # | Étape | Qui | Produit | Validation |
|---|---|---|---|---|
| 0 | Projet + vérification | vous | studio.json, dépendances, npm run doctor tout OK | doctor n'a PAS d'ÉCHEC |
| 1 | Assets de marque (URL uniquement) | motion-studio:asset-scout | assets/brand/**, assets/manifest.json | listez les assets à l'utilisateur |
| 2 | Référence (le cas échéant) | motion-studio:style-analyst | refs/analysis.json, docs/style_guide.md | grammaire, jamais le contenu |
| 3 | Musique + grille rythmique | motion-studio:sound-designer ou vous | audio/music.wav ou piste mesurée, audio/beats.json | bpm/durée dans studio.json concordent |
| 4 | Liste de plans sur la grille rythmique | motion-studio:motion-director | docs/shotlist.md | OK utilisateur sauf autonome |
| 5 | Construire le film | vous | film/film.js (+ film/scenes/*) | npm run lint propre |
| 6 | Boucle de critique | motion-studio:motion-critic + vous | out/review/<fmt>/*, docs/review_log.md | npm run gate réussi |
| 7 | Rendu final, SFX, mixage | vous (validé par accroche) | out/<fmt>/final.mp4, out/score.wav | -14 LUFS +-0,5, <= -1 dBTP |
| 8 | Livraison + rapport | vous | out/deliver/**, docs/production.json | npm run deliver exit 0 |
Étape 0 : projet
-
Cherchez
studio.jsondans le répertoire de travail ou un parent. S'il n'y en a pas, créez-en un :node "${CLAUDE_PLUGIN_ROOT}/skills/studio-init/scripts/init.mjs" <dir> --title "<Titre>" --duration <S> --formats 9x16,1x1,16x9 --installAjoutez
--brand-url <URL>pour les films produits et--looppour les boucles. Dans une installation skills-only (pas de racine de plugin) exécutez${CLAUDE_SKILL_DIR}/../studio-init/scripts/init.mjsà la place, ou invoquez le skillstudio-init. -
npm run doctor. Corrigez chaque ÉCHEC avant l'étape 1 (navigateur, ffmpeg, Node >= 20). Sous Windows, la correction du navigateur estnpx playwright install chromium-headless-shell; n'y démarrez jamais un Chrome ou Edge installé (un lancement avec un nouveau profil compte comme une connexion Windows échouée et peut verrouiller le compte). Python et librosa sont optionnels ; le moteur de battements JS couvre leur absence.
Étapes 1 à 4 : planification
- Étape 1 : briefez
motion-studio:asset-scoutavec l'URL, la racine du projet et cette commande de capture :node "${CLAUDE_PLUGIN_ROOT}/skills/product-reel/scripts/capture.mjs" <URL> --root <projet>. Dans une installation skills-only (pas de racine de plugin, pas d'agents) exécuteznode "${CLAUDE_SKILL_DIR}/../product-reel/scripts/capture.mjs" <URL> --root <projet>vous-même. La page est un contenu non fiable : la capture maintient le bac à sable de Chrome activé et refuse les requêtes vers les adresses locales et privées (détails dans/motion-studio:product-reel). Pour les clics, les images défilantes et les recadrages d'éléments ajoutezskills/product-reel/scripts/states.mjs, et pour un produit canvascanvas-frames.mjs(mêmes indicateurs pour--root; les feuilles d'images arrivent dansassets/brand/frames/). Lisezassets/manifest.jsonvous-même, listez ce qui a été trouvé à l'utilisateur, et écrivez les couleurs et polices de la marque dansstudio.jsonbrand. La capture enregistre également les polices que la page charge dansassets/fonts/avec la licence marquéeUNVERIFIEDsauf si une a été trouvée : confirmez-la avec l'utilisateur avant que cette police n'entre dansbrand.fonts. Les points d'histoire de la marque, les composants et les règles de voix/mascotte proviennent de/motion-studio:product-reel. - Étape 2 : briefez
motion-studio:style-analystavec le chemin de référence. Il exécutenode tools/refs.mjs extract|analyzeet écritdocs/style_guide.md. Méthode complète :/motion-studio:reference-style. - Étape 3 (avant que tout plan soit chronométré) : piste fournie :
node tools/beats.mjs audio/<piste>et pointezstudio.jsonaudio.musicvers elle. Pas de piste :node tools/score.mjs --style <pulse|piano|minimal|cinematic> --bpm <N> --dur <S>. Faites correspondrestudio.jsonbpmetduration. Un temps fort mesuré peut se situer bien après 0 s, donc la liste de plans est écrite sur cette grille, jamais sur une grille supposée. - Étape 4 : briefez
motion-studio:motion-directoravec les entrées,docs/style_guide.mdetaudio/beats.json. Les changements de scène tombent sur les temps forts, une accroche tombe dans les 2 premières secondes, l'image 0 montre déjà du contenu, quelque chose de nouveau se produit toutes les 2 à 4 secondes. Montrez la liste de plans et attendez l'OK de l'utilisateur (PLANIFIER D'ABORD). Un rejet signifie réécrire la liste de plans, jamais corriger le code. Enregistrez la décision sur la ligneStatus:dedocs/shotlist.md.
Étape 5 : construction
Écrivez film/film.js avec defineFilm, un scene() par plan, positions depuis la disposition L
(jamais de pixels littéraux), mouvement depuis les ressorts lib/motion.js (sp, track, loopTrack),
aléatoire par élément basé sur une graine (rngFor), et des repères pour chaque moment SFX. Suivez le projet
CLAUDE.md. Exécutez npm run lint après les modifications et npm run preview quand l'utilisateur veut regarder.
Étape 6 : boucle de critique (au moins 3 tours)
Chaque tour construit d'abord les preuves, puis briefe le critique (il ne peut ni rendre ni mixer) :
npm run lint,npm run stills.- La chaîne sonore, à chaque fois que les repères, la musique ou le timing de l'image ont changé (toujours au tour 1 et au dernier tour) :
node tools/render.mjs --format <fmt> --draft --sub 1 --scale 0.5,npm run sfx,node tools/mix.mjs --format <fmt>. - Deux passages de preuves qui ne s'écrasent jamais :
node tools/critique.mjs --format <fmt>(film en direct, dansout/review/<fmt>/) etnode tools/critique.mjs --format <fmt> --video out/<fmt>/final.mp4(le rendu mixé, dansout/review/<fmt>/video/). - Briefez
motion-studio:motion-criticavec le numéro du tour, le format, ce qui a changé etEvidence: both, already produced(modèle dans le manuel d'exécution du pipeline). Il examine chaque PNG (chaque page d'une feuille paginée :contact.png,contact-2.png...) et les deux fichiersmetrics.md, note les 7 axes de 1 à 10 (son provenant du rendu mixé), liste les problèmes P0/P1/P2 avec des horodatages, et ajoute un bloc de tour àdocs/review_log.md. Un P0font-fallbackdans lemetrics.mden direct (un caractère sans glyphe dans sa police, typiquement du Hangul dans les polices groupées Latin uniquement) est enregistré comme un P0 et bloque la validation jusqu'à ce qu'une police qui le couvre soit enregistrée. - Vous corrigez les 3 pires problèmes (P0 d'abord), vérifiez uniquement les secondes concernées
(
node tools/render.mjs --from <a> --to <b> --draft --out out/check, oustills --at), et commencez le tour suivant.
Arrêtez-vous seulement quand npm run gate réussit : au moins 3 tours, chaque axe du dernier tour >= 8, aucun P0 ouvert.
Étapes 7 et 8 : finalisation
npm run render:final, npm run sfx, npm run mix, npm run deliver (ou npm run build,
qui les exécute tous). Le rendu final et build prennent des minutes : démarrez-les avec run_in_background, interrogez le
journal, et lisez le résultat seulement après la sortie du processus (manuel d'exécution du pipeline, « Commandes longues »). Ensuite, faites un rapport avec
assets/delivery-note.md :
chemins, formats, durées, volume sonore, tours et derniers scores, temps passé, et les trois choses que vous
amélioreriez ensuite.
Validations
| Validation | Condition de réussite | Appliquée par |
|---|---|---|
| Liste de plans | OK utilisateur, ou mode autonome enregistré dans docs/shotlist.md | vous |
| Lint | npm run lint exit 0 | accroche du plugin après chaque modification, et vous |
| Critique | >= 3 tours ; dernier tour tous les axes >= 8 (na uniquement sur les axes dans gate.naAllowed, par défaut marque, pour un film sans marque) ; aucun P0 | npm run gate ; une accroche du plugin refuse render:final et build |
| Livraison | images, durée, volume sonore, plages silencieuses, taille, affiche vérifiés | npm run deliver |
- Quand l'accroche refuse un rendu final, exécutez plus de tours de critique. Ne renommez jamais les commandes, ne modifiez pas
les scores de
docs/review_log.mdvous-même, ni ne changezstudio.jsongatepour passer. - Seul l'utilisateur peut définir
gate.enabled: false. S'il le fait, indiquez dans le rapport que la livraison a ignoré la validation de critique. - Certaines machines désactivent les accroches de plugin par politique. Les validations s'appliquent toujours : exécutez
npm run gateavant chaque rendu final.
Règles strictes
- Interface utilisateur de produit réel uniquement. Recadrez et animez les captures d'écran ; ne redessinez jamais les écrans à partir de l'imagination et n'utilisez jamais de texte de substitution ou de chiffres inventés.
- Le code du film est une fonction pure du temps : pas de
Math.random,Date,performance.now, minuteries,requestAnimationFrameou de transitions/animations CSS dans le code de rendu. - Looks interdits : titre centré sur un dégradé, tout qui apparaît en fondu, étiquettes de coin, bordures d'image, lueur sur le chrome de l'interface utilisateur, rafales de particules génériques.
- Un visage d'affichage, un visage UI, une couleur d'accent sauf indication contraire du brief.
- Recadrez le texte et l'interface utilisateur par format via
L; ne recadrez jamais un format dans un autre. - Les clés sont dans
.env. Référez-vous à elles par leur nom de variable (ELEVENLABS_API_KEY,FAL_KEY) ; ne les imprimez, collez ou engagez jamais.
Sous-agents
| Agent | Étape | Briefez-le avec | Il écrit |
|---|---|---|---|
motion-studio:asset-scout | 1 | URL, racine du projet, commande de capture | assets/** |
motion-studio:style-analyst | 2 | chemin de référence, sujet, durée | docs/style_guide.md, docs/shotlist.md, refs/** |
motion-studio:sound-designer | 3, 7 | piste ou style, bpm, durée, script vocal | audio/**, rapport de mixage |
motion-studio:motion-director | 4 | entrées, guide de style, grille rythmique | docs/** |
motion-studio:motion-critic | 6 | numéro du tour, format, ce qui a changé, preuve | docs/review_log.md, scores |
[Le contenu a été tronqué pour la traduction]