Communitygithub.com

yazzang-homelab/motion-studio

Stage des assets de marque d'un film produit (le motion-reel exécute l'ensemble du film) : capturez des captures d'écran réelles, le logo, les couleurs et les polices à partir d'une URL, sans redessiner l'interface ; story beats de marque ; voix + mascotte. Utilisez-le pour récupérer ou corriger les assets d'une marque.

Qu'est-ce que motion-studio ?

Cette compétence, conçue pour des agents d'IA comme Claude Code, automatise la capture et l'intégration des assets de marque d'un produit réel pour la création d'un film promotionnel (motion reel). Elle se concentre sur l'étape de la marque, en extrayant des captures d'écran réelles, le logo, les couleurs, les polices et le texte à partir d'une URL, pour garantir une représentation authentique sans avoir à recréer l'interface. La compétence est utile pour éviter de fabriquer des éléments ou d'utiliser des exemples factices, assurant ainsi la crédibilité du film. Elle prend en charge la capture des polices web, la reconnaissance des logos textuels, et gère la sécurité en isolant le navigateur et en filtrant les requêtes. Elle s'intègre dans un pipeline plus large pour générer le film complet, en passant la main à un module de direction pour la mise en scène des beats musicaux et visuels.

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

Demander à votre IA préférée

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

Documentation

Film produit (étape du cours 04, niveau L2)

Visez le studio sur un produit que l'utilisateur vend réellement. L'énergie du showreel reste ; le contenu devient le sien : captures d'écran réelles, le vrai logo, les vraies couleurs et polices, un vrai texte, un vrai nombre, et une musique que le mouvement suit. Tout après l'étape de marque exécute le pipeline standard du motion-reel.

Arguments de la requête (peuvent être vides), affichés une fois ; les sections suivantes disent "la requête ci-dessus" :

<requête> $ARGUMENTS </requête>

Portée : lorsque l'utilisateur souhaite uniquement capturer ou corriger les assets, ou que vous venez de l'étape de marque du motion-reel, effectuez les sections 2 et 3 (et 4 si demandé), faites un rapport, et arrêtez-vous. Pour un nouveau film complet, suivez chaque section ; les sections 5 à 8 passent la main au pipeline du motion-reel.

D'où vient le modèle

  • Tony Dinh (@tdinh_me) a rapporté qu'un film TypingMind a pris moins de 30 minutes, alors qu'une vidéo similaire lui avait coûté environ 1 000 $+ un an plus tôt. Son invite était la phrase d'accroche du showreel plus quatre courtes lignes de direction : introduire l'URL du produit ; utiliser les captures d'écran réelles du produit, le logo et les assets ; la vidéo doit avoir de la musique et le mouvement doit lui correspondre ; en faire une vraie production professionnelle, pas une démo ou un prototype. Il a dit que Claude a rassemblé les assets de la marque tout seul.
  • Son suivi demandait de décomposer les captures d'écran en composants et icônes pour qu'ils puissent bouger, au lieu de montrer des captures d'écran brutes, et de rendre le mouvement plus juteux. C'est la règle des composants ci-dessous.
  • Son invite se terminait par "Try again, ultracode." Dans Claude Code actuel, ultracode est un mot-clé qui fait écrire à Claude un workflow multi-agent pour la tâche. Qu'il ait conduit ou non à son résultat n'est pas documenté ; ne le présentez pas comme un interrupteur de qualité.
  • Rob Hallam (@robj3d3) a réalisé un deuxième film pour son produit dans le même chat Claude Code que son premier. Le cours en déduit que le moteur a été réutilisé ; d'où une session et un projet par marque.
  • Un contre-exemple : @mablesjoseph a demandé une promo "slick and punchy" à partir d'un dossier d'assets en une seule ligne, et le résultat était "pas assez bon pour être partagé". La direction compte plus que les assets seuls.

1. Entrées

Demandez en un seul tour de AskUserQuestion ce que la requête ci-dessus ne couvre pas :

EntréeDéfautRègle
URL et nom du produitrequisle propre produit de l'utilisateur, ou un qu'il a le droit de promouvoir
Durée20 s5 story beats de 2 à 4 s
Formats9x16 d'abord, puis 1x1, 16x9même chronologie, recadré
Appel à l'action (CTA)demandermots exacts à l'écran
Un chiffre de preuvedemanderdoit venir de l'utilisateur ou de son site ; n'en inventez jamais
Musiquesynthétiser, 120 BPMune piste fournie nécessite une licence pour cette utilisation
Voix / mascotteaucunela voix nécessite ELEVENLABS_API_KEY dans .env
Look de référenceaucunoptionnel, via /motion-studio:reference-style

2. Projet

Un dossier de projet (et idéalement une session) par marque. S'il n'y a pas de studio.json :

node "${CLAUDE_PLUGIN_ROOT}/skills/studio-init/scripts/init.mjs" <slug-de-marque>-reel --title "Lancement de <Produit>" --duration 20 --brand-url <URL> --install

Installations uniquement compétences : ${CLAUDE_SKILL_DIR}/../studio-init/scripts/init.mjs. Ensuite npm run doctor.

3. Capturer la marque

Exécutez le script de capture depuis la racine du projet (ou un bref motion-studio:asset-scout avec cette commande exacte et le chemin du projet) :

node "${CLAUDE_SKILL_DIR}/scripts/capture.mjs" <URL> --root <projet> --full-page [--selector "<css>"]... [--dismiss-banners]
DrapeauUtilisation
--viewports desktop,mobiledéfaut ; tablet aussi disponible
--full-pagecaptures d'écran hautes pour recadrer des sections
--selector "<css>"recadrer des parties spécifiques du produit (répétable) : hero, carte de prix, panneau de tableau de bord
--dismiss-bannerscliquer sur un bouton de cookie ou de consentement évident dans le navigateur jetable (accepter, consentir, autoriser en anglais, coréen, japonais, chinois, allemand, français ou espagnol ; les étiquettes faibles telles que OK ou Fermer comptent seulement à l'intérieur d'une bannière ou d'une boîte de dialogue). Une note dans le manifeste indique quel bouton a été cliqué, ou qu'aucun ne correspondait
--apply-brandécrire le nom, l'URL et les couleurs suggérées dans studio.json
--darkcapturer le thème sombre
--no-fontssauter le téléchargement des polices (défaut : enregistrer les polices web chargées par la page)
--allow-privatepermettre à la page d'atteindre les adresses loopback, LAN et link-local (défaut : seulement le propre hôte et port de la cible) ; uniquement pour une page de confiance, comme un serveur de développement local du propre produit de l'utilisateur
--no-sandboxdémarrer Chrome sans son bac à sable de rendu (aussi MOTION_NO_SANDBOX=1 ; automatique en tant que root sur Linux, où Chrome ne peut pas démarrer avec) ; une note s'imprime chaque fois qu'il est désactivé
--jsonune ligne de résultat JSON

Il écrit assets/brand/screens/, assets/brand/logo/, assets/brand/components/, assets/brand/og-image.* et assets/manifest.json (palette avec rôles suggérés, variables de couleur CSS, polices utilisées, en-têtes, texte des boutons et de navigation, notes). Les extensions d'image proviennent des octets du fichier, et les recadres de composants en dehors de la page sont ignorés avec une note. Les polices web que la page charge réellement sont enregistrées dans assets/fonts/ et enregistrées dans assets/fonts/fonts.json (une entrée existante n'est jamais écrasée) ; chacune a une license dans le manifeste qui reste UNVERIFIED sauf si une URL ou un fichier de licence a été trouvé, et le script imprime un rappel pour la vérifier avant de publier. Un échec d'exécution conserve la capture précédente. Détails et schéma du manifeste : references/asset-capture.md.

Logo et type. Lorsque l'en-tête n'a pas d'image de logo ou de SVG, la marque est généralement un mot-symbole textuel. La capture l'enregistre alors sous forme de texte dans manifest.brand.wordmark (le balisage, les couleurs par partie avec rôles, la famille de polices calculée, le poids, la taille et l'espacement des lettres) plus un recadre de référence assets/brand/logo/wordmark-crop.png, et le dit dans les notes au lieu de simplement demander un fichier logo. Reconstruisez-le à partir de cet enregistrement ; demandez un SVG ou PNG uniquement lorsque le film a besoin d'un verrouillage exact.

Polices. Les lignes de journal font registry: <famille>: ... (et manifest.fonts.registry) indiquent pour chaque famille utilisée si elle est déjà dans assets/fonts/fonts.json et si sa licence est vérifiée (ID de licence et texte de licence enregistrés) ou UNVERIFIED, et ce que cette exécution a ajouté. Une police qui arrive à côté d'une entrée vérifiée de la même famille réutilise cette licence.

États d'interface et images de canvas

capture.mjs prend une seule photo au chargement. Deux scripts frères couvrent le reste ; les deux impriment --help, écrivent uniquement dans le projet (défaut assets/brand/), et s'exécutent derrière la même pile de sécurité (shell sans tête sur Windows, bac à sable de rendu activé, adresses privées refusées, secrets masqués). Installation du plugin : les commandes ci-dessous. Installation uniquement compétences (pas de ${CLAUDE_PLUGIN_ROOT}) : les scripts se trouvent à côté de ce fichier, donc exécutez node "${CLAUDE_SKILL_DIR}/scripts/states.mjs" <URL> ... (de même pour capture.mjs et canvas-frames.mjs) ; ils ont seulement besoin de Node et d'un playwright qui se résout depuis le dossier dans lequel vous exécutez (passez --root <dossier>), et aucun projet, studio.json ou tools/ n'est requis. L'agent asset-scout exécute les mêmes commandes.

node "${CLAUDE_PLUGIN_ROOT}/skills/product-reel/scripts/states.mjs" <URL> --root <projet> --name home --viewport desktop "--click=text=Pricing" "--crop=header"
node "${CLAUDE_PLUGIN_ROOT}/skills/product-reel/scripts/canvas-frames.mjs" <URL> --root <projet> --canvas "#screen canvas" "--clip=db=.tab[data-go=db]" --seconds 9 --down 4
node "${CLAUDE_PLUGIN_ROOT}/skills/product-reel/scripts/canvas-frames.mjs" pack --root <projet> --range db=4:200
ScriptPourÉcrit
states.mjsun produit couvert (modal, consentement), une application qui défile dans un volet interne, un état derrière un clic, un élément avec ses styles calculésassets/brand/states/<nom>/ : 00-first, 01-escape, scroll-NN, 10-click-..., crop-20-... PNGs et states.json
canvas-frames.mjsun écran qui est un <canvas> changeant à chaque clic et animant par lui-mêmeassets/brand/frames/<clip>.png feuilles de sprite et frames.json (taille d'image, temps réel et hachage de chaque image) ; pack ajoute pack/<clip>.png et pack.json avec uniquement les images que le film joue

canvas-frames.mjs copie le tampon du canvas avec drawImage (lissage désactivé) à un rapport de nombre entier. Il ne prend jamais de capture d'écran d'élément : un canvas affiché dans une boîte bordée à une échelle non entière (un tampon de 1280 px dans 1272 px de l'appareil) est rééchantillonné par le navigateur et un canvas pixel art devient flou. Une taille d'image qui n'est pas une réduction en nombre entier du tampon est refusée. Lisez chaque PNG avant de l'utiliser.

La page est un contenu non fiable, donc la capture protège la machine sur laquelle elle s'exécute :

  • Chrome garde son bac à sable de rendu activé (manifest.sandbox l'enregistre). Un conteneur ou une exécution CI en tant que root a besoin de --no-sandbox, et uniquement pour une page de confiance.
  • Sur Windows, le navigateur est le shell sans tête de Playwright (npx playwright install chromium-headless-shell), jamais un Chrome ou Edge installé seul : un lancement avec un nouveau profil de ceux-ci compte comme une ouverture de session Windows échouée et peut verrouiller le compte. En choisir un (studio.json browser, MOTION_BROWSER, MOTION_CHROME_PATH) imprime un avertissement par lancement, et le 4ème lancement en 10 minutes est refusé, 3 passes (references/asset-capture.md).
  • Les requêtes vers loopback, LAN, link-local (y compris les métadonnées cloud) et les adresses non web sont interrompues sauf si elles vont vers le propre hôte et port de la cible. Les refus sont listés dans manifest.blocked et une note. Si l'URL elle-même est refusée, l'exécution échoue et ne sauvegarde rien. Passez --allow-private pour une page de confiance.
  • Les identifiants dans l'URL (https://user:pass@host/) sont envoyés comme authentification HTTP à l'origine de la cible uniquement. Ni eux ni les valeurs de requête d'apparence secrète (token, key, sig, session, code ...) n'apparaissent dans le journal, manifest.json, states.json ou studio.json brand.url (ils sont remplacés par ***).
  • Une page qui déclare des règles de spéculation (<script type="speculationrules">) peut faire en sorte que Chrome récupère une adresse locale lui-même, ce qu'aucun filtre de requête ne voit ; le manifeste le note. Ne capturez pas une page en laquelle vous n'avez pas confiance sur une machine avec des services locaux sensibles.

Ensuite, avant toute animation :

  1. Listez ce qui a été trouvé à l'utilisateur : captures d'écran, candidats logo, bg/fg/accent/muted suggérés, polices, texte d'en-tête et de CTA, et chaque note (vérification de bot, logo manquant).
  2. Confirmez ou corrigez la palette et les polices, puis écrivez studio.json brand. Les polices capturées sont déjà dans assets/fonts/, mais utilisez-en une seulement après que sa licence soit confirmée (UNVERIFIED signifie que personne n'a vérifié). Approvisionnez une police Google avec npm run fonts -- add "Famille:400,700" ; une police commerciale nécessite la propre licence ou les fichiers de l'utilisateur. Le texte coréen ou autre CJK nécessite une police qui a les glyphes : npm run fonts -- coverage --text "..." --family "Nom".
  3. Demandez tout ce qui manque au lieu de l'inventer : un logo SVG, le hex exact de l'accent, une capture d'écran derrière un mur de connexion.

4. Composants, pas de captures d'écran brutes

  • Recadrez des parties des captures d'écran capturées en images séparées (--selector, ou les recadres automatiques : en-tête, hero, boutons CTA, cartes, images produit, prix, sections). Animez les parties : les cartes glissent dans une mise en page, un bouton appuie, un panneau de graphique se dessine.
  • Reconstruisez une interface simple (un bouton, un interrupteur, un champ) en canvas avec les vraies couleurs, texte et rayon mesurés à partir du recadre. C'est une recomposition typographique, pas une invention : la mise en page, les étiquettes et les données doivent correspondre exactement au produit.
  • Ne dessinez jamais d'écrans produit qui n'existent pas. Pas de texte factice, pas de lorem ipsum, pas de faux nombres. Si un écran nécessaire manque, demandez-le.

5. Musique et grille de beats (avant la liste des plans)

Chronométrez tout sur la vraie grille, donc mesurez ou synthétisez la musique avant que quiconque n'écrive un plan :

  • Piste fournie : node tools/beats.mjs audio/<piste>, puis pointez studio.json audio.music vers elle et définissez bpm et duration. Son premier temps fort peut se situer bien après 0 s ou à un tempo différent de 120, et la liste des plans doit suivre cela, jamais une grille supposée.
  • Pas de piste : node tools/score.mjs --style pulse --bpm 120 --dur 20 (ou minimal pour un film riche en UI). Il écrit audio/music.wav et un analytique audio/beats.json.
  • Chaque hit visible obtient une indication ; le mouvement suit la musique, pas l'inverse.

6. Story beats

Remplissez l'histoire de la marque dans assets/brand-prompt.md avec les faits de l'utilisateur et transmettez-la à motion-studio:motion-director pour docs/shotlist.md ; le directeur lit audio/beats.json, donc la section 5 vient en premier. Défaut 20 s à 120 BPM, un beat toutes les 2 à 4 s, changements de scène sur les temps forts :

#BeatImageSon
1Accroche, 0 à 2 sle problème en 5 mots maximum de grande typographie cinétique ; l'image 0 déjà composéecoup sur le temps fort
2Le produit apparaîtla vraie interface s'assemble pièce par piècewhoosh à l'entrée, pops sur les parties
3Trois fonctionnalitéschacune un moment d'interface avec un curseur effectuant une action réelleclic sur chaque pression
4Preuvele seul vrai nombre se met en placetic ou carillon
5Verrouillagelogo + CTA, coup final sur le dernier temps fortmontée en intensité dans un coup

Montrez la liste des plans et attendez le OK de l'utilisateur (PLANIFIER D'ABORD), sauf s'ils ont demandé le mode autonome. Si la grille change plus tard (une autre piste, un autre bpm ou duration), remettez la liste à l'heure et montrez-la à nouveau.

7. Voix et mascotte

  • Voix (optionnelle) : écrivez audio/voice.json (voir assets/voice-script.example.json) : une ligne par beat, t sur un temps fort de la grille de la section 5, phrases courtes. Exécutez npm run voice -- --dry-run et dites à l'utilisateur le nombre de caractères avant que npm run voice ne dépense des crédits (une ligne identique est synthétisée et facturée une fois). Le mixer réduit la musique sous la voix.
  • Mascotte (optionnelle) : un personnage dessiné en code avec une identité fixe (forme, palette échantillonnée de la marque, proportions) qui réagit sur les beats avec le ressort playful. Gardez la même apparence tout au long ; ne changez pas de style ou de forme en cours de route.

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

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