Communitygithub.com

yazzang-homelab/motion-studio

Exportez chaque format depuis une seule timeline, puis conditionnez-la : recadrage layout() (jamais de crop), rendu de tous les formats, contrôles par format, deliver.mjs, une compétence de marque, une offre de service. Utilisez-la pour « exporter 9:16 et 16:9 », « livrer », « créer une compétence ».

Qu'est-ce que motion-studio ?

Cette compétence transforme un montage vidéo brut en un pipeline reproductible de production multi-format, de la création à la livraison. Elle permet de réaliser des films adaptés à tous les formats (9:16 pour Reels/TikTok/Shorts, 1:1 pour X, 16:9 pour YouTube, 4:5 pour le fil d'actualité portrait) à partir d'une seule timeline, en utilisant un système de layout `L` qui redimensionne intelligemment le contenu sans jamais recadrer. La compétence automatise le rendu, le mixage audio avec vérification de la loudness, et la livraison via `deliver.mjs` qui valide chaque format (nombre d'images, taille, durée, silence, pic vrai, taille de fichier). Elle inclut aussi un processus de critique par format pour garantir la qualité avant livraison. Enfin, elle guide l'utilisateur pour empaqueter ce pipeline en une compétence Claude personnalisée (en utilisant un template markdown) et même en une offre de service commerciale, rendant la production vidéo aussi simple qu'une phrase de commande.

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

Demander à votre IA préférée

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

Documentation

Livrer des formats, une compétence et un service (étape 12 du cours)

Trois actions transforment un bon clip en une activité reproductible : exporter chaque format depuis une seule timeline, empaqueter le pipeline en tant que compétence pour que la vidéo suivante tienne en une phrase, et, si l'utilisateur le souhaite, la vendre. Travaillez dans la racine du projet film. Arguments, affichés une fois :

Les fichiers de cette compétence se trouvent dans ${CLAUDE_SKILL_DIR} (les modèles dans assets/).

1. Recadrer par format, jamais couper

Les scènes sont dessinées par rapport au layout L (ctx.L dans la fabrique, c.L dans un dessin), donc une seule timeline restitue du 9:16, 1:1, 16:9 (et 4:5) avec le texte et l'interface placés pour chaque forme.

FormatTailleLibellé
9x161080x1920Reels, TikTok, Shorts
1x11080x1080X / fil d'actualité
16x91920x1080YouTube, site
4x51080x1350fil d'actualité portrait
OutilUtilisation
L.uunité de taille : 1 pour un petit côté de 1080 px ; 120 * L.u a la même taille dans tous les formats
L.Sle rectangle de sécurité {x, y, w, h} depuis studio.json safe[fmt] (marges d'interface des plateformes)
L.pos(ax, ay)un point à l'intérieur du rectangle de sécurité, ax, ay de 0 à 1
L.pick({ '9x16': a, '1x1': b, '16x9': c, portrait, landscape, square, default })valeurs par format : clé exacte, puis orientation, puis valeur par défaut
L.split('auto', ratio, gap)deux régions : empilées en portrait et carré, côte à côte en paysage
L.cols(n, gap) / L.rows(n, gap)colonnes ou lignes à l'intérieur du rectangle de sécurité
fitFontSize(g, text, maxW, (s) => font(s, family, weight), lo, hi, { tracking, step })la plus grande taille qui tient dans une largeur (lib/layout.js + lib/draw.js) ; step: 16 pour les polices bitmap
wrapText(g, text, maxW, font(size, family), { maxLines, ellipsis })lignes pour un texte multi-lignes, ne coupant jamais à l'intérieur d'une syllabe hangûl (lib/draw.js)
draw(g, lt, c) {
  const { L, brand } = c;
  const { a, b } = L.split('auto', L.pick({ landscape: 0.45, default: 0.4 }), 32 * L.u);   // titre | produit
  const size = Math.min(L.pick({ '9x16': 170, '1x1': 140, '16x9': 150 }) * L.u,
                        fitFontSize(g, 'FAITES-LE BOUGER.', a.w, (s) => font(s, brand.fonts.display, 400)));
  kinetic(g, 'FAITES-LE BOUGER.', a.x, a.y + a.h * 0.6, lt, { size, family: brand.fonts.display, weight: 400, color: brand.colors.fg, spring: 'default' });
  drawProduct(g, b, lt, c);                                         // l'interface produit remplit la région b dans tous les formats
}

Règles : pas de pixels littéraux ; contenu clé à l'intérieur de L.S ; le même moment se produit au même instant dans tous les formats (seuls le placement et la taille changent) ; un format qui ressemble à un recadrage d'un autre est une P1 dans la critique. Ajustez les marges safe dans studio.json, pas dans le code. Prévisualisez chaque format avec npm run preview (F alterne les formats, G affiche les guides de sécurité).

2. Réviser chaque format

La boucle de critique s'exécute sur le format principal ; avant la finale, exécutez au moins un cycle par autre format, chacun avec ses propres preuves (environ 115 s de temps d'outil par passage en direct et 85 s par passage --video, mesuré sur un film de 12 à 20 s) :

node tools/stills.mjs --format 1x1
node tools/render.mjs --format 16x9 --draft --sub 1 --scale 0.5     # environ 20 s ; ensuite : npm run sfx, node tools/mix.mjs --format 16x9
node tools/critique.mjs --format 16x9                                 # film en direct -> out/review/16x9/
node tools/critique.mjs --format 16x9 --video out/16x9/final.mp4      # rendu mixé -> out/review/16x9/video/

Consignez chaque cycle comme un tour distinct (## Tour <n> — 16x9 — ...). La porte de validation lit le dernier tour, donc terminez par un tour réussi.

3. Rendu, mixage, livraison

Ces étapes prennent quelques minutes : le démo de 12 s se rend en environ 4 min pour trois formats à 60 ips (environ 20 s par seconde de film), mix prend 40 à 80 s et deliver environ 40 s. Lancez npm run build, render:final, mix et deliver avec l'option run_in_background de l'outil Bash et un journal, interrogez le journal (tail -n 3), lisez le résultat après la ligne exit, et n'attendez jamais au premier plan plus d'environ 2 minutes ; ajoutez --chunk 10 pour une finale de trois formats ou plus d'environ 30 s. Le manuel du motion-reel (« Commandes longues ») contient le modèle.

ÉtapeCommandeSortie
tout, dans l'ordrenpm run buildpartition (si manquante), sfx, rendu final de tous les formats, mixage, livraison
rendu final (validé)npm run render:finalout/<fmt>/silent.mp4, poster.png, render.json pour chaque format dans studio.json formats
mixage et muxagenpm run mixout/score.wav, out/<fmt>/final.mp4, out/final.mp4 (principal), out/poster.png
vérifications et conditionnementnpm run deliverout/deliver/<slug>_<fmt>.mp4 + affiche + chaque page de la planche contact (<slug>_<fmt>_contact.png, puis _contact-2.png ...), out/deliver/manifest.json, docs/production.json

deliver.mjs vérifie, par format, out/<fmt>/final.mp4 par rapport au studio.json ACTUEL : nombre d'images (durée x fps), la taille du format, les fps et la durée exacte (un montage rendu avant une modification de duration ou fps échoue comme stale render ; un rendu brouillon ou à l'échelle échoue aussi), la loudness intégrée et le pic vrai par rapport à audio.lufs +- audio.lufsTolerance et audio.truePeak ; les plages silencieuses (une plage de 1 s ou plus en dessous de -50 dB échoue comme silence, par exemple silence 2.2 s à 00:02.1, sauf si elle commence dans les premières 0,3 s, commence dans la dernière seconde ou se trouve à l'intérieur d'un intervalle critique.allowSilence) ; la taille du fichier par rapport à deliver.maxBytes (par défaut x : 536 870 912 octets = la limite de téléchargement de 512 Mo de X ; ajoutez les limites des autres plateformes) ; l'affiche présente ; la jointure de boucle pour les films en boucle ; et la porte de validation de la critique. Il émet un avertissement (pas d'échec) lorsque les sources du film sont plus récentes que le rendu. Il se termine par 1 et nomme chaque vérification échouée ; un final.mp4 illisible échoue aussi. Avec --json, un échec imprime une ligne { ok: false, error, failed: [...] }, également lorsque l'exécution ne peut pas démarrer (un studio.json invalide, un format inconnu, un mauvais drapeau). --format 1x1 ne livre à nouveau que ce format et conserve les fichiers livrés et les entrées du manifeste des autres formats (carriedOver) ; une porte de validation échouée retire tous les fichiers livrés. docs/production.json enregistre le titre, les formats, les durées, la loudness, les tours, les derniers scores, le niveau d'effort (de CLAUDE_EFFORT lorsqu'il est défini) et les versions des outils.

Vérification échouéeCorrectif
nombre d'images ou durée erronés, ou stale renderrelancez npm run render:final ; ne livrez jamais un rendu partiel
loudness ou pic vrai/motion-studio:sound-design (tableau du rapport de mixage)
silenceune piste se termine tôt ou un lit joue sous rien : régénérez-le (npm run score, sfx, voice), npm run mix, livrez à nouveau
taille dépassant la limitenode tools/render.mjs --format <f> --final --crf 18 puis npm run mix à nouveau
affiche manquantedéfinissez studio.json poster (secondes) ou supprimez --no-poster
porte de validation/motion-studio:critique-loop

Faites un rapport à l'utilisateur : chaque fichier dans out/deliver/, les chiffres par format du manifeste, les scores du dernier tour, et ce que vous amélioreriez ensuite.

4. Empaqueter le pipeline en tant que compétence personnelle de l'utilisateur

Ainsi, la vidéo suivante tient en une phrase (/acme-reel vidéo de lancement pour le mode sombre, 20 s, vertical) :

  1. Choisissez le nom : <marque>-reel, lettres minuscules, chiffres et traits d'union.
  2. Créez .claude/skills/<marque>-reel/SKILL.md dans le dépôt de la marque (portée du projet, partagé via git) ou dans ~/.claude/skills/<marque>-reel/SKILL.md (personnel). Partez de ${CLAUDE_SKILL_DIR}/assets/brand-skill-template.md (assets/brand-skill-template.md).
  3. Remplissez-le à partir de ce projet, pas de mémoire : les valeurs de marque studio.json, docs/style_guide.md, le docs/shotlist.md approuvé comme modèle des beats narratifs, et les leçons de docs/review_log.md (ce que le critique signalait devient une règle stricte). Copiez le logo dans .claude/skills/<marque>-reel/assets/.
  4. Gardez la description sous environ 230 caractères avec des phrases de déclenchement concrètes, le corps sous environ 200 lignes.
  5. Testez-la dans une nouvelle session avec une demande réelle et vérifiez qu'elle ne demande que ce qui change d'une vidéo à l'autre.
  6. Pour partager au-delà d'un seul dépôt, publiez-la en tant que plugin (un dépôt avec .claude-plugin/plugin.json et skills/<nom>/SKILL.md), comme buildwithhanif/claude-animation-skill et ce plugin sont publiés.

5. La transformer en service (optionnel)

${CLAUDE_SKILL_DIR}/assets/service-offer.md (assets/service-offer.md) est une offre à remplir : ce qui est inclus (musique, mascotte dans n'importe quel style, fonctionnalités produit, offre à la fin, n'importe quelle langue, jusqu'à 3 modifications), formats, délai d'exécution, ce que le client fournit, droits et divulgation, et tarification. Point d'ancrage tarifaire : Tony Dinh a déclaré avoir payé environ 1 000 $+ pour une vidéo de lancement similaire un an avant d'en réaliser une avec Opus 5.5 en moins de 30 minutes (https://x.com/tdinh_me/status/2103703135902740699). Aidez l'utilisateur à la remplir ; ne la publiez pas et ne l'envoyez pas à sa place.

Suite : démarrez le prochain film avec /motion-studio:motion-reel, ou la nouvelle compétence /<marque>-reel de l'utilisateur.

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

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