Communitygithub.com

montage-film

Transformez des plans approuvés en un film fini selon la volonté du cinéaste - journalisez la footage, transformez les notes de montage en liste de décisions de montage, assemblez dans l'ordre de la table de plans, coupez et rythmez sur les fins de phrases, les pauses et les temps forts, exécutez des recettes ffmpeg testées (coupe, assemblage, recadrage, vitesse, contact sheets, sous-titres), remettez la timeline à un éditeur en FCPXML, créez et traduisez des sous-titres, corrigez les clips finis, upscalez en dernier et construisez les fichiers de livraison avec mention de l'IA et crédits ; téléchargez uniquement sur demande, privé par défaut.

Qu'est-ce que montage-film ?

Cette compétence permet à un agent IA d'assister un cinéaste dans le montage d'un film à partir de clips approuvés. Elle fonctionne comme un assistant de montage : l'agent assemble, mesure, propose et rend, mais c'est le cinéaste qui décide quoi garder, couper ou réorganiser. Elle gère l'ensemble du flux de travail : journalisation de la footage, application des notes de montage sous forme de liste de décisions de montage (EDL), assemblage dans l'ordre des plans, coupe rythmée sur les fins de phrases et les beats musicaux, exécution de commandes ffmpeg testées pour le trimming, l'assemblage, le recadrage, le changement de vitesse, la création de contact sheets et l'incrustation de sous-titres. Elle exporte également la timeline au format FCPXML pour passer le relais à un éditeur professionnel, crée et traduit des sous-titres en conservant le timing (SRT, VTT, ASS), upscale les clips un par un après le verrouillage du montage, et génère les fichiers de livraison avec les mentions obligatoires sur l'utilisation de l'IA, les crédits et le registre des droits. La compétence est conçue pour être utilisée avec des assistants comme Claude Code ou Cursor, et fonctionne sur n'importe quel système disposant de ffmpeg. Elle respecte des règles strictes : ne jamais écraser ni supprimer (chaque version est numérotée), demander avant toute dépense (transcription cloud, upscaling payant), conserver un journal de production complet, et marquer chaque clip comme réel ou généré pour la transparence. Les domaines exclus sont le motion design (titres, animations), le son (narration, mixage) et l'étalonnage, qui relèvent d'autres compétences.

Compatible avec~Claude Code~Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/nikbearbrown/agentic-filmmaking/tree/HEAD/skills/film-edit

Demander à votre IA préférée

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

Documentation

Montage film

Le cinéaste coupe ; l'agent tient la timeline. Cette compétence transforme des plans approuvés en un film fini, honnêtement étiqueté. Le travail est en ffmpeg pur : les commandes testées se trouvent dans ffmpeg-recipes.md, et le journal de footage, la liste de décisions de montage, le journal de production, la checklist de livraison, le modèle de crédits et un squelette FCPXML sont dans edit-sheets.md.

Règles pour chaque étape

  • Le cinéaste dirige ; l'agent exécute. L'agent assemble, mesure, propose et rend. Ce qui doit être gardé, coupé, maintenu, échangé ou réordonné est la décision de l'utilisateur. Lorsqu'un choix est ouvert (quelle prise, recadrer à gauche ou à droite, accélérer ou couper), présentez les options avec ce que chacune coûte.
  • Le +1, c'est l'intention, pas le goût. Si la coupe s'écarte de ce que l'utilisateur a dit vouloir (une note qui n'a pas pu être appliquée exactement, un temps fort qui a perdu sa réaction), signalez-le une fois, laissez l'utilisateur décider et enregistrez la décision. Votre préférence n'est pas un écart.
  • Ne jamais écraser, ne jamais supprimer. Chaque passage écrit un nouveau fichier numéroté (cut-v4.mp4) ; les sources sont en lecture seule. Utilisez -n de ffmpeg (refuser d'écraser), pas -y, sauf si l'utilisateur a demandé que ce fichier exact soit remplacé. Les anciens montages, les mauvaises prises et les clips remplacés vont dans un dossier superseded.
  • Demandez avant de dépenser et avant de publier. Avant toute étape payante (transcription cloud, rendu génératif, upscaler payant), indiquez l'outil, le nombre et le coût estimé, et attendez un oui. Un nouveau rendu après un résultat rejeté est une nouvelle dépense : redemandez. Le silence n'est pas un oui.
  • Droits et consentement. Les images, la musique et les voix qui ne sont pas celles de l'utilisateur nécessitent des droits ; l'apparence ou la voix d'une personne réelle nécessite son consentement. Télécharger la vidéo de quelqu'un d'autre nécessite l'autorisation du propriétaire ou une licence ; un avertissement de conditions d'utilisation n'est pas une permission, alors attendez la réponse de l'utilisateur.
  • Tenez un journal de production : chaque version, les notes appliquées, les décisions de l'utilisateur, et pour chaque étape payante, l'outil, l'ID de travail et le coût. Enregistrez un résultat généré comme conservé uniquement une fois que l'utilisateur l'approuve.

Limites de cette compétence

  • Titres, tiers inférieurs, typographie cinétique, sous-titres animés ou mot par mot, flèches et cartes dessinées en code : motion-graphics. Cette compétence place leur rendu par-dessus le montage propre.
  • Narration, dialogue, musique, effets, le mix et la loudness : film-sound. Cette compétence place le mix livré sous l'image verrouillée.
  • Plans, images fixes et clips : cinematic-shots, y compris un plan manquant dans la couverture.
  • Pas encore couvert : l'étalonnage. Laissez la couleur telle que générée, sauf si l'utilisateur le demande.

1. Sondez et journalisez la footage avant de couper

Sondez avant de planifier : durée, fréquence d'images (r_frame_rate différent de avg_frame_rate signifie un débit variable), taille, forme des pixels et format, pistes audio. Les clips générés diffèrent souvent d'un plan à l'autre, et certains n'ont pas de son.

Journalisez chaque clip en tant qu'observateur, pas en tant que réalisateur : numéro de plan, fichier, ce qui est dans le cadre, points d'entrée et de sortie utilisables, où les lignes et actions complètes commencent et finissent, le moment qui porte le temps fort, problèmes rencontrés. Gardez ce que vous avez vu séparé de ce que cela pourrait signifier ; écrivez "incertain" plutôt que d'inventer une histoire. Les mesures sont des candidats, pas des verdicts :

  • Une planche contact de plusieurs images par clip, étiquetées avec les temps. Une image cache un objet fantôme ou un visage qui dérive.
  • Candidats aux changements de scène. Les mouvements, flashs et fondus aussi ; vérifiez chacun à vitesse normale.
  • Fenêtres de silence, où les coupes peuvent atterrir. Un écart dans une transcription n'est pas une preuve de silence.
  • Images perdues : écarts de temps supérieurs à une image et demie.
  • Parole : pour un long enregistrement, lisez d'abord la transcription, puis extrayez les images uniquement là où l'image compte.

2. Assemblez dans l'ordre de la table de plans

Le premier montage est mécanique : les plans approuvés dans l'ordre de la table de plans, chacun à ses points d'entrée et de sortie journalisés. C'est un brouillon que l'utilisateur regarde.

  1. Normalisez chaque clip à un seul format : taille, pixels carrés, fréquence d'images, format de pixels, débit audio et canaux. Donnez à un clip sans son une piste silencieuse. Quand l'aspect diffère, l'ajustement (barres) ou le remplissage (recadrage) est le choix de l'utilisateur.
  2. Assemblez par copie de flux lorsque chaque morceau correspond exactement, sinon avec le filtre concat (un ré-encodage). Comparez les durées vidéo et audio après assemblage.
  3. Ré-encodez aussi peu de fois que possible : intermédiaires de haute qualité, un encodage de livraison à la fin.
  4. Conservez le son de chaque clip (gardez la piste ambiante du modèle vidéo ; son nivellement est le travail de film-sound).
  5. Numérotez la version, journalisez-la, faites une planche contact.

3. Les notes de montage deviennent une liste de décisions de montage

L'utilisateur regarde et tape des notes dans ses propres mots : couper, échanger, maintenir, couper, déplacer. Chaque note devient une ligne d'une liste de décisions de montage (EDL) : numéro de note, les mots de l'utilisateur textuellement, plan, entrée et sortie source, action, raison, statut. Les temps restent en secondes source ; tout ce qui se trouve sur la timeline de sortie (narration, sous-titres, marqueurs) est re-timing après chaque recoupe.

  • Demandez quand une note est ambiguë ("resserrer le milieu") : proposez deux lectures concrètes avec des timecodes.
  • Donnez une raison à chaque ligne : le temps fort qu'elle sert, pourquoi elle entre et sort là. Gardez le moment qui fait atterrir le temps fort, pas tout l'événement.
  • Listez les moments à ne pas couper (une question et sa réponse, une réaction, un aboutissement) ; après tout changement de limite automatique, vérifiez qu'ils sont complets et dans l'ordre.
  • Pour le dialogue, montrez la transcription complète numérotée avec les temps et demandez quoi supprimer, avant que les graphiques soient synchronisés sur le montage. Quand une phrase est dite deux fois, la prise suivante est souvent la correction ; demandez avant de supprimer l'une ou l'autre.
  • Appliquez, rendez une nouvelle version, journalisez les notes et les décisions. Répétez jusqu'à ce que l'utilisateur dise que le montage est à lui.

4. Coupe et rythme

Coupez sur les fins de phrases et les pauses. Un point d'entrée ou de sortie appartient à un silence mesuré, en tête de la source, ou à une jonction continue dans une même prise. Si une limite tombe encore dans la parole, déplacez-la ou supprimez toute la phrase ; ne coupez jamais un mot pour atteindre une durée. Coupez le vide au milieu d'une pause pour que les deux côtés gardent une respiration. Donnez aux jonctions non continues un très court fondu audio pour éviter un clic. Demandez avant de supprimer les pauses d'un locuteur volontairement lent.

Évitez les images flash : fragments d'une ou deux images laissés quand une limite atterrit à côté d'une coupe franche dans la source. Déplacez la limite ou supprimez le fragment ; n'étirez pas un plan court avec un arrêt sur image ou un ralentissement, et ne cachez pas une mauvaise coupe sous une transition.

Objectifs de durée. "Faites-le durer 60 secondes" par vitesse et par coupe sont des réponses différentes (la vitesse modifie tous les mouvements et voix ; la coupe perd du matériel). Montrez les deux.

Adapter l'image à la narration (côté image) : quand une ligne narrée dépasse la durée de son plan, ralentissez ce clip d'au plus 10 % et laissez le reste déborder dans le plan suivant. Sur un film, 7 des 25 plans en avaient besoin. Gardez la fréquence d'images constante après tout changement de vitesse, pour que le clip corresponde toujours aux autres pour l'assemblage.

Couper sur le beat. Obtenez les temps de beat de la musique approuvée comme une liste de secondes (de film-sound, ou d'un détecteur de beat exécuté sur la piste). Proposez le moment le plus fort de chaque clip, accrochez les coupes au beat le plus proche, et montrez une feuille de plans numérotée avant d'assembler. Là où un beat et une fin de phrase sont en désaccord, montrez les deux et laissez l'utilisateur choisir.

5. Corrections d'effets sur les clips finis

Travaillez par ordre de coût et gardez l'original à côté de chaque correction.

  • Corrections gratuites qui conservent les pixels d'origine : recadrage, vitesse, arrêt sur image, remplissage des images perdues par interpolation, léger débruitage.

  • Les incrustations ne vont jamais dans une image générée. Les flèches, itinéraires, étiquettes et grilles sont dessinés par motion-graphics par-dessus le clip propre. Si un clip généré en a une incrustée, régénérez-le propre plutôt que de peindre par-dessus.

  • Un nouveau rendu génératif est un nouveau plan, pas une correction. Les modèles de vidéo de référence utilisent l'original comme guide pour le mouvement et l'apparence, pas comme pixels verrouillés, donc les visages, accessoires et mouvements de caméra peuvent dériver. Si l'utilisateur en veut un :

    1. Lisez les images sur tout le clip ; notez ce qui doit rester identique (identité, gestes, mouvement de caméra, cadrage, lumière, objets tenus) et le changement, synchronisé sur son moment.
    2. Là où l'outil le permet, changez d'abord une image fixe et faites-la approuver avant de payer pour le mouvement.
    3. Indiquez le modèle, le nombre et le coût estimé ; attendez un oui.
    4. Vérifiez le résultat par rapport à la source : longueur, parole jusqu'à la fin, bouche qui bouge pendant les derniers mots, visage au début, au milieu, aux jonctions et à la fin, le changement approuvé toujours présent. Signalez un échec comme un échec et proposez une réparation ; n'escaladez pas de vous-même.

    Ce qu'un modèle préserve est quelque chose à tester d'abord sur un plan.

  • Étiquetez chaque plan comme réel ou généré au fur et à mesure ; la mention en a besoin.

6. Sous-titres et légendes

Créez les sous-titres après le verrouillage de l'image et après tout recadrage ; les sous-titres faits avant un recadrage peuvent atterrir hors cadre.

  • Les mots. Si la narration a été écrite en premier, le script est le texte des sous-titres : alignez-le sur l'audio au lieu de le transcrire. Sinon, transcrivez ; un moteur local garde les médias sur la machine, un service cloud les télécharge (demandez d'abord). Les horodatages de reconnaissance sont souvent des fenêtres grossières, pas des temps de mots ; alignez quand le timing compte.
  • Corrigez en lisant. Les moteurs de reconnaissance confondent le dialecte, les noms et les mots spécialisés. N'ajoutez jamais un mot qui n'a pas été dit, et ne raccourcissez ni ne paraphrasez jamais un sous-titre pour l'adapter : utilisez une taille plus petite ou une autre ligne, ou demandez. Les mots réécrits pour qu'une voix synthétique les dise correctement gardent leur orthographe réelle dans les sous-titres.
  • Un maître, plusieurs formats. Conservez la version la plus riche (temps des mots, locuteurs) et convertissez à partir d'elle : SRT pour le texte et le temps, VTT pour les lecteurs web, ASS pour le style.
  • Traduisez en conservant le timing : le même nombre de repères dans le même ordre, avec les mêmes temps et étiquettes de locuteur ; pas de repères vides ; les étiquettes sonores conservées ; pas de tirets, parenthèses ou crochets que la source n'a pas. Confirmez la langue source si elle n'est pas claire. Les sous-titres qui mettent en évidence chaque mot prononcé doivent être dans la langue de l'audio ; pour une autre langue, utilisez une ligne traduite simple.
  • Incruster ou multiplexer. Les sous-titres incrustés font partie de l'image et ne peuvent pas être désactivés, donc incrustez en dernier, après l'upscaling ; cela nécessite un ffmpeg compilé avec libass. Les sous-titres multiplexés restent activables : une piste par langue, étiquetée avec sa langue. Les plateformes prennent un fichier de sous-titres par langue.
  • Placement : gardez les sous-titres hors des visages et hors des boutons de la plateforme sur les vidéos verticales ; vérifiez ses zones de sécurité actuelles.

7. Upscale en dernier, par clip

Upscalez uniquement après que le montage est verrouillé, chaque clip séparément plutôt que le film assemblé, pour que les coupes ne soient pas maculées. Reconstruisez le montage à partir des clips upscalés avec la même EDL, puis ajoutez sous-titres et graphiques pour que le texte reste net. L'upscaling IA convient aux images photographiques ; sur une série de films, il a dégradé l'art vectoriel plat. Demandez avant tout upscaler payant.

8. La visualisation finale

Vérifiez le fichier que vous allez livrer, pas une version antérieure, un proxy ou un master sans sous-titres.

  1. Lisez-le une fois à vitesse normale sans vous arrêter pour corriger ; notez ce que vous remarquez.
  2. Lisez chaque jonction, une demi-seconde à une seconde de chaque côté, à vitesse normale.
  3. Écoutez une fois sans l'image.
  4. Revoyez le début, le moment clé et la fin.
  5. Sur une révision, confirmez que chaque changement demandé a eu lieu et que rien d'autre n'a bougé.
  6. Ensuite, sondez les nombres, exécutez un passage de décodage, vérifiez les pistes de sous-titres et faites une planche contact de chaque plan.

Les feuilles et les vérifications automatiques pointent seulement vers les problèmes ; la lecture décide. Si vous ne pouvez pas afficher d'images ou lire des médias, dites-le plutôt que de prétendre avoir effectué une vérification. Corrigez un problème là où il se trouve (le montage, le son, les mots), pas avec l'emballage. Rapportez selon le formulaire en cinq lignes d'edit-sheets.

9. Fichiers de livraison, mention et crédits

  • Demandez où cela va. La destination détermine l'aspect, la longueur, le codec et la loudness. Lisez ses spécifications actuelles et notez la date.
  • Un master, puis un fichier par destination encodé à partir de celui-ci et sondé ; avec eux, les fichiers de sous-titres par langue, une transcription, les crédits et la mention, le registre des droits.
  • Mention et crédits : ce à partir de quoi le script a été adapté, quelles images et sons sont générés par IA et lesquels sont réels, et créditer les images, la musique et les voix avec leurs droits. L'agent rédige cela avec des blancs ; l'utilisateur édite et signe. Définissez le drapeau de média synthétique d'une plateforme de manière véridique.
  • Registre des droits : chaque élément externe avec source et licence ; chaque élément généré avec modèle et ID de travail.

10. Remettre la timeline à un éditeur (FCPXML)

Quand l'utilisateur ou son éditeur finira dans un programme de montage, remettez une timeline en plus d'un fichier aplati.

  • Exportez l'EDL au format FCPXML (demandez quel format le programme de l'éditeur importe) plus un CSV de celle-ci. Pointez vers les clips originaux par chemin absolu ; listez les médias manquants.
  • Le temps est en images sur la fréquence d'images (72/24s), jamais une décimale arrondie. offset est la position sur la timeline, start le point d'entrée dans la source, duration la durée. Les marqueurs sont des enfants du clip qu'ils marquent et peuvent porter les notes de montage. Le spine est l'histoire principale ; les clips connectés se trouvent sur des pistes, positives au-dessus, négatives en dessous. Un bundle .fcpxmld est un dossier avec des données accessoires ; gardez-le entier.
  • Ne modifiez jamais le fichier de l'éditeur en place : écrivez une nouvelle version et listez ce qui a changé.
  • Écrire le fichier n'est pas l'importer. Importez d'abord un petit test ; l'importation est l'étape de l'utilisateur.

11. Téléchargement : demandez d'abord, privé par défaut

  • La valeur par défaut est un paquet que l'utilisateur télécharge : fichier, sous-titres, titre, description, tags, couverture, mention.
  • Téléchargez uniquement sur demande de l'utilisateur, par plateforme, en privé ou en brouillon. Une sortie publique ou programmée nécessite que l'utilisateur nomme la plateforme, le fichier et l'heure. "Postez-le partout" n'est pas cette approbation : listez l'action prévue de chaque plateforme (fichier, titre, visibilité, heure) et confirmez.
  • Une plateforme à la fois. Sur un écran de connexion, un code de vérification, un captcha ou un avertissement de sécurité, arrêtez-vous et passez la main. Ne tapez jamais de mots de passe ou de codes, et ne lisez ni ne répétez d'identifiants.
  • Ensuite, relisez le titre, le début de la description, les sous-titres, la visibilité et le réglage des médias synthétiques. Le succès est un ID vidéo plus un état de traitement ; un échec de connexion ne l'est pas.

… [tronqué pour la traduction]

Individual skills in this repo

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

cinematic-shots

Take a screenplay or scene to shots an image or video model can make, with the filmmaker making every creative call. Covers notes on the script, the screenplay-to-shot-table conversion, look rules written once and pasted into every prompt, keeping characters, places and props consistent with reference sheets, cheap draft stills before paid hero stills, checking every still before any motion, image-to-video prompts with one action and one gentle camera move, checking several frames per clip, the cost order, a per-session spending cap, and cost and production logs. Use when the user says "shot table", "shot list", "break down this scene", "storyboard", "look rules", "keep the character consistent", "character sheet", "draft stills", "hero still", "animate this still", "image to video", "camera move", "the clip smears" or "what will this cost". Not for narration, dialogue, music or the mix (film-sound); cutting, captions, upscaling or delivery (film-edit); or titles and graphics drawn in

motion-graphics

Make graphics drawn in code that sit over or between shots - titles and title cards, lower thirds, kinetic type, a stat or animated chart, a map or route, logo stings, transitions, captions styled as graphics, beat-synced graphic videos and explainer animation. Sets the house style once (palette, type, pacing), plans beats against measured narration, music or footage timing, builds deterministic seek-safe animation, inspects stills and several frames, then renders, verifies and composites over clean footage instead of baking graphics into generated shots. Works with any code-rendered video engine. Use when the user says "motion graphics", "title card", "lower third", "kinetic type", "animate this chart", "animated map", "draw the route", "logo sting", "beat-synced video", "explainer animation", "styled captions" or "overlay on this footage". Not for generated photoreal footage (cinematic-shots), narration, music or the mix (film-sound), or cutting, plain subtitles, delivery and upload

Skills associés