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.
| Format | Taille | Libellé |
|---|---|---|
9x16 | 1080x1920 | Reels, TikTok, Shorts |
1x1 | 1080x1080 | X / fil d'actualité |
16x9 | 1920x1080 | YouTube, site |
4x5 | 1080x1350 | fil d'actualité portrait |
| Outil | Utilisation |
|---|---|
L.u | unité de taille : 1 pour un petit côté de 1080 px ; 120 * L.u a la même taille dans tous les formats |
L.S | le 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.
| Étape | Commande | Sortie |
|---|---|---|
| tout, dans l'ordre | npm run build | partition (si manquante), sfx, rendu final de tous les formats, mixage, livraison |
| rendu final (validé) | npm run render:final | out/<fmt>/silent.mp4, poster.png, render.json pour chaque format dans studio.json formats |
| mixage et muxage | npm run mix | out/score.wav, out/<fmt>/final.mp4, out/final.mp4 (principal), out/poster.png |
| vérifications et conditionnement | npm run deliver | out/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ée | Correctif |
|---|---|
nombre d'images ou durée erronés, ou stale render | relancez npm run render:final ; ne livrez jamais un rendu partiel |
| loudness ou pic vrai | /motion-studio:sound-design (tableau du rapport de mixage) |
silence | une 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 limite | node tools/render.mjs --format <f> --final --crf 18 puis npm run mix à nouveau |
| affiche manquante | dé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) :
- Choisissez le nom :
<marque>-reel, lettres minuscules, chiffres et traits d'union. - Créez
.claude/skills/<marque>-reel/SKILL.mddans 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). - Remplissez-le à partir de ce projet, pas de mémoire : les valeurs de marque
studio.json,docs/style_guide.md, ledocs/shotlist.mdapprouvé comme modèle des beats narratifs, et les leçons dedocs/review_log.md(ce que le critique signalait devient une règle stricte). Copiez le logo dans.claude/skills/<marque>-reel/assets/. - Gardez la description sous environ 230 caractères avec des phrases de déclenchement concrètes, le corps sous environ 200 lignes.
- 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.
- Pour partager au-delà d'un seul dépôt, publiez-la en tant que plugin (un dépôt avec
.claude-plugin/plugin.jsonetskills/<nom>/SKILL.md), commebuildwithhanif/claude-animation-skillet 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.