Communitygithub.com

yazzang-homelab/motion-studio

Rédige un cahier des charges d'état XML en six parties pour un film de morphing d'une seule forme UI (entrées, direction, structure, construction, pièges, démarrage) : états sur les temps forts, changements pilotés par le curseur, boucle sans couture, validation. Utilisé pour 'morph UI', 'liste d'états'.

Qu'est-ce que motion-studio ?

Cette compétence (skill) guide la création d'un cahier des charges précis pour un film d'animation de morphing d'interface utilisateur, où une seule forme se transforme en continu (bouton, loader, player, graphique, palette de commandes) sans coupure. Elle est basée sur le modèle viral à six sections (entrées, direction, structure, construction, pièges, démarrage) popularisé par @twoclipping et @verbove. L'utilisateur est invité à fournir les entrées (produit, états, données réelles, couleurs, musique), puis un fichier XML de spécification est généré et rempli. Les états sont ensuite placés sur une grille de temps, chaque changement étant provoqué par un clic de curseur réel. La boucle est garantie : le dernier état morph (se transforme) vers le premier. Une étape de validation (`gate`) demande l'approbation avant toute écriture de code. La compétence s'appuie sur des sous-agents comme `motion-director` pour la rédaction et `motion-reel` pour la critique, et produit des fichiers dans `docs/`. Elle est conçue pour des environnements comme Claude Code, Cursor ou Codex, et nécessite Node.js pour exécuter les scripts de grille et de liste d'états. Le résultat final est une boucle vidéo sans couture, avec des formats 9x16, 1x1 et 16x9, prête pour la livraison.

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

Demander à votre IA préférée

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

Documentation

Spécification de morph UI (étape 06 du cours, niveau L3)

Écris la liste d'états, pas l'ambiance. Le prompt le plus mis en favoris de la semaine de lancement d'Opus 5.5 n'était pas une phrase courte : la boucle de morph UI de @twoclipping et le film MakerMap de @verbove utilisaient tous deux une spécification XML avec des entrées à demander, une direction, une liste d'états temps par temps, des règles de construction et des pièges. L'idée derrière : une seule forme qui ne coupe jamais. Un élément unique change de taille, de rayon et de couleur d'état en état (bouton, loader, player, graphique, palette de commandes), un curseur provoque chaque changement avec un clic réel, et la dernière image est égale à la première pour que le film boucle.

Arguments de la requête (peuvent être vides), affichés une fois :

Crédit : la disposition en six sections suit le modèle public de @twoclipping (https://x.com/twoclipping/status/2103273003555402193 ; le XML est dans le message principal, pas dans une réponse de fil comme le cours l'indique) et la spécification MakerMap de @verbove (https://x.com/verbove/status/2103483957266268381). Le modèle dans cette compétence est écrit dans les propres mots de motion-studio : assets/spec-template.xml.

1. Demander les entrées

Demander en un tour de AskUserQuestion (les sous-agents ne peuvent pas demander ; c'est toi qui le fais) :

EntréeDéfautRègle
Produit + URLrequiscapturer l'UI réelle et copier avec /motion-studio:product-reel étape 3 quand il y a une URL
8 à 12 états dans l'ordre de l'histoirelogo, CTA, champ email, loader, check, carte, graphique, palette de commandesun par temps fort
Données réelles par étatdemanderétiquettes, nombres, noms du produit ; pas de valeurs génériques
Couleurs de la marque, polices, un accentde la capture ou de studio.jsonun accent
Piste sonoresynthétiser minimal à 120 BPMune piste fournie doit permettre cette utilisation et commencer sur un temps fort
Formats9x16, 1x1, 16x9même timeline, recadrée
Boucleouile dernier état morph (se transforme) en le premier

2. Remplir la spécification

Copier le modèle dans le projet sous docs/spec.xml et remplir chaque [...] avec les réponses. Conserver les six sections : <inputs>, <direction>, <structure>, <build>, <gotchas>, <start>. Le sous-agent motion-director (motion-studio:motion-director) peut la rédiger à partir de ton brief ; il écrit uniquement sous docs/.

3. Placer les états sur la grille de temps

  1. Projet : initialiser avec --loop si nécessaire (node "${CLAUDE_PLUGIN_ROOT}/skills/studio-init/scripts/init.mjs" <dir> --title "<Produit> morph" --loop --duration <S> --install ; dans une installation sans plugin, utiliser node "${CLAUDE_SKILL_DIR}/../studio-init/scripts/init.mjs" ... avec les mêmes options, ou invoquer la compétence studio-init).

  2. Grille : node tools/score.mjs --style minimal --bpm 120 --dur <S>, ou mesurer la piste fournie avec node tools/beats.mjs audio/<track>.

  3. Liste d'états avec les temps exacts, vérifications de boucle et avertissements :

    node "${CLAUDE_SKILL_DIR}/scripts/statelist.mjs" --states "logo,CTA button,email field,loader,check,card,chart,palette" --out docs/statelist.md
    
    OptionUtilisation
    --states "a,b:2,c" ou --file list.txtétats dans l'ordre ; :2 maintient un état pendant deux mesures
    --beats audio/beats.jsongrille mesurée (par défaut quand le fichier existe) ; --beats none l'ignore
    --bpm N, --beats-per-bar Nremplacer la grille
    --no-loopun film qui se termine au lieu de boucler
    --jsonune ligne JSON avec le début, la fin et le timing du contenu de chaque état

    Il avertit lorsque la durée de la boucle diffère de duration dans studio.json, lorsque le premier état n'est pas à 0 s (un pickup dans la piste), ou lorsqu'un état dure moins de 1 s. Corriger la durée ou couper la piste avant de continuer.

  4. Remplir les colonnes d'action du curseur, de données et de son de docs/statelist.md, et copier le tableau dans docs/shotlist.md.

4. La validation

Montrer la liste d'états sur la grille de temps et attendre l'accord de l'utilisateur avant d'écrire du code de film (la section <start> le dit, et le cours aussi). Une liste refusée est réécrite, pas contournée par le code. Enregistrer la décision sur la ligne Status: de docs/shotlist.md.

5. Construire à partir de l'exemple vérifié

Copier assets/morph-loop.film.js dans film/film.js et l'adapter : c'est une boucle fonctionnelle de 16 s, 8 états à 120 BPM qui s'affiche dans tous les formats. Remplacer STATES (tailles en unités de 1080 px, jeton de remplissage), COPY et les peintres content par la liste approuvée et les vraies données ; conserver les mécanismes :

MécanismeAPIRègle
temps des étatsgrid.bar(i)jamais de secondes tapées en dur
taille du conteneur, rayon, canaux de couleur, zoom de la caméraloopTrack(t, keys, dur, spring)clés dans [0, duration] ; le changement de bordure une fois, en tant que clé sur le premier temps fort (cet exemple) ou à t = duration
entrée et sortie du contenuswapAlpha(t, start, nextStart)entre après le début du morph, sort avant le suivant
curseurloopTrack sur x et y, cursor(g, x, y, { pressed })clique sur l'élément actuel sur le temps fort
onglets et surbrillance de listeindicator(t, stops, { width })bords avec différents ressorts
sonscues de grid.bar et grid.beatclic sur les pressions, swoosh sous les morphs
grain et autre bruit indexé par imagegrain(g, W, H, c.frame % LOOP_FRAMES, ...) avec LOOP_FRAMES = Math.round(dur * fps)la critique compare hash(0) avec hash(duration, { wrap: false }) ; le bruit initialisé par l'index d'image brut fait que la fin diffère de l'image 0 et échoue à la vérification de boucle

Chaque motif avec son raisonnement : references/morph-recipes.md. Définir studio.json "loop": true et duration sur la durée de la boucle, puis npm run lint.

6. Critique et livraison

Exécuter la boucle de critique de /motion-studio:motion-reel (au moins 3 tours, tous les axes >= 8, aucun P0 ouvert ; chaque tour construit le rendu mixé et les deux passes de preuve d'abord, voir son manuel de pipeline). Pour les boucles de morph, vérifier aussi out/review/<fmt>/loop.png (passe live uniquement ; la passe video/ n'a pas de panneau de boucle) et la métrique de "couture de boucle" (hash(0) égal à hash(duration, { wrap: false }), ratio de continuité <= 1.5 ; le panneau |end - first| doit être noir, ce que le grain indexé par image brise à moins que son index ne boucle), les étiquettes pendant chaque échange dans strip.png, et la position du curseur à chaque temps fort dans contact.png. Un saut de couture est un P0. Ensuite npm run build.

Règles pour les films de morph

  • Un seul conteneur, jamais de coupure. Les états diffèrent uniquement par la taille, le rayon, le remplissage et le contenu.
  • Un curseur provoque chaque changement ; aucun état ne change tout seul.
  • Quelque chose bouge sur chaque temps : une pression, une frappe, un compteur, un tracé de ligne, une étape de surbrillance.
  • Uniquement des données réelles du produit. Des ressorts avec au plus une légère suggestion de dépassement ; aucun sur la typographie.
  • Interdit : easing rebondissant, lueurs, dégradés sur le chrome de l'UI, explosions de particules, temps morts.
  • Jamais de will-change (ni d'astuce de pixellisation) sur quoi que ce soit que la caméra redimensionne.

Suivant : /motion-studio:springs pour ajuster la sensation ; /motion-studio:ship-formats pour le recadrage et la livraison par format.

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

Make a launch video, app or product reel, explainer or motion ad from code, end to end: brand assets from a URL, beat-grid shot list, synced sound, critique loop, all formats. Default for new video requests; not footage edits.

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

Skills associés