Communitygithub.com

motion-studio

Créez une vidéo de lancement, un reel produit ou une publicité animée à partir de code, de bout en bout : assets de marque depuis une URL, séquence de plans synchronisée, son mixé, boucle de critique, tous formats.

Qu'est-ce que motion-studio ?

Ce skill permet de produire des vidéos animées synchronisées avec le rythme, entièrement générées par code dans un projet motion-studio. Il couvre l'ensemble du pipeline : capture d'assets de marque depuis une URL, analyse de style à partir de références, synthèse musicale, découpage en plans sur une grille rythmique, génération du film avec des ressorts physiques, et une boucle de critique automatisée pour améliorer la qualité avant le rendu final. Le skill prend en charge plusieurs formats (9x16, 1x1, 16x9) et s'intègre avec des sous-agents spécialisés pour chaque étape. Il est conçu pour des films animés par code, pas pour de l'édition de séquences existantes, et inclut des garde-fous stricts (pas de hasard, pas de contenu inventé, respect des licences de polices).

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/yazzang-homelab/motion-studio/tree/HEAD/skills/motion-reel

Demander à votre IA préférée

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

Documentation

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 à xhigh tant 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 max pour 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, une critique d'un long film) s'exécutent en arrière-plan (l'outil Bash avec run_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éeValeur par défaut si omiseRemarques
Sujet : produit + URL, ou un sujetrequisUne URL déclenche l'étape des assets de marque
Durée20 s film produit, 15 s showreel, 16 s boucle UI6 à 8 plans tiennent dans 15 s
Formats9x16 principal, puis 1x1 et 16x94x5 également disponible
Marque : couleurs, polices, logocapturé depuis l'URL, sinon valeurs par défaut du studioun visage d'affichage, un visage UI, un accent
Référence : image, vidéo ou dossier d'imagesaucunesans elle, le modèle dérive vers le look interdit par les règles de la maison
Musiquesynthétiser, style pulse, 120 BPMune piste fournie est mesurée, jamais modifiée
Voix ou mascotteaucunenécessite ELEVENLABS_API_KEY dans .env
CTA et un chiffre de preuvedemander ; n'inventez jamais une métriquefilms produits uniquement
Niveau L1 à L4déduit de ce qu'ils ont fourni (section 2)définit les attentes de temps et de validation
Route A à DAB uniquement lorsque l'utilisateur nomme Remotion ou HyperFrames
ModePLANIFIER D'ABORD : montrer la liste des plans, attendre OKGO ignore l'attente, jamais la validation critique

2. Choisissez le niveau et la route

NiveauTaille 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ères15 à 50 min/motion-studio:showreel
L2 brand reel~350 caractères30 à 45 min/motion-studio:product-reel
L3 state spec1,5k à 3k caractères~1 à 2 h avec corrections/motion-studio:ui-morph-spec
L4 director brief9,5k à 19k caractères6 à 12 h autonome/motion-studio:director-brief
RouteUtilisez-la pourCe skill fait
A code-drawn (par défaut)showreels, animation UI, films produits, bouclesexécute le pipeline complet ci-dessous
B frameworkl'utilisateur nomme Remotion ou HyperFramesdélègue via /motion-studio:seek-engine (validation licence Remotion, Node 22+)
C mixed pipelinepersonnages ou physique à partir de modèles image/vidéonécessite des clés et un budget ; planifiez avec /motion-studio:director-brief
D footage editleurs propres clips enregistréshors 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.

#ÉtapeQuiProduitValidation
0Projet + vérificationvousstudio.json, dépendances, npm run doctor tout OKdoctor n'a PAS d'ÉCHEC
1Assets de marque (URL uniquement)motion-studio:asset-scoutassets/brand/**, assets/manifest.jsonlistez les assets à l'utilisateur
2Référence (le cas échéant)motion-studio:style-analystrefs/analysis.json, docs/style_guide.mdgrammaire, jamais le contenu
3Musique + grille rythmiquemotion-studio:sound-designer ou vousaudio/music.wav ou piste mesurée, audio/beats.jsonbpm/durée dans studio.json concordent
4Liste de plans sur la grille rythmiquemotion-studio:motion-directordocs/shotlist.mdOK utilisateur sauf autonome
5Construire le filmvousfilm/film.js (+ film/scenes/*)npm run lint propre
6Boucle de critiquemotion-studio:motion-critic + vousout/review/<fmt>/*, docs/review_log.mdnpm run gate réussi
7Rendu final, SFX, mixagevous (validé par accroche)out/<fmt>/final.mp4, out/score.wav-14 LUFS +-0,5, <= -1 dBTP
8Livraison + rapportvousout/deliver/**, docs/production.jsonnpm run deliver exit 0

Étape 0 : projet

  1. Cherchez studio.json dans 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 --install
    

    Ajoutez --brand-url <URL> pour les films produits et --loop pour 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 skill studio-init.

  2. npm run doctor. Corrigez chaque ÉCHEC avant l'étape 1 (navigateur, ffmpeg, Node >= 20). Sous Windows, la correction du navigateur est npx 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-scout avec 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écutez node "${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 ajoutez skills/product-reel/scripts/states.mjs, et pour un produit canvas canvas-frames.mjs (mêmes indicateurs pour --root ; les feuilles d'images arrivent dans assets/brand/frames/). Lisez assets/manifest.json vous-même, listez ce qui a été trouvé à l'utilisateur, et écrivez les couleurs et polices de la marque dans studio.json brand. La capture enregistre également les polices que la page charge dans assets/fonts/ avec la licence marquée UNVERIFIED sauf si une a été trouvée : confirmez-la avec l'utilisateur avant que cette police n'entre dans brand.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-analyst avec le chemin de référence. Il exécute node tools/refs.mjs extract|analyze et écrit docs/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 pointez studio.json audio.music vers elle. Pas de piste : node tools/score.mjs --style <pulse|piano|minimal|cinematic> --bpm <N> --dur <S>. Faites correspondre studio.json bpm et duration. 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-director avec les entrées, docs/style_guide.md et audio/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 ligne Status: de docs/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) :

  1. npm run lint, npm run stills.
  2. 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>.
  3. Deux passages de preuves qui ne s'écrasent jamais : node tools/critique.mjs --format <fmt> (film en direct, dans out/review/<fmt>/) et node tools/critique.mjs --format <fmt> --video out/<fmt>/final.mp4 (le rendu mixé, dans out/review/<fmt>/video/).
  4. Briefez motion-studio:motion-critic avec le numéro du tour, le format, ce qui a changé et Evidence: 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 fichiers metrics.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 P0 font-fallback dans le metrics.md en 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.
  5. 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, ou stills --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

ValidationCondition de réussiteAppliquée par
Liste de plansOK utilisateur, ou mode autonome enregistré dans docs/shotlist.mdvous
Lintnpm run lint exit 0accroche 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 P0npm run gate ; une accroche du plugin refuse render:final et build
Livraisonimages, durée, volume sonore, plages silencieuses, taille, affiche vérifiésnpm 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.md vous-même, ni ne changez studio.json gate pour 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 gate avant 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, requestAnimationFrame ou 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ÉtapeBriefez-le avecIl écrit
motion-studio:asset-scout1URL, racine du projet, commande de captureassets/**
motion-studio:style-analyst2chemin de référence, sujet, duréedocs/style_guide.md, docs/shotlist.md, refs/**
motion-studio:sound-designer3, 7piste ou style, bpm, durée, script vocalaudio/**, rapport de mixage
motion-studio:motion-director4entrées, guide de style, grille rythmiquedocs/**
motion-studio:motion-critic6numéro du tour, format, ce qui a changé, preuvedocs/review_log.md, scores

[Le contenu a été tronqué pour la traduction]

Individual skills in this repo

This repo contains 11 individual skills — each has its own dedicated page.

yazzang-homelab/motion-studio

Make Claude watch its own frames: critique.mjs evidence, harsh 7-axis scores, timestamped P0/P1/P2 problems in docs/review_log.md, fix the 3 worst, re-check, pass the gate. Use for 'critique it', 'review the frames', 'is it good'.

yazzang-homelab/motion-studio

Plan long-form or overnight films: director's brief (PLAN FIRST or GO, budget, definition of done), ANIMATION_GUIDE + STORYBOARD, chapter subagents, gates, chunked render. Use for 'overnight film', 'music video', '2-minute film'.

yazzang-homelab/motion-studio

Brand-asset stage of a product film (motion-reel runs the whole film): capture real screenshots, logo, colors and fonts from a URL, never redraw UI; brand story beats; voice + mascot. Use to grab or fix a brand's assets.

yazzang-homelab/motion-studio

Turn a reference (a frame, a video or an image library) into docs/style_guide.md and a beat-grid shot list: measure cuts, palette and pace, take grammar not content, wait for OK. Use when the user supplies or names a look.

yazzang-homelab/motion-studio

Build, debug or speed up the seek(t) render engine: render contract, canvas vs page capture, workers/subframes/chunks, determinism fixes, Remotion or HyperFrames handoff. Use for 'render is slow', 'frames differ', 'use Remotion'.

yazzang-homelab/motion-studio

Ship every format from one timeline, then package it: layout() reframing (never crop), render all formats, per-format checks, deliver.mjs, a brand skill, a service offer. Use for 'export 9:16 and 16:9', 'deliver', 'make a skill'.

yazzang-homelab/motion-studio

The viral one-line 'showreel for a résumé' prompt: why it works (anatomy), the credited quote, and seeded variants that avoid look-alike reels; runs it as an engine test. Use for that prompt, its variations, or a showreel.

yazzang-homelab/motion-studio

Score a film to its beat grid: measure a track (beats.mjs) or synthesize one (score.mjs), cue SFX from the film, add voice, mix to -14 LUFS / -1 dBTP at exact length. Use for 'add music', 'sync to the beat', 'SFX', 'loudness'.

yazzang-homelab/motion-studio

Make motion feel physical with closed-form springs from lib/motion.js: presets, springFromFeel, track() for multi-target values, loopTrack loops, indicators, text swaps. Use for 'feels linear', 'add bounce', 'easing to springs'.

yazzang-homelab/motion-studio

Scaffold a motion-studio film project (seek(t) renderer, springs, beat grid, synthesized sound, critique tools), install it, set up the browser, run doctor. Use for 'set up the motion studio', 'new film project', 'init studio'.

yazzang-homelab/motion-studio

Write a six-part XML state spec for a one-shape UI morph film (inputs, direction, structure, build, gotchas, start): states on downbeats, cursor-driven changes, seamless loop, approval gate. Use for 'UI morph', 'state list'.

Skills associés