Communitygithub.com

studio-video-director

Pipeline de production vidéo et de Shorts de qualité studio. À utiliser lors de la planification, du script, de la génération, de l'assemblage ou du contrôle qualité de toute vidéo : démos de hackathon (16:9), Shorts/Reels (9:16), publicités produit, analyses de films, extraits viraux, ou toute vidéo narrative multi-scènes. Applique un son stéréo réel, une loudness de -14 à -16 LUFS, un cut visuel toutes les 3 à 4 secondes, zéro diaporama statique et un verrouillage strict du ratio d'aspect. Version gratuite à 0 $ (FFmpeg local + Whisper uniquement) ; la version Pro ajoute l'assemblage multi-scènes, le ducking automatique, l'incrustation de sous-titres, des modèles spécialisés et le contrôle par lots.

Qu'est-ce que studio-video-director ?

Studio Video Director est une compétence spécialisée pour la production vidéo de qualité studio, destinée aux développeurs utilisant des outils locaux gratuits (FFmpeg, Whisper) ou la version Pro. Elle impose des normes strictes : son stéréo véritable, loudness entre -14 et -16 LUFS, cut visuel toutes les 3-4 secondes, et verrouillage du ratio d'aspect (16:9 ou 9:16). Le flux de travail en 8 étapes couvre du brief au contrôle qualité final, avec 10 portes de qualité (Quality Gates) qui vérifient chaque aspect technique (durée, résolution, audio, silence, cadence des cuts, couverture vocale, etc.). La version gratuite permet de tout faire localement sans API payante ; la version Pro ajoute l'assemblage multi-scènes, le ducking audio automatique, l'incrustation de sous-titres, 18 modèles et un contrôle par lots en une commande. Cette compétence est idéale pour les vidéos de démonstration, les publicités, les analyses de films et les contenus pour réseaux sociaux, garantissant un rendu professionnel sans compromis.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/rjrajput-web3/studio-video-director-skill/tree/HEAD

Demander à votre IA préférée

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

Documentation

Studio Video Director

Un pipeline éprouvé et basé sur des mesures pour produire des vidéos de qualité studio avec des outils locaux gratuits. Chaque règle ci-dessous a été payée par de vrais échecs de construction : mixes mono, audio surcompressé, Shorts en diaporama, sous-titres tronqués et silences gênants. Toute construction qui enfreint une porte est une construction échouée — corrigez-la, ne la livrez pas.

Quand utiliser cette compétence

  • Tout livrable vidéo : démo de hackathon, démo produit, Short/Reel, analyse de film, publicité, tutoriel, bande-annonce, extrait de podcast.
  • Avant le rendu : planification, script, storyboard, prompts de plans.
  • Après le rendu : le contrôle des 10 portes sur l'encodage FINAL.
  • Quand une vidéo « a l'air bien mais semble amateur » : exécutez les portes, corrigez les portes défaillantes, revérifiez. La porte nomme le défaut exact.

Le flux de travail en 8 étapes

  1. Brief — un paragraphe : public, une idée, un appel à l'action, durée, ratio (choisissez UN SEUL et verrouillez-le : 16:9 démo/format long ou 9:16 Shorts/Reels — NE JAMAIS mélanger les ratios dans un projet).
  2. Plan de l'équipe (6 rôles) — Réalisateur (vision + liste de cuts), Scénariste (script, <=30 mots par plan, ~150 mots/min), Directeur de la photo (caméra + cadrage), Directeur artistique (palette + décor), VFX (mouvement + transitions), Designer sonore (VO + musique + SFX). Chaque rôle valide avant la génération.
  3. Storyboard + liste de cuts — écrit AVANT l'animation. Un cut visuel ou caméra au moins toutes les 3-4 s (pas d'écart > 4 s, échec dur). Accroche dans les 3 premières secondes : titre/question + mouvement. Jamais d'ouverture statique.
  4. Prompts (six parties) — par segment, <=10 s chacun, utilisant references/prompt-template.md : durée/format, sujet, scène, beats avec horodatages, langage caméra, son/dialogue, contraintes. Réutilisez la description du sujet TEXTUELLEMENT entre les segments.
  5. Générer les segments — mouvement réel uniquement : enregistrement d'écran (Playwright, deviceScaleFactor 2, 1920x1080@30fps pour les démos), B-roll, ou animation. Ken Burns sur images fixes : au plus UN segment de <=4 s par Short, jamais la vidéo entière.
  6. Assembler — normaliser chaque scène au cadre verrouillé (mise à l'échelle + padding, jamais d'étirement), joindre avec le concat demuxer, masteriser l'audio (Pro : pro-bundle/scripts/assemble_multiscene.py).
  7. Son — VO neuronale uniquement (edge-tts / studio TTS ; gTTS interdit). Musique : un morceau réel sous licence (Mixkit / Pixabay / YouTube Audio Library), ducké à -20 dB (Shorts) ou -22 dB (démos) sous la VO. SFX réels synchronisés avec les cuts. Lits synthétiques/SFX interdits.
  8. Porte + livrer — exécutez scripts/quality_gate.py sur l'encodage FINAL. Les 10 portes doivent PASSER. Sauvegardez le master + .SRT dans renders/ et ne les jetez jamais.

Portes de qualité (toutes les 10, sans exception)

#PorteRègle
1Spécificationsdurée/résolution/fps exacts ; canaux audio == 2
2Loudnessintégré -14..-16 LUFS, TP <= -1.5 dBTP, LRA >= 6 LU
3Silencepas de silence >= 0.5 s sauf une queue finale <= 1 s
4Cadence des cutspas d'écart entre les cuts > 4 s
5Couverture VOla transcription faster-whisper couvre >= 80 % des mots du script
6Imagesles images à 00:02 / milieu / fin passent la checklist d'images nommées
7Stéréoffprobe channels == 2 sur le mix final
8Musique/SFX réelsattestation humaine de musique réelle sous licence + SFX réels
9Pas de diaporamaaucun segment figé > 4 s
10Protection du masterfichier .SRT sidecar présent, pas de fichiers *-broken / *-v1 / *-v2

Exécutez-le :

python3 scripts/quality_gate.py final.mp4 --aspect 16:9 \
  --srt final.srt --script vo-script.txt --frames-dir checks/

Portes individuelles :

python3 scripts/audio_lufs_check.py final.mp4
python3 scripts/extract_frames_check.py final.mp4 --aspect 16:9 --frames-dir checks/

Règle des sous-titres

  • Démos 16:9 : fichier .SRT sidecar UNIQUEMENT. Zéro sous-titre de narration incrusté. Les légendes d'interface à l'écran sont autorisées — ce ne sont pas des sous-titres.
  • Shorts/Reels 9:16 : fichier .SRT sidecar ET sous-titres stylisés dans la zone de sécurité inférieure (le lecteur Shorts ignore les sidecars ; les spectateurs en mode muet ont besoin de texte à l'écran).

Checklist d'images nommées (appliquée aux images à 00:02, milieu, fin)

(a) rien de coupé sur aucun bord, (b) pas de bande morte/zone vide > 25 % du cadre, (c) chaque mot à l'écran lisible à la taille d'un téléphone, (d) sous-titres visibles là où le script dit qu'ils doivent être, (e) pas de texte d'interface factice/faux, (f) le sujet remplit le cadre.

Outils gratuits (version gratuite)

  • ffmpeg / ffprobe 8.x, Python 3.10+, faster-whisper (local, CPU).
  • Crédits gratuits externes optionnels uniquement (tiers gratuits OpusClip / Vizard / Quso / 2short) — jamais invoqués par aucun script de ce repo, jamais d'API payante, jamais d'inscription, jamais de carte.
  • Ce repo ne contient AUCUN identifiant, AUCUNE clé API, AUCUNE donnée personnelle.

Édition Pro

pro-bundle/ ajoute : assemblage FFmpeg multi-scènes avec mastering loudnorm en deux passes, ducking automatique VO + musique, générateur de sous-titres Whisper .SRT + incrustés, 18 modèles spécialisés et un contrôle par lots en une commande. Voir README.md (section Édition Pro) et pro-bundle/README.md.

Skills associés