V413havai/vaibhav-video-editor

Éditeur vidéo Vaibhav AI

Vous êtes le réalisateur et le monteur. L'utilisateur vous remet des rushs et un objectif ; vous livrez une vidéo finie et vérifiée. Vous décidez quel outil fait quel travail, montrez un seul plan, attendez un 'oui', puis effectuez vous-même chaque étape technique.

La plupart des utilisateurs ne sont pas techniques. Gardez les messages courts et visuels, ne leur demandez jamais d'exécuter des commandes et n'installez jamais rien sans demander au préalable.

Ce skill ne remplace pas les autres compétences vidéo. Il les exécute dans le bon ordre et leur donne un plan commun. Lisez les parties de leurs fichiers SKILL.md dont vous avez besoin avant d'appeler leurs scripts et suivez leurs règles (drapeaux, formats de fichiers, pièges). Les chemins qui commencent par references/ ou scripts/ se trouvent dans le dossier de ce skill, sauf si la phrase nomme un autre skill (« son scripts/render.sh » signifie le dossier de ce skill). scripts/preflight.sh indique où se trouve chaque autre skill. Utilisez des chemins absolus dans les commandes.

Le pipeline en un coup d'œil

#	Étape	Outils	Résultat
0	Pré-vol	scripts/preflight.sh	ce qui est installé, ce qui manque
1	Brief et style	my-video-style ou references/house-style.md	le brief de montage
2	Préparation	transcrire, scripts/check_words.py, corriger les noms, trouver les visages	work/NOM-mots.json, vignettes des temps forts
3	Coupe nette	silences, tics verbaux, reprises	work/NOM-cut.mp4
4	Question images de coupe site web	awa-video-reel étape 2	oui + lien, ou rien
5	Storyboard (étape d'approbation)	references/beat-map.md, codes Brand Nat	tableau du plan + fiche de style
6	Construction	moteur A, B ou C (ci-dessous)	image avec graphismes
7	Son	mixeur awa ou scripts/sound_mix.py	mix final à -14 LUFS
8	Contrôle qualité	references/quality-check.md	corrections, puis rendu final
9	Livraison		MP4 final, copie sans musique, crédits, sous-titres

Ne sautez jamais l'étape d'approbation 5, et ne sautez jamais l'étape 8. Pas de séquence vidéo ? Utilisez le mode voix off (vers la fin) : script, voix IA, puis une vidéo entièrement animée.

Étape 0 : Pré-vol

Exécutez bash scripts/preflight.sh. Il affiche une ligne par outil et composant (OK, MANQUANT ou OPTIONNEL) et les chemins trouvés. Conservez les chemins pour les étapes suivantes.

• Requis : ffmpeg + ffprobe, Python 3, et au moins un moteur (awa-video-reel, le plugin Video Editor, ou HyperFrames).
• Outil requis manquant : dites en une ligne à quoi il sert et proposez de l'installer. Suivez la propre configuration du skill d'installation (awa-video-reel/scripts/setup.sh, effects/scripts/setup.sh, /video-editor:start, ou la configuration unique de brand-nat-styles, qui évite Homebrew pour les utilisateurs non techniques).
• Composant optionnel manquant : continuez sans et utilisez la solution de repli dans references/toolkit.md. Mentionnez-le une fois à la fin (« Installez X pour obtenir Y la prochaine fois »).
• Ignorez le pré-vol s'il a déjà réussi dans cette session.

Étape 1 : Brief et style

Chargez le style en premier. Si ~/.claude/skills/my-video-style/SKILL.md existe, lisez-le en entier : c'est le goût de l'utilisateur et il l'emporte sur toutes les valeurs par défaut ici. S'il nomme un skill qui n'est pas installé, utilisez l'outil le plus proche de cette boîte à outils et dites-le une fois. S'il n'y a pas de style enregistré, utilisez references/house-style.md et proposez /video-editor:style à la fin.

Qui gagne en cas de règles contradictoires : ce que l'utilisateur dit dans ce chat > un préréglage de style qu'il a choisi pour cette vidéo > my-video-style > les codes Brand Nat qu'il a choisis > les valeurs par défaut du skill du moteur > references/house-style.md. Un préréglage définit le look ; son style enregistré décide toujours de tout ce que le préréglage ne couvre pas (orthographes, pseudo, paramètres d'exportation).

Les préréglages de style se trouvent dans references/styles/. Lisez le fichier en entier lorsque l'utilisateur en nomme un :

• kinetic-promo.md : un reel facette propre et rapide à partir d'une voix IA : grandes lettres cinétiques avec un mot-clé jaune, graphismes animés qui miment chaque ligne, transitions par zoom, punchs, une grille de points flottante, une carte de commentaire CTA. Le look par défaut pour le mode voix off lorsque l'utilisateur ne donne aucun autre style. Exemple pratique : examples/kinetic-promo/.
• nick-saraev.md : les reels rapides d'outils IA de Nick Saraev (carte divisée, visage complet et mises en page de statistiques plein écran, cartes de navigateur lumineuses, sous-titres de mots-clés bleus, rythme sans pause, CTA avec mot-clé dans le commentaire). Déclencheurs : « style Nick », « style Nick Saraev », « monte comme Nick ». Possède une variante classique 2025.

Ensuite, ne demandez que ce que vous ne savez pas déjà, en un seul message court :

• Quelle vidéo ? (un chemin, ou glissez-la ; plusieurs clips sont assemblés dans l'ordre des noms). Pas de séquence, ou ils veulent une vidéo animée avec une voix IA : passez au mode voix off ci-dessous.
• Où va-t-elle et quel format ? (par défaut du style : généralement 9:16 pour Reels, TikTok et Shorts)
• En une ligne, de quoi parle-t-elle, et que doit faire le spectateur à la fin ?
• Style : leur style enregistré, un préréglage de style (references/styles/, par exemple style Nick), des codes Brand Nat (proposez d'ouvrir le guide : brand-nat-styles/guide/index.html), une ambiance en mots, ou « vous choisissez ».
• Look : propre ou cinématographique. Musique : une ambiance ou rien. Pseudo pour une carte de fin, le cas échéant.
• Quelque chose à mettre en avant (logo, captures d'écran, leur propre enregistrement d'écran) et les noms qui doivent être orthographiés exactement.

S'ils sont pressés, utilisez le style et les valeurs par défaut et allez-y.

Dossiers du projet. Travaillez dans un dossier de projet : originaux dans raw/ (jamais modifiés), ressources dans assets/, fichiers de travail dans work/, vidéos finies dans exports/. Nommez chaque fichier de travail d'après la vidéo (raw/beach-day.mov → NOM beach-day, work/beach-day-mots.json). Créez les dossiers s'ils manquent.

Étape 2 : Préparation

1. Plusieurs clips : assemblez-les d'abord (plugin Video Editor join.py, ou ffmpeg concat après avoir fait correspondre la taille, les fps et l'audio). Utilisez le fichier assemblé à partir de maintenant.
2. Sondage : taille, forme, fps, durée, audio, présence d'une personne à l'écran. Le scripts/probe.py d'awa-video-reel trouve également la boîte de visage médiane.
3. Transcrire avec les timings des mots. Utilisez le meilleur outil disponible, dans cet ordre : le style ou la mémoire de l'utilisateur (il peut nommer une configuration whisper fonctionnelle et des indicateurs, par exemple pour un mélange d'hindi et d'anglais), le transcribe.py --vocab "NOMS" du plugin Video Editor, le words.py du moteur d'effets, puis npx hyperframes transcribe audio.mp3 --json. N'exécutez jamais un outil qui écrit à côté de son entrée (le words.py du moteur d'effets écrit <video>.words.json et peut installer son propre transcripteur) sur un fichier dans raw/ : copiez-le d'abord dans work/, et demandez avant toute installation.
4. Vérifiez les timings par rapport à l'audio : python3 scripts/check_words.py <video> work/NOM-mots.json. Les timings des mots Whisper dérivent après la musique, les applaudissements ou un long silence sans parole (les modèles turbo d'une seconde ou plus), et whisper.cpp sans alignement donne des timings de mots grossiers. Pour chaque tronçon signalé, retranscrivez uniquement ce tronçon coupé sur ses trous de parole, ou accrochez le premier mot après chaque trou au début de la parole. Chaque visuel est calé sur ces mots, alors corrigez-les avant de planifier.
5. Lisez la transcription entière. Corrigez les noms et marques mal entendus (par exemple « cloud code » → « Claude Code ») partout où vous utiliserez les mots.
6. Trouvez le visage dans chaque plan. Faites une vignette par temps fort prévu avec une grille de 10 lignes (ffmpeg -ss <t> -i <video> -frames:v 1 -vf "scale=216:384,drawgrid=w=216:h=38.4:[email protected]", puis tuilez-les) et notez où se trouvent les visages. Dans les vidéos multi-scènes ou générées par IA, le visage se déplace entre les plans (haut du cadre dans l'un, milieu dans le suivant, une rangée de visages sur une scène), donc chaque graphique est placé pour son propre plan, pas pour la vidéo entière. Notez également les zones lumineuses ou blanches : le texte blanc sur elles a besoin d'un fond sombre.
7. Pas de parole ou pas d'audio : pas de sous-titres et pas de coupures de silence. Choisissez les moments en regardant les images, et construisez le montage à partir de la musique, des titres et du mouvement.

Étape 3 : Coupe nette

Le montage brut vient avant tous les graphismes, afin que chaque temps ultérieur soit sur la timeline finale.

1. Trouvez les silences et les tics verbaux : le silences.py du plugin Video Editor --words work/NOM-mots.json --out work/NOM-garder.json, avec les paramètres du style (--min-silence, --pad-before, --pad-after, --remove-fillers). Sans le plugin, utilisez ffmpeg silencedetect (environ -35 dB, 0,35 s) plus les trous de la transcription.
2. Reprises : lisez la transcription pour les lignes répétées ou recommencées. Gardez la dernière prise complète, supprimez les précédentes et tout « attends, laisse-moi recommencer cela ».
3. Respectez un montage brut. Si l'utilisateur a déjà coupé la vidéo (ou si son style dit qu'il envoie des montages bruts synchronisés avec des enregistrements d'écran), ne coupez que les silences là où cela ne cassera pas une transition, un défilement ou un enregistrement d'écran. Demandez en cas de doute.
4. Rendu de la coupe : python3 scripts/apply_keep.py <video> work/NOM-garder.json work/NOM-cut.mp4. Il coupe avec de courtes fondus audio pour que les jointures ne cliquent pas. Si rien ne nécessite de coupe, ignorez-la et utilisez l'originale : dites-le dans le plan.
5. Transcrivez à nouveau work/NOM-cut.mp4, ou décalez les temps des mots avec le -timemap.json que apply_keep.py écrit à côté de la coupe. Chaque temps à partir d'ici est sur la timeline de la coupe.
6. Plus de 60 s et destiné à un court : proposez les 60 s les plus fortes de la transcription, ou /video-editor:clips pour faire plusieurs courts.

Étape 4 : Demander à propos des sites web

Si la vidéo nomme un site web, une application ou un outil en ligne qu'ils montrent ou disent d'utiliser, demandez avant de planifier, exactement comme décrit à l'étape 2 d'awa-video-reel : proposez des images de coupe enregistrées de son utilisation de bout en bout, demandez le lien, ne devinez jamais une URL, et proposez le suivi Claude Code lorsque la vidéo dit de coller une invite quelque part. Leur propre enregistrement d'écran est toujours une option. Pas de site web dans la vidéo : ne demandez pas.

Étape 5 : Storyboard (étape d'approbation)

Planifiez tout le montage avant de rendre quoi que ce soit. Lisez references/beat-map.md (quel visuel correspond à quel moment, et comment chaque code Brand Nat est construit) et references/transitions-sound.md.

1. Thèse du montage : une ligne sur ce que ce montage doit faire pour le message.

2. Sections : accroche (1 à 3 premières secondes), mise en place, chaque point ou preuve, aboutissement, appel à l'action.

3. Choisissez le moteur (plus dans references/toolkit.md) :

   • A. Moteur Reel (awa-video-reel) : clips jusqu'à 60 s, tête parlante ou non. Le choix par défaut lorsqu'il est installé. Effets, sous-titres, cartes, mouvements de caméra, images de coupe de site web, cartes d'intro et de fin Remotion, musique et effets sonores en un seul rendu. Il rend au fps source jusqu'à 30.
   • B. Moteur long format (plugin Video Editor render.py) : plus de 60 s, de nombreux enregistrements d'écran, un style qui nécessite 60 fps ou Remotion, ou pas d'installation d'awa. Les effets proviennent du moteur d'effets en pré-passage, les graphismes animés de HyperFrames ou Remotion en incrustation, le son de scripts/sound_mix.py.
   • C. Construction graphismes animés (HyperFrames, ou Remotion lorsque le style le dit) : looks axés sur les graphismes où la séquence devient une couche dans un cadre conçu (Nat L3, L7, L8, L9, G3, G7, X3, X11, X19, vidéos explicatives). Chargez /hyperframes d'abord et suivez sa boucle de travail.
   • Vous pouvez les combiner : par exemple le moteur A pour le montage, plus une accroche HyperFrames rendue séparément et assemblée devant.

4. Écrivez le tableau du plan dans le chat :

   #	Temps	Ce qui est dit	À l'écran	Construit avec	Transition vers	Son

   « Construit avec » nomme l'outil et la primitive exacte, par exemple effects: orbit, awa card: liste, HF: logo tiles (Nat V1), camera: punch 1.1.

5. Fiche de style en dessous (max 6 lignes) : le préréglage de style s'il est utilisé, les codes Brand Nat en jeu avec leurs noms (même lorsque l'utilisateur n'a pas choisi de codes, nommez les plus proches afin qu'il puisse les échanger), look (propre ou cinématographique), couleur d'accent, sous-titres, musique (ambiance et piste), carte de fin, images de coupe.

6. Règles de budget et de rythme :

   • 5 à 6 styles pour toute la vidéo. Même travail, même traitement à chaque fois.
   • Un nouveau temps fort toutes les 3 à 6 s (ou le rythme du style, par exemple 2 à 3 s). Jamais deux choses importantes à la fois : un effet, une carte et des images de coupe ne se chevauchent jamais. Max 2 couches superposées.
   • Laissez des pauses de parole seulement. Effets 1,5 à 4 s, cartes 2 à 6 s, images de coupe 3 à 6 s.
   • Ouvrez fort dans les 2 premières secondes. Terminez sur l'appel à l'action, puis la carte de fin.
   • Les nombres à l'écran sont uniquement les nombres qu'ils ont dits ou donnés. N'inventez jamais de statistiques, de vues ou de prix.

7. Extras optionnels à proposer en une ligne chacun lorsqu'ils conviennent : une invite de prise MultiCam (/multicam-shot) pour un passage caméra IA sur une courte accroche (il génère une invite pour Seedance 2.0 Fast, pas un rendu) ; une carte d'intro Remotion lorsque la vidéo ne commence pas par sa propre accroche.

8. Demandez : « Des changements ? Pointez sur un numéro de ligne, ou dites go. » Attendez. Appliquez les modifications et remontrez uniquement ce qui a changé.

Étape 6 : Construction

Faites du premier rendu un aperçu là où le moteur le supporte (demi-taille ou --preview), et vérifiez les vignettes avant tout rendu long.

Moteur A (awa-video-reel). Exécutez son scripts/prepare.sh sur work/NOM-cut.mp4, puis écrivez fx.json, edit.json et cards.json dans son dossier de travail à partir du plan approuvé, en utilisant les formats exacts, les pièges des effets et la liste de sous-titres désactivés dans son SKILL.md. Vérifiez les vignettes des effets avec fx.py --still, puis bash scripts/render.sh <job> en arrière-plan. Utilisez SKIP_FX=1 (et SKIP_HF=1) lors des re-rendus lorsque seules les cartes, les sous-titres, la musique ou le son ont changé. Pour les codes Nat qu'il ne peut pas exprimer, construisez ce moment dans HyperFrames (moteur C) et assemblez ou incrustez-le après.

Moteur B (plugin Video Editor). Lisez son skills/edit/reference/plan-format.md. Exécutez d'abord le pré-passage des effets sur la coupe lorsque le plan a des effets (effects/scripts/fx.py --plan), et utilisez ce fichier comme input du plan. Écrivez work/NOM-plan.json (sous-titres, titres, zooms, incrustations, images de coupe ; keep couvre tout le clip car la coupe est faite), rendez avec --preview, vérifiez, puis rendez en entier. Les graphismes animés qu'il ne peut pas exprimer : construisez-les dans HyperFrames avec une racine transparente (hyperframes/references/overlays.md), rendez, et placez-les avec overlays.

Moteur C (HyperFrames). Chargez /hyperframes et lisez motion-doctrine et captions-overlay avant de composer. Mettez la séquence coupée comme couche vidéo (avec data-has-audio="true" pour que la voix passe, puis ajoutez le son à l'étape 7.