Communitygithub.com

alexey1312/Vibe-Editing-Agent-Skill

Utilisez cette compétence lorsque vous souhaitez transformer des rushes filmés en un montage final en dialoguant avec un agent ("vibe editing") : plans de parole, interviews, podcasts, tutoriels ou enregistrements d'écran. L'agent sélectionne les prises, supprime les pauses, les faux départs et les tics de langage, raccourcit ou réorganise la parole, ou découpe un long enregistrement en clips. Il inventorie les sources (tramage variable, rotation, HDR), travaille à partir d'horodatages textuels, rédige une liste de décisions de montage avec les temps sources et sortie pour approbation, rend image par image avec FFmpeg, déplace les sous-titres et les incrustations sur la nouvelle timeline, et planifie le son (fondus aux jonctions, ducking, loudness). Convient également pour choisir l'outil d'édition et décider quels médias peuvent être téléversés. Ne convient pas pour HyperFrames, le code Remotion, les animations graphiques ou les vidéos explicatives sans rushes (hyperframes, general-video, remotion-best-practices), les sous-titres ou incrustations sur des rushes inchangés (embedded-captions, talking-head-recut), ou la vérification d'un rendu final (vibe-editing-review).

Qu'est-ce que Vibe-Editing-Agent-Skill ?

Cette compétence pour agent IA, nommée "Vibe-Editing-Agent-Skill", automatise le montage vidéo de rushes parlés (prises de parole, interviews, podcasts, tutoriels, enregistrements d'écran) via un dialogue avec l'utilisateur. Elle se distingue par son approche centrée sur le sens avant le graphisme : l'agent propose un plan de montage, l'utilisateur approuve, puis le rendu est effectué. Le processus suit des phases strictes : Phase 1 (lecture seule) pour l'inventaire des sources, la détection des problèmes (variable frame rate, rotation, HDR) et la rédaction d'un plan avec une EDL (Edit Decision List) contenant les temps sources et de sortie. Phase 2 pour l'application des décisions approuvées et le rendu image par image avec FFmpeg, incluant le déplacement des sous-titres et incrustations sur la nouvelle timeline, et la gestion audio (fondus, ducking, loudness). L'agent ne modifie jamais les fichiers originaux et exige une approbation explicite pour toute action coûteuse ou destructive. La compétence est conçue pour être utilisée avec des outils comme Claude Code, Cursor, Codex, etc., et s'intègre avec des scripts Python (toolchain_report.py, media_probe.py, edl.py, captions.py) pour l'analyse et le rendu. Elle garantit la précision image par image, évite les coupes par stream-copy non exactes, et vérifie la conformité avec des checks comme qa_scan.py. Les graphismes (animations, titres) sont délégués à d'autres compétences (HyperFrames, Remotion).

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/alexey1312/Vibe-Editing-Agent-Skill/tree/HEAD/skills/vibe-editing-cut

Demander à votre IA préférée

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

Documentation

Vibe editing : le montage

Transformez les rushes bruts en un montage qui conserve le sens, puis confiez-le au moteur pour les graphismes. L'agent propose et écrit ; le moteur de rendu calcule les images ; l'auteur décide et approuve. Approuvez l'histoire avant le design : tout changement de sens après les graphismes force une reconstruction.

  • Itinéraires et outils par type de contenu : references/routes.md
  • L'EDL et les deux horloges : references/edl-format.md
  • Transcriptions et reconnaisseurs : references/transcripts.md
  • Couper la parole : references/cutting.md
  • Sous-titres : references/captions.md
  • Son : references/audio.md
  • Incrustations, layouts, 9:16, autres langues : references/inserts-and-layouts.md
  • Enregistrements d'écran : references/screen-recordings.md
  • Dossier, brief et project.md : references/project-memory.md
  • Notes de l'auteur : references/edit-requests.md
  • Données, licences et argent : references/data-and-licences.md
  • Format du plan : references/plan-format.md
  • Ce que ce dépôt a mesuré : references/measured-behavior.md
  • Versions et dates : references/versions.md
  • Citations : references/sources.md

Contrat

  • La phase 1 est en lecture seule. Le rapport de la chaîne d'outils, l'inventaire des médias, la lecture des transcriptions existantes, et la rédaction du plan ne changent rien et n'envoient rien nulle part.
  • Pas de coupe, rendu, téléversement, installation ou appel payant sans approbation des ID d'éléments (references/plan-format.md). "Raccourcis-le" avant qu'un plan existe est une demande de plan.
  • Les originaux ne sont jamais modifiés. Les copies de travail vont dans work/, les rendus dans renders/, les livrables dans exports/. edl.py render refuse d'écraser une source ou un fichier existant sans --force.
  • Deux horloges. Temps source pour les prises, temps sortie pour tout ce que le spectateur voit ; convertissez avec edl.py map et edl.py retime, jamais à la main.
  • Citez ou étiquetez. Une affirmation sur un outil cite references/sources.md ou une section Mesuré ; les versions et prix proviennent de references/versions.md avec sa date ; un jugement de goût ou de sens est étiqueté comme tel.
  • Rapportez honnêtement la vérification. Une vérification d'image manque le rythme ; un script manque le sens. Dites ce qui a été regardé, écouté, scanné — et ce qui ne l'a pas été.

1. Prévol

python3 scripts/toolchain_report.py --format markdown
python3 scripts/media_probe.py originals/ --format markdown
  • Le rapport de la chaîne d'outils indique ce que cette machine peut faire : rendus image par image, gravure de sous-titres (de nombreuses versions FFmpeg ne le peuvent pas, Mesuré M7), mesure de loudness, reconnaissance vocale locale, HyperFrames, Remotion ; et quels noms de clés API sont définis (jamais leurs valeurs).
  • L'inventaire signale ce qui modifie le montage : tramage variable (MED001), rotation (MED002), HDR (MED010), fréquences d'images ou formats audio mélangés (MED004, MED005) ; règles dans CHECKS.md de ce dépôt de compétence.
  • Lisez les instructions du projet et project.md s'ils existent.
  • Rédigez le brief, ou demandez ce qui manque : spectateur et message, livraison, doit-rester, doit-pas, cloud (references/project-memory.md).

2. Itinéraire

Choisissez l'itinéraire en fonction du contenu et du livrable (references/routes.md). Cette compétence gère le montage : prises, jonctions, l'EDL, le rendu, les sous-titres et le son sur la nouvelle timeline. Les graphismes appartiennent aux compétences du moteur : HyperFrames (hyperframes, general-video, hyperframes-core) ou Remotion (remotion-best-practices). Les sous-titres ou incrustations sur des rushes qui ne doivent pas changer appartiennent à embedded-captions ou talking-head-recut.

3. Transcriptions

  • Horodatages textuels par source, créés une fois, conservés dans transcripts/ (references/transcripts.md).
  • La reconnaissance dans le cloud envoie l'audio et coûte de l'argent ; la reconnaissance locale nécessite une installation. Les deux attendent une approbation, avec le fournisseur, le coût et les données nommés dans le plan.
  • Corrigez les noms et les nombres par rapport à un glossaire avant de planifier toute coupe.

4. Planifiez l'histoire

  1. Tableau du contenu : source, entrée–sortie, phrase textuelle, son, ce qui est visible, rôle possible.
  2. Trois ouvertures, chacune avec ce que le spectateur comprend dans les premières secondes.
  3. Candidats : python3 scripts/edl.py candidates --words transcripts/<prise>.json — pauses, répétitions et tics de langage à considérer, jamais à couper automatiquement (references/cutting.md).
  4. L'histoire en séquences, puis edit/edl.json : chaque clip avec une raison (references/edl-format.md).
  5. python3 scripts/edl.py check edit/edl.json --probe, table et cuts --probe : les clips avec les deux horloges, et chaque intervalle supprimé pour que l'auteur le lise.
  6. Les coupes douteuses vont dans edit/edl_b.json, pas dans la version A.

5. Rendu de la maquette

python3 scripts/edl.py render edit/edl.json -o renders/draft_v1.mp4 --size 640x360 --preset veryfast
  • Chaque clip est ré-encodé sur les limites d'image, avec des fondus audio de 10 ms, redimensionné à une taille (Mesuré M1, M3, M4). Une coupe par stream-copy n'est jamais exacte image par image (Mesuré M2).
  • La première maquette n'a ni musique, sous-titres ni effets : parole et image seulement.
  • Écoutez chaque jonction au casque ; regardez les images de chaque côté. Corrigez avec des notes précises (references/edit-requests.md) et une nouvelle version de l'EDL.

6. Sous-titres, son, incrustations

  • Sous-titres : edl.py retime déplace les horodatages textuels sur la timeline de sortie ; captions.py build les groupe ; captions.py check applique les limites (references/captions.md).
  • Son : la parole d'abord, puis la musique avec ducking, puis les effets ; mesurez la loudness par rapport à la cible du brief et définissez les cibles loudnorm explicitement (references/audio.md).
  • Incrustations : marquez-les sur la timeline de sortie (edl.py map), approuvez une image fixe, puis construisez-les dans le moteur ; edl.py hyperframes et edl.py remotion transfèrent le montage (references/inserts-and-layouts.md).
  • Autres formats : une version 9:16 est un nouveau layout, pas un recadrage central.

7. Transfert

  • Lancez la révision avant de déclarer la vidéo terminée : la compétence vibe-editing-review, ou au moins python3 scripts/qa_scan.py avec le brief, l'EDL et les sous-titres.
  • Mettez à jour project.md : version approuvée de l'EDL, dernier bon rendu, commandes, ressources et licences, défauts ouverts.

Flux de travail

Phase 1 — Recommander

  1. Prévol : rapport de la chaîne d'outils, inventaire, brief, instructions du projet.
  2. Plan avec references/plan-format.md : sources et conversions ; l'histoire et l'EDL v1 ; intervalles supprimés ; coupes douteuses ; sous-titres, son et incrustations ; données, argent et licences ; ce qui ne peut pas être vérifié ici.
  3. Demandez quels ID d'éléments appliquer.

Phase 2 — Appliquer et vérifier

  1. Appliquez uniquement les éléments approuvés, un niveau à la fois : histoire, rythme, texte, image, son.
  2. Après chaque changement, effectuez un rendu ou un aperçu de la même plage avec une seconde de contexte, et écoutez.
  3. Relancez edl.py check et captions.py check ; lancez qa_scan.py sur chaque maquette envoyée à l'auteur.
  4. Mettez à jour les statuts des éléments et project.md ; rapportez ce qui n'a pas été vérifié.

Garde-fous

  • Ne coupez pas, ne faites pas de rendu, ne téléversez pas, ne transcrivez pas dans le cloud et n'installez rien en Phase 1.
  • Ne modifiez pas et ne ré-encodez pas les fichiers dans originals/.
  • Ne faites pas de copie par stream-copy pour une coupe qui doit être exacte image par image.
  • Ne placez pas de sous-titres ou d'incrustations par temps source.
  • Ne supprimez pas chaque pause avec un seul seuil, et ne synthétisez pas un mot manquant sans la décision de l'auteur.
  • N'imprimez pas une clé ou un jeton dans le chat, un journal ou un fichier.
  • N'ajoutez pas de musique, polices ou rushes sans source et licence enregistrées.
  • N'empiétez pas sur le terrain du moteur : le code de composition appartient aux compétences HyperFrames ou Remotion.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Skills associés