Communitygithub.com

aly shadot.md/video-editing

Planifier et placer des images de coupe (b-roll) sur une vidéo à partir de son premier montage : analyser le montage ligne par ligne, décider quelles lignes nécessitent des images de coupe et quel type de plan, extraire les meilleurs moments d'une bibliothèque de b-roll taguée, lister ce qui reste à filmer, puis placer le b-roll une fois que le monteur approuve. Utilisez-le après qu'un premier montage existe et que quelqu'un souhaite ajouter du b-roll, demande de quel b-roll la vidéo a besoin, ou demande une liste de plans de b-roll.

Qu'est-ce que video-editing ?

Cette compétence permet de planifier et placer automatiquement des images de coupe (b-roll) sur une vidéo à partir de son premier montage. Elle est conçue pour les agents IA comme Claude Code et Runneth. L'agent lit la timeline du premier montage, décide pour chaque ligne parlée quel type de plan montrer, trouve les meilleurs clips dans une bibliothèque de b-roll taguée, et place les clips aux bons endroits une fois que le monteur approuve le plan. La priorité est donnée aux plans littéraux (montrer exactement ce qui est dit), à l'utilisation maximale de 1 à 2 secondes par clip, et à l'évitement des répétitions de moments similaires. Le résultat est un montage final où le b-roll s'aligne précisément sur les coupes, en utilisant des numéros d'images plutôt que des secondes pour éviter les sauts involontaires. La compétence génère également une liste de plans qui restent à filmer si la bibliothèque ne contient pas de quoi illustrer certaines lignes.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/alyshadotmd/video-editing/tree/HEAD/skills/broll-selection

Demander à votre IA préférée

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

Documentation

Sélection du B-roll

L'objectif : le bon b-roll sur la bonne ligne, choisi comme le monteur le ferait. Le b-roll remplit deux fonctions : il ajoute du contexte à ce qui est dit et il maintient l'attention du public.

Cette compétence est conçue pour Claude Code et Runneth. Elle lit une bibliothèque de b-roll taguée : un dossier de courts clips plus un index avec une table « Trouver par tag » (chaque tag, puis les clips qui le contiennent). La compétence broll-processing en crée une, et tout dossier de clips avec des tags fonctionne aussi. Placer les clips nécessite ffmpeg ou n'importe quel éditeur vidéo.

Parlez au monteur en termes simples et quotidiens, une idée à la fois.

Avant de commencer : les outils

Dans Runneth, tout est déjà installé : passez cette section.

Dans Claude Code, cette compétence a besoin des outils vidéo gratuits que la compétence video-editing-setup installe. Vérifiez silencieusement que ~/.video-editing-tools/bin/ffmpeg -version fonctionne. Si c'est le cas, utilisez les outils dans ~/.video-editing-tools/bin (ffmpeg, ffprobe, python) partout où cette compétence mentionne ffmpeg, ffprobe ou python3, et continuez. Sinon, suivez d'abord la compétence video-editing-setup, puis revenez ici.

Étape 0 : Assurez-vous que le b-roll est dans la bibliothèque

Cette compétence place des clips à partir d'une bibliothèque de b-roll taguée. Avant de planifier, vérifiez que chaque fichier de b-roll pour cette vidéo est dans la bibliothèque, avec un fichier de tournage. Tout b-roll brut qui n'y est pas passe d'abord par la compétence broll-processing, puis revenez ici.

Étape 1 : Lire le premier montage

  1. Obtenez la timeline du montage : chaque ligne parlée avec son heure de début et de fin dans le montage. Une transcription avec les horodatages des mots fonctionne le mieux.
  2. Lisez ce qui est connu sur le projet : le script et les fichiers de tournage de la marque dans la bibliothèque de b-roll (chaque clip conservé avec ses tags et la raison pour laquelle il a été choisi).

Étape 2 : Décider ce dont chaque ligne a besoin

Pour chaque ligne, écrivez ce qui est dit et le type de plan qui le montre, dans les tags de la bibliothèque. C'est là qu'un clip obtient son sens : le même bâillement peut être le « avant » dans une vidéo et un moment relatable dans une autre. Règles, dans l'ordre :

  1. Planifiez toute la vidéo avant de placer quoi que ce soit. Ne remplissez pas les lignes dans l'ordre. Parcourez d'abord les plans les plus forts et donnez à chacun la ligne qu'il illustre le plus littéralement, puis remplissez les lignes restantes avec ce qui reste. Un plan dépensé tôt sur une correspondance vague ne peut pas être utilisé plus tard là où il correspond exactement (lire au lit va sur « apporte-le au lit avec moi pendant que je lis mon livre », pas sur une ligne antérieure de « routine du coucher »).
  2. Montrez la ligne littéralement. Littéral signifie qu'un spectateur sans le son comprendrait la ligne à partir du seul plan. Une action qui n'est qu'à proximité ne compte pas : gonfler un oreiller est une tâche, pas « se détendre et se relaxer ». « Ça vient d'être livré » reçoit le colis complet non ouvert ; « les ingrédients » reçoit quelqu'un pointant les ingrédients ; « essayer de survivre à la journée » reçoit un visage fatigué, un soupir ou un bâillement.
  3. Faites correspondre le produit au moment. Une livraison signifie le colis complet ; une routine du coucher signifie le produit en cours d'utilisation. Utilisez la forme que le spectateur attendrait à ce stade de l'histoire.
  4. Utilisez la meilleure 1 à 2 secondes d'un long clip. Choisissez la tranche avec le plus d'action : le mouvement principal pour lequel le clip a été filmé (remonter la couverture), jamais les tâtonnements avant ou après. Les gros plans fonctionnent comme des accents courts.
  5. Enchaînez les clips liés en une mini-histoire. Déballer va déchirer le dessus, montrer l'intérieur, en sortir un. Utiliser le produit va ouvrir, verser, mélanger, siroter. Travailler sur le canapé va s'allonger pour une sieste. De courtes tranches d'une seule action placées dos à dos (une demi-seconde pour déchirer le sac, une demi-seconde pour l'ouvrir, une demi-seconde pour sortir un paquet) créent une mini-histoire forte.
  6. Le créateur heureux avec le produit va vers la fin. Utilisez-le près de l'appel à l'action, ou sur toute ligne qui n'est pas visuelle en soi.
  7. Un clip signifie ce que montre l'ensemble de son tournage. Lisez le point du fichier de tournage et le clip complet avant d'en utiliser une tranche. Travailler sur le canapé puis y faire la sieste, c'est quelqu'un qui traverse une journée fatigante ; cela montre une fatigue diurne, donc cela correspond à une ligne « traverser la journée » et jamais à une ligne « allongé au lit la nuit ».
  8. Ne répétez jamais un moment. Deux clips extraits de la même vidéo de b-roll originale ne peuvent pas tous deux aller dans un montage lorsqu'ils montrent le même moment, c'est-à-dire les mêmes tags ou des tags similaires (deux plans fatigués au comptoir, deux bâillements, deux gorgées). Les clips de la même vidéo qui montrent des choses différentes (ouvrir, mélanger, un gros plan du verre) peuvent être utilisés séparément. Lorsqu'une vidéo a deux moments similaires, mettez le plus fort sur la ligne qu'il illustre le mieux et trouvez autre chose pour l'autre ligne, ou laissez cette ligne sur la personne qui parle. Les tranches dos à dos d'une seule action formant une mini-histoire (règle 4) comptent comme une seule utilisation. Empilez une vidéo plutôt que de la disperser. Visez au maximum deux emplacements distincts par vidéo de b-roll dans un montage. Lorsqu'une vidéo a plusieurs bons moments, empilez les moments liés en une mini-histoire à la ligne qui correspond (se mettre au lit avec le chat, puis lire avec la boisson) plutôt que de les disperser dans la vidéo, ce qui semble répétitif. Les gros plans de produit (tout ce qui est tagué closeup:, comme remuer le verre juste devant l'objectif) sont l'exception : ils se suffisent à eux-mêmes comme accents et ne comptent pas dans les deux emplacements d'une vidéo.
  9. Une ligne sans clip qui correspond vraiment reste sur la personne qui parle. Un clip approximatif qui montre quelque chose de différent est pire que pas de b-roll du tout. Ajoutez le plan manquant à la liste à filmer seulement lorsqu'il aiderait clairement la vidéo.

Étape 3 : Extraire les clips

  1. Pour chaque ligne, trouvez les clips correspondants dans la table « Trouver par tag » de la bibliothèque. Les clips de la bibliothèque comportent 1 seconde de marge de chaque côté, alors coupez dans la sélection réelle.
  2. Les clips de style de vie (sans produit) peuvent provenir de n'importe quel tournage de marque. Les clips de produit proviennent uniquement de cette marque.
  3. Lorsque rien dans la bibliothèque ne correspond, la ligne va dans la liste « à filmer » avec une description d'une ligne du plan.

Étape 4 : Montrer le plan au monteur

Montrez un court tableau : numéro de ligne, ce qui est dit, le b-roll (tournage, clip, secondes exactes), et pourquoi. Puis la liste à filmer. Le monteur approuve, échange ou supprime. Les clips sont placés une fois que le monteur dit « go ».

Étape 5 : Placer le b-roll

  1. Coupez chaque tranche approuvée à partir de son clip.
  2. Superposez-la sur le montage à sa ligne, avec l'audio du locuteur en dessous inchangé. Coupez le b-roll aux points de coupe ou dans les écarts entre les mots.
  3. Travaillez en numéros d'images, pas en secondes. Convertissez chaque coupe du montage principal et chaque bord du b-roll en un numéro d'image entier (temps x fréquence d'images, arrondi) avant de placer quoi que ce soit, et activez/désactivez les tranches par numéro d'image. Des temps comme 28,867 s à 30 ips tombent entre les images et laissent une image parasite visible.
  4. Les b-rolls empilés se touchent image pour image. Lorsque deux tranches de b-roll sont côte à côte, la seconde commence exactement au numéro d'image où la première se termine, afin qu'aucune image de la personne qui parle ne s'infiltre entre elles.
  5. Le b-roll près d'une coupe s'aligne sur la coupe. Lorsqu'un bord de b-roll se trouve à moins d'environ 0,3 s (9 images à 30 ips) d'une coupe du montage principal, déplacez ce bord sur l'image de la coupe. Une tranche qui commence au premier mot d'une ligne commence sur la coupe de cette ligne à la place, de sorte que la tête parlante n'apparaisse jamais pendant quelques images avant le b-roll.
  6. Re-vérifiez le montage après le placement : la durée audio correspond à la durée vidéo, chaque tranche de b-roll s'aligne avec sa ligne, et les sous-titres (s'il y en a) se lisent toujours proprement sur les nouvelles images.
  7. Aucun segment de moins d'environ 0,3 seconde. Construisez une liste de chaque bord dans la vidéo finale, coupes du montage principal et bords du b-roll ensemble, en numéros d'images. Chaque segment entre deux bords, tête parlante ou b-roll, fait au moins 9 images à 30 ips. Un segment plus court est un flash et échoue. La détection de scène seule ne les détecte pas, car deux prises de la même personne se ressemblent, donc vérifiez la liste, puis saisissez les images de chaque côté de chaque bord pour confirmer. Mesurez où les coupes du montage principal tombent réellement (l'image avec le plus grand changement d'image près de chaque coupe prévue) plutôt que de vous fier aux temps convertis à partir de secondes.
  8. Transformez les retours du monteur sur le placement en règles générales à l'étape 2 ci-dessus. Réécrivez et combinez les règles au lieu d'en ajouter de nouvelles.

Individual skills in this repo

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

alyshadotmd/video-editing

Turn raw talking-head footage full of repeated takes (one long recording, or several recordings of the same script) into a tight rough cut. Find every take of every line, judge each take on its words, sound and picture, pick the keeper for each line, and either show the editor the picks first or go straight to the cut. The cut is checked so no word is chopped and no pause is left in before anyone sees it. Built for Claude Code and Runneth. Use when someone uploads raw talking-head footage and asks to find the takes, pick the best ones, make a cut list or rough cut it. Triggers: "process my a-roll", "find my takes", "pick the best takes", "rough cut this", "cut list", "edit my talking head", "which take is best

alyshadotmd/video-editing

Turn raw b-roll footage into a tagged, searchable library of short clips. Watch each b-roll video once, tag every useful moment with timestamps, pick the moments worth keeping (the editor picks, or the AI picks on its own if the editor says so), cut only those picks with a 1-second buffer, and learn the editor's taste from their reasons. Use when someone uploads b-roll, asks to tag, bank or label b-roll, or asks to find a kind of shot ("find me unboxing b-roll"). Triggers: "process my b-roll", "tag this b-roll", "bank this b-roll", "b-roll library", "find me unboxing b-roll", "do we have b-roll of", "label my b-roll

alyshadotmd/video-editing

>- Add burned-in captions to a vertical (9:16) talking-head video: exact word timings, one word at a time or short chunks broken by meaning, white outlined Figtree Bold with an optional highlighted word, placed in the safe area clear of the face and the hook headline. Built for Claude Code and Runneth. Use after framing and the headline, when someone asks for captions, subtitles or on-screen words.

Skills associés