Communitygithub.com

sstani-bgv/montage-skills

Réalise l'ensemble des animations d'une vidéo du début à la fin (par défaut dans le style v4 « présentation avec images » – étalon approuvé par l'auteur) : visionner la vidéo ou le transcript, planifier le motion-design, distribuer les scènes aux sous-agents, valider le travail, assembler le montage brut avec les incrustations sur l'original et livrer le tout avec les MP4 par timecodes.

Qu'est-ce que montage-skills ?

Ce skill orchestre l'ensemble du pipeline de motion-design, de la matière première (vidéo/transcript) aux MP4 finales prêtes à l'incrustation. Il commence par générer un plan de motion via `/motion-plan`, crée une structure de projet standardisée, génère des images et des clips, puis distribue les scènes à plusieurs sous-agents travaillant en parallèle. Le skill gère également la validation visuelle (vérification de chaque plan clé), l'assemblage final des incrustations sur la source, et la livraison d'une maquette de montage. Une particularité importante est l'inspection manuelle des sous-agents : la vérification par contact-sheet est interdite car trompeuse. L'étalon de style par défaut est la variante « présentation avec images » (v4), validée par l'auteur. Cette compétence est conçue pour des environnements comme Claude Code, Cursor ou Codex et exige que l'agent orchestreur inspecte lui-même les rendus, car les sous-agents ne détectent pas les défauts de composition.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/sstani-bgv/montage-skills/tree/HEAD/motion-run

Demander à votre IA préférée

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

Documentation

Nom : motion-run Description : Réalise l'ensemble des animations d'une vidéo du début à la fin (par défaut dans le style v4 « présentation avec images » – étalon approuvé par l'auteur) : visionner la vidéo ou le transcript, planifier le motion-design, distribuer les scènes aux sous-agents, valider le travail, assembler le montage brut avec les incrustations sur l'original et livrer le tout avec les MP4 par timecodes. Utilisez cette compétence à chaque fois que l'utilisateur demande des animations pour sa vidéo, de la vie avec des incrustations, « faire comme tel créateur », assembler des graphiques sur un matériel déjà enregistré ou finaliser un plan de motion existant. C'est le point d'entrée : il appelle lui-même /motion-plan pour la planification et distribue l'assemblage via /motion-build. Pour une seule animation, utilisez directement /motion-build.

Orchestration des incrustations animées pour la vidéo

Tu mènes tout le chemin : matière première → plan de motion → MP4 prêtes avec timecodes, que l'utilisateur intègre dans son montage. Tu ne construis presque rien toi-même : tu planifies, distribues et valides le travail.

Ta valeur principale ici est la validation. Les sous-agents construisent les compositions de bonne foi, mais seuls ceux qui regardent les plans d'un œil extérieur voient les lacunes de composition. Un échec de validation coûte plus cher qu'un échec de construction.

Pipeline v4 (par défaut)

Style : ../motion-build/references/style-v4.md. Ordre éprouvé (stream de 41 min, 34 incrustations + intro) :

  1. Texte et plans. /watch sur la source (transcript), pour le plan — découpage mot à mot des morceaux.
  2. Plan via /motion-plan → présenter à l'utilisateur, valider les corrections (durée de l'intro, densité, mises en page là où l'auteur dessine). Ne pas commencer la construction sans accord.
  3. Dossier de travail W dans scratchpad//tmp : scenes.json ({NN: start, dur, layout, title}), scenes/, img/, clips/.
  4. Images : prompts.tsv → zsh ../motion-build/scripts/gen_images.sh prompts.tsv W/raw → alpha.py W/raw W/img. Consulte la liste de toutes les images : les doublons et les ratés (fond resté, mauvais objet) — régénère-les.
  5. Clips : python3 ../motion-build/scripts/cut_clips.py W source.mp4 --cam x,y,w,h (mesure la webcam sur le plan).
  6. Brief : copie references/build-brief-v4.md dans W/BUILD-BRIEF.md, inscris les chemins et corrections du plan. Les scènes déjà approuvées mets-les dans W/scenes/ comme étalons.
  7. Distribution : 7 à 8 sous-agents en un seul message, 3 à 5 scènes d'une même mise en page par agent (kinetic — à un seul agent entièrement). Dans la mission : le brief, l'étalon de mise en page issu de recipes/v4/, les specs, « regarder les plans avec les yeux ».
  8. Validation — sur le plan pleine taille de la fin de chaque scène (recadrage du panneau), la planche-contact 3×3 ment sur la taille de la police. Renvoie avec des précisions : « légendes ≥30px, personnage ≥240px, moitié inférieure du panneau vide ». Quand tu trouves une erreur commune — diffuse-la immédiatement aux agents encore en travail.
  9. Assemblage : python3 scripts/assemble_v4.py W source.mp4 [--intro intro.mp4 --cut SEC] — incrustations avec leur SFX + maquette. Prends des plans de la maquette aux points d'incrustation et aux jonctions.
  10. Livraison — dans un dossier à côté de la source : draft.mp4, inserts/NN_MM-SS-D_thème.mp4 + index.md avec les timecodes, la base propre (si nouvelle intro), les images, music.md avec les liens (ne pas intégrer la musique).

Ordre (général)

1. Planification

Charge /motion-plan et suis-le. En sortie — MOTION.md : liste des scènes avec timecodes, méthode choisie, contenu du plan et justification de pourquoi cette méthode illustre cette idée.

Montre le plan à l'utilisateur avant la construction. Construire dix scènes coûte cher ; replanifier après est douloureux. Demande ce qu'il faut enlever, ajouter, où la méthode ne correspond pas à l'idée.

2. Spécifications

Chaque scène du plan a besoin de sa propre spécification image par image — le sous-agent ne doit pas deviner. Mets-la dans <projet>/SPEC.md dans le dossier de la scène. Le format de la spécification est dans /motion-plan, section « Spécification de scène ».

Crée un dossier-projet séparé pour chaque scène. Les sous-agents travaillent en parallèle, check vérifie le projet entier, et une composition cassée du voisin gênera.

Crée le modèle une fois, puis duplique-le par copie :

./node_modules/.bin/hyperframes init _template --example blank --non-interactive --resolution landscape --skill motion-graphics

Copie dans le modèle le dossier assets/ de la compétence motion-build entièrement (.claude/skills/motion-build/assets/) — tokens.css charge les polices via @import, et la structure des répertoires doit correspondre :

cp -R .claude/skills/motion-build/assets/. _template/assets/

Ensuite, une copie par scène :

for name in scene-01 scene-02 scene-03; do cp -R _template "$name"; done

2b. Construis toi-même une scène étalon

Avant la distribution, choisis une scène — de préférence de difficulté moyenne, avec un nombre ou une paire de cartes — et construis-la toi-même jusqu'au rendu. Cela prend dix minutes et résout trois problèmes à la fois :

  1. Vérifie le pipeline. Si init, tokens, polices ou rendu butent quelque part, tu le sais une fois, pas avec neuf rapports identiques.
  2. Définit les constantes transversales de la vidéo. Tailles de police, cadence de composition, mécanique de fond, dérive, entrée en deux étapes — tout cela doit être identique dans toutes les scènes, alors que par défaut chaque constructeur choisit le sien. Le système de design définit des plages, pas des nombres.
  3. Donne aux constructeurs un exemple, pas une description. Lire une scène prête de la même vidéo est bien plus fiable que de relire les mêmes règles dans des manuels.

À côté, mets un court fichier de constantes transversales (BUILD-BRIEF.md) et dans la mission de chaque sous-agent indique à la fois ce fichier et le chemin vers la composition étalon : « lis ins-b2/index.html — d'elle héritent la typographie, le rythme, le fond et la structure de la timeline ; seul le contenu change. »

Le brief doit contenir : un tableau de tailles de police avec des nombres concrets, la palette et les substitutions de couleur interdites, la mécanique de fond et du travelling permanent mot pour mot, la règle du plan 0, les cadences de composition, la liste des interdictions du moteur, les coordonnées du keep-out de l'ancre transversale et les commandes du pipeline.

Testé sur une vidéo de neuf scènes : neuf constructions indépendantes sont sorties visuellement d'un seul système, un passage d'alignement après le rendu n'a pas été nécessaire.

3. Distribution

Lance les sous-agents d'un seul message, tous en même temps — ils travaillent en parallèle, et c'est bien plus rapide qu'une construction séquentielle.

Dans la mission de chacun :

  • répertoire de travail — seulement sa scène, ne pas toucher aux autres ;
  • lire SPEC.md, puis charger la compétence motion-build et la suivre ;
  • regarder les plans avec les yeux via Read, pas seulement lancer check ;
  • rendre le MP4 et le laisser dans renders/ de son projet, sans le copier ailleurs ; ne pas supprimer le dossier de travail ;
  • retourner brièvement : ce qui a été fait, le chemin vers le MP4, ce qui était difficile, ce qui reste imparfait.

Demande impérativement de nommer les écarts avec la spécification. C'est toi qui écris la spécification sans voir les plans ; le sous-agent voit les plans. Ses corrections sont la partie la plus utile du rapport.

Huit scènes en une vague passent bien — le rendu prend des secondes, le temps principal est consacré à l'authoring, et la machine n'est pas bridée là-dessus. Divise en vagues quand il y a plus de dix scènes : ce qui devient lourd, ce n'est pas la machine, c'est l'analyse des rapports.

À propos de la collecte des résultats, conviens-en à l'avance. Sans indication explicite, les constructeurs placent les MP4 n'importe où : dans renders/, dans un output/ commun, dans le dossier de CLAUDE.md, parfois dans deux à la fois « pour que l'orchestrateur trouve sûrement ». Une fois, cela a coûté une recherche des rendus avec find sur tout le disque. La règle est simple : chacun laisse le fichier dans son renders/ et nomme le chemin dans le rapport, c'est toi qui répartis par noms et timecodes lors de la livraison.

4. Validation

Pour chaque scène, prends des plans toi-même et regarde-les :

cd scene-01 && ../node_modules/.bin/hyperframes snapshot . --frames 8 -o review

Lis review/contact-sheet.jpg via Read. Ne te fie pas à la planche-contact jointe par le sous-agent : elle peut provenir de l'itération précédente.

Sur quoi regarder en priorité, d'après l'expérience :

  • Échelle. Le problème le plus fréquent : texte à 40px là où il faut 54, icônes à 90px tout près des bords.
  • Plan vide. Surtout juste après le mouvement le plus coûteux — la méthode n'a pas où atterrir.
  • La méthode existe formellement mais ne se lit pas. Le remplissage se fond imperceptiblement, la couture ressemble à un fondu enchaîné, la perspective n'est pas visible sur un statique.
  • Artéfacts. Anneaux de banding sur les dégradés, pollution chaude au milieu du changement de couleur, marqueur qui s'arrête au milieu d'un mot.
  • Hiérarchie. Un élément de service (marque, kicker) ne doit pas peser plus que le message.

Envoie les corrections via SendMessage au même agent — il a tout le contexte de la scène, un relancement coûte plus cher. Dans la correction, dis ce qu'il ne faut pas toucher : sinon l'agent reconstruit ce qui est déjà bien.

Valide la scène quand la validation se lit sur les plans, pas quand check est vert.

5. Assemblage brut — étape obligatoire

Ne livre pas un dossier de fichiers sans en avoir fait une maquette. Une partie des échecs n'est visible que sur la vidéo assemblée et est invisible scène par scène — peu importe combien de scènes tu valides individuellement, le tout n'est pas vérifié par elles.

assemble les MP4 finis dans un dossier avec des noms de type NN_MM-SS-D_méthode.mp4 (le timecode dans le nom — c'est de lui que le script tire la position), puis :

python3 <chemin-vers-la-compétence>/scripts/assemble.py --root <dossier-de-travail> \
    --source m1=~/Desktop/part1.mp4 --source m2=~/Desktop/part2.mp4 \
    --anchor 1245,690,650,345

L'incrustation remplace l'image sur sa durée, le son de la source est continu, le chronométrage ne change pas, les jonctions sont nettes.

--anchor — concerne l'ancre transversale, et c'est l'essentiel à cette étape. Si la source contient une caméra-PiP ou un autre élément permanent, l'incrustation plein écran le supprime : le locuteur disparaît du plan à chaque incrustation et réapparaît. Vingt fois dans une vidéo, cela désintègre le montage en diapositives séparées et viole directement la loi 16. Le drapeau superpose la zone de l'ancre sur toutes les incrustations à la fois.

Mesure les coordonnées de l'ancre sur un plan de la source, ne les devine pas : extrais une image (ffmpeg -ss 300 -i src.mp4 -frames:v 1 f.png), regarde-la et prends le rectangle. La position peut différer entre les parties — vérifie chacune.

6. Validation de l'assemblage

Prends des plans de la maquette et regarde-les : points à l'intérieur des incrustations, entre elles, et impérativement la jonction des parties. Sur quoi regarder :

  • l'ancre ne disparaît pas sur les incrustations ;
  • les incrustations sont à leurs timecodes, pas décalées ;
  • le son ne se coupe pas aux limites ;
  • à la jonction des parties, il n'y a pas de saut de luminosité ou de volume ;
  • deux scènes d'une même méthode consécutives ne se lisent pas comme un seul plan deux fois.

7. Livraison

Donne à l'utilisateur la maquette plus un tableau : timecode, fichier, durée, ce qu'il montre — pour qu'il puisse remplacer n'importe quelle incrustation dans son montage sans tout reconstruire.

Si les scènes sont nombreuses et que tu veux tout montrer d'un coup — crée une page avec des aperçus et publie-la comme artefact. Compresse la vidéo à 1280px / CRF 30 et intègre-la comme data-URI : dix scènes tiennent dans environ 1,5 Mo, la limite d'artefact est de 16 Mo.

ffmpeg -y -i in.mp4 -vf scale=1280:-2 -c:v libx264 -preset slow -crf 30 -pix_fmt yuv420p -an out.mp4

Ce qu'il ne faut pas faire

Ne construis pas toi-même plus de deux scènes. Le sens de l'orchestration est que ton contexte reste propre pour la validation. Si tu construis trois scènes à la main, tu cesseras de remarquer les défauts de composition à la quatrième.

Ne valide pas sur rapport. Le rapport du sous-agent dit ce qu'il a fait, pas à quoi cela ressemble. Regarde les plans.

Ne réécris pas le plan en cours de route. Si pendant le processus il devient clair que la méthode est mal choisie, dis-le à l'utilisateur et corrige MOTION.md, ne construis pas autre chose en silence.

Ne considère pas le travail fini avec un dossier de MP4. Tant que la maquette n'est pas assemblée, tu ne sais pas à quoi cela ressemble ensemble : ancre qui disparaît, timecodes décalés, deux scènes identiques à la suite — tout cela se découvre seulement sur l'ensemble.

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

sstani-bgv/montage-skills

Собрать ОДНУ анимационную вставку для видео на HyperFrames + GSAP в стиле канала. По умолчанию — стиль v4 «презентация с картинками» (одобрен автором как эталон, два русскоязычных YouTube-референса): крупные слова в интро, спикер + достраивающаяся панель, сгенерированные Codex 3D-картинки-метафоры, звук на каждое появление графики. Светлая тема, Onest/Unbounded; как акценты — приёмы вроде PiP-морфа, rack-focus, карусели глав, velocity-matched швов, zoom-through, перспективного свопа окон, каскадов с бэйджами. Используй этот скилл всегда, когда нужно собрать, починить или доработать отдельную анимацию/сцену/motion-вставку по готовой спеке, когда сабагент получил задание на одну сцену из motion-плана, а также когда речь идёт о HyperFrames-композиции для ролика в этом стиле. Не для планирования всего ролика — это /motion-plan, и не для оркестрации — это /motion-run.

sstani-bgv/montage-skills

Разметить motion-план для ролика (по умолчанию в стиле v4 «презентация с картинками»: kinetic-интро, спикер + достраивающаяся панель, картинки-метафоры, звук) — посмотреть транскрипт, скрипт или само видео и решить, в каких местах и какими приёмами визуально показать то, что автор проговаривает голосом. На выходе MOTION.md с таймкодами, выбранными приёмами и покадровыми спеками на каждую сцену. Используй этот скилл всегда, когда нужно понять, где в ролике нужны анимации, какие именно и почему, когда пользователь даёт транскрипт или ссылку на своё видео и спрашивает, что тут анимировать, а также когда надо переразметить уже существующий план. Сборкой занимается /motion-build, оркестрацией — /motion-run.

Skills associés