Communitygithub.com

yazzang-homelab/motion-studio

Transformez une référence (une image, une vidéo ou une bibliothèque d'images) en docs/style_guide.md et en une liste de plans sur grille rythmique : mesurez les coupes, la palette et le tempo, capturez la grammaire sans le contenu, attendez le feu vert. Utilisez quand l'utilisateur fournit ou nomme un style.

Qu'est-ce que motion-studio ?

Cette compétence permet à un agent IA de transformer une référence visuelle (image fixe, vidéo ou dossier d'images) en deux documents clés pour la production vidéo : un guide de style (`docs/style_guide.md`) et une liste de plans rythmique (`docs/shotlist.md`) alignée sur une grille de beats. L'analyse extrait automatiquement la palette de couleurs, les types de transition, les temps de coupe, la densité de mouvement et les familles typographiques à l'aide d'un outil intégré (`refs.mjs`). Le principe fondamental est de ne copier que la *grammaire* visuelle de la référence (rythme, palette, texture) et jamais son contenu (logos, personnages, copie). L'agent présente les documents à l'utilisateur et attend une validation explicite avant de générer du code de film. Cette compétence fonctionne dans le cadre du studio Motion Studio et est conçue pour les agents comme Claude Code, Cursor ou Codex qui manipulent des projets créatifs avec une structure de dossiers définie.

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

Demander à votre IA préférée

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

Documentation

Style de référence (étape 05 du cours)

Sans référence, le modèle dérive vers un look par défaut : texte centré sur un dégradé avec chaque élément qui apparaît en fondu. Rexan Wong (@rexan_wong) a passé en revue un lot de clips viraux et a découvert que nommer un style fonctionne mieux que le décrire, et qu'une référence donne au modèle le rythme, le type de typographie et les transitions à copier. Cette compétence transforme une référence en deux documents approuvés avant que le moindre code de film n'existe.

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

L'échelle des références

ÉchelonCe que l'utilisateur donneCe que vous extrayezOutil
Une imageune image fixe d'une vidéo qu'ils adorentpalette, type, texture, densité de compositionrefs.mjs analyze refs/<dossier> + l'examiner
Une vidéoun fichier local d'un film qu'ils admirenttout ce qui précède plus les temps de coupe, les durées de plan, l'énergie de mouvement par seconde, les transitionsrefs.mjs extract + analyze
Une bibliothèqueun dossier de leurs propres images ou travaux passésun style maison que personne d'autre ne peut copierrefs.mjs analyze refs/<dossier>

Le film pure-code de Pleometric sur TikTok est parti d'une seule image fixe d'une autre animation virale ; son film à la Donald a pointé Opus vers sa propre galerie d'images PC-98. Où trouver des références : lancez des vidéos sur whatships.com, du motion sur Dribbble, et les films de lancement des concurrents. Étudiez-les ; ne les intégrez jamais et ne les redistribuez jamais.

1. Obtenir la référence sur le disque

  • Copiez le fichier ou le dossier dans refs/ du projet (créez la structure avec /motion-studio:studio-init d'abord s'il n'y a pas de studio.json).
  • Si vous n'avez qu'un lien vers la vidéo de quelqu'un d'autre, demandez à l'utilisateur une copie locale qu'il est autorisé à étudier. Ne téléchargez pas vous-même des médias tiers.
  • Une image fixe : placez-la dans son propre dossier (refs/frame/) pour que analyze la traite comme un jeu d'images.
  • Demandez ce qu'il faut prendre et ne pas prendre lorsque l'utilisateur a un avis ("le grain et la typo, pas les personnages").

2. Mesurer

Exécutez depuis la racine du projet :

RéférenceCommandes
vidéonode tools/refs.mjs extract refs/<vidéo> --every 0.5 puis node tools/refs.mjs analyze refs/<vidéo>
image ou bibliothèquenode tools/refs.mjs analyze refs/<dossier>
coupe rapide (nombreuses coupes manquées)ajoutez --threshold 0.2 à analyze

Sorties : refs/frames/frame_NNNN.png, refs/frames/frames.json, refs/contact.png (planche étiquetée de jusqu'à 60 vignettes ; une planche haute est paginée comme toute planche contact : refs/contact.png est la page 1, puis refs/contact-2.png, contact-3.png ... ; ouvrez chaque page, le résultat --json les liste dans contacts), et refs/analysis.json avec les temps de coupe, les durées de plan (moyenne, médiane, étendue), une palette à 6 couleurs avec proportions, luminosité et contraste, l'énergie de mouvement par seconde avec son pic, et une indication de densité de texte. Le résumé imprimé est une base de départ pour le guide de style.

3. Rédiger le guide de style et la liste de plans

Chargez motion-studio:style-analyst (il peut écrire docs/style_guide.md, docs/shotlist.md et refs/**) :

Racine du projet : <chemin absolu>. Référence : refs/<fichier ou dossier>. Sujet : <sujet>. Durée : <S> s.
Ouvrez refs/contact.png (et refs/contact-2.png ... quand elle est paginée) et quelques images autour des coupes, lisez refs/analysis.json.
Écrivez docs/style_guide.md en suivant les notes du guide de style, puis docs/shotlist.md pour un film de <S> s
à propos de <sujet> dans ce style, sur la grille rythmique de audio/beats.json (ou <BPM> BPM si absent).
Prenez la grammaire de la référence, jamais son contenu, ses logos, ses personnages ou sa copie.
Retournez des questions au lieu de deviner.

Les notes section par section sont dans assets/style-guide-notes.md. Pour les utilisateurs qui souhaitent coller une instruction dans une nouvelle session, les mêmes étapes sont rédigées comme assets/reference-prompt.md.

4. Prendre la grammaire, jamais le contenu

PrendreNe jamais prendre
relations de palette (fond sombre, un accent chaud, part de l'accent)logos, personnages, mascottes
familles typographiques par classe, graisse, crénage, sauts d'échellecompositions exactes ou images fixes
durées de plan et où les coupes tombent par rapport au beatla copie, les affirmations ou les données de la référence
types de transition (coupe franche, masque fondu, cut dans le mouvement)ses images, sa musique ou sa voix
langage caméra (zoom avant, panoramiques whip, caméra verrouillée)formes spécifiques à une marque ou habillage commercial
texture (quantité de grain, papier, tramage) et comment le texte entre et sorttout ce que l'utilisateur n'a pas demandé d'emprunter

5. La porte

Affichez les deux fichiers (un résumé compact du guide de style et le tableau de la liste de plans suffit) et attendez le feu vert de l'utilisateur avant tout code de film. Lorsqu'il les rejette, réécrivez la liste de plans (et le guide de style si le rendu est faux), ne corrigez jamais le code pour "montrer à la place". Enregistrez la décision sur la ligne Statut : en haut de docs/shotlist.md.

6. Laissez le modèle choisir la technique

Spécifiez le rendu et les contraintes, pas la bibliothèque. Pleometric a suggéré p5.js et Opus a écrit son propre moteur de rendu papier à la place. Dans ce studio, cela signifie : décrivez la texture et le mouvement que vous voulez dans le guide de style, et laissez la construction choisir comment les dessiner dans le moteur canvas (helpers lib/draw.js ou dessin personnalisé). Nommez un framework uniquement lorsque l'utilisateur en a besoin pour la réutilisation (route B, /motion-studio:seek-engine).

Suite : construisez avec /motion-studio:motion-reel à partir de son étape 5 ; pour une boucle d'état d'interface utilisateur dans ce style, /motion-studio:ui-morph-spec.

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

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