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,
ultracodeest 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ée | Défaut | Règle |
|---|---|---|
| URL et nom du produit | requis | le propre produit de l'utilisateur, ou un qu'il a le droit de promouvoir |
| Durée | 20 s | 5 story beats de 2 à 4 s |
| Formats | 9x16 d'abord, puis 1x1, 16x9 | même chronologie, recadré |
| Appel à l'action (CTA) | demander | mots exacts à l'écran |
| Un chiffre de preuve | demander | doit venir de l'utilisateur ou de son site ; n'en inventez jamais |
| Musique | synthétiser, 120 BPM | une piste fournie nécessite une licence pour cette utilisation |
| Voix / mascotte | aucune | la voix nécessite ELEVENLABS_API_KEY dans .env |
| Look de référence | aucun | optionnel, 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]
| Drapeau | Utilisation |
|---|---|
--viewports desktop,mobile | défaut ; tablet aussi disponible |
--full-page | captures 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-banners | cliquer 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 |
--dark | capturer le thème sombre |
--no-fonts | sauter le téléchargement des polices (défaut : enregistrer les polices web chargées par la page) |
--allow-private | permettre à 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-sandbox | dé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é |
--json | une 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
| Script | Pour | Écrit |
|---|---|---|
states.mjs | un 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és | assets/brand/states/<nom>/ : 00-first, 01-escape, scroll-NN, 10-click-..., crop-20-... PNGs et states.json |
canvas-frames.mjs | un écran qui est un <canvas> changeant à chaque clic et animant par lui-même | assets/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.sandboxl'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.jsonbrowser,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.blockedet une note. Si l'URL elle-même est refusée, l'exécution échoue et ne sauvegarde rien. Passez--allow-privatepour 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.jsonoustudio.jsonbrand.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 :
- Listez ce qui a été trouvé à l'utilisateur : captures d'écran, candidats logo,
bg/fg/accent/mutedsuggérés, polices, texte d'en-tête et de CTA, et chaque note (vérification de bot, logo manquant). - Confirmez ou corrigez la palette et les polices, puis écrivez
studio.jsonbrand. Les polices capturées sont déjà dansassets/fonts/, mais utilisez-en une seulement après que sa licence soit confirmée (UNVERIFIEDsignifie que personne n'a vérifié). Approvisionnez une police Google avecnpm 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". - 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 pointezstudio.jsonaudio.musicvers elle et définissezbpmetduration. 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(ouminimalpour un film riche en UI). Il écritaudio/music.wavet un analytiqueaudio/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 :
| # | Beat | Image | Son |
|---|---|---|---|
| 1 | Accroche, 0 à 2 s | le problème en 5 mots maximum de grande typographie cinétique ; l'image 0 déjà composée | coup sur le temps fort |
| 2 | Le produit apparaît | la vraie interface s'assemble pièce par pièce | whoosh à l'entrée, pops sur les parties |
| 3 | Trois fonctionnalités | chacune un moment d'interface avec un curseur effectuant une action réelle | clic sur chaque pression |
| 4 | Preuve | le seul vrai nombre se met en place | tic ou carillon |
| 5 | Verrouillage | logo + CTA, coup final sur le dernier temps fort | monté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,tsur un temps fort de la grille de la section 5, phrases courtes. Exécuteznpm run voice -- --dry-runet dites à l'utilisateur le nombre de caractères avant quenpm run voicene 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.