Communitygithub.com

long-video-director

Transforme une histoire approuvée en un script vidéo plan par plan, en agissant comme le réalisateur. Demande si la vidéo utilise un narrateur ou des personnages qui parlent (ou les deux), suggère des choix professionnels de tournage (type de caméra, objectifs, mouvement, éclairage, couleur, rythme), les enregistre dans un fichier de style cinématographique séparé, puis écrit un script qui correspond à la configuration du projet. Produit film-style.md et video-script.md. À utiliser après long-video-story (et long-video-assets), ou lorsque l'utilisateur demande le script vidéo, le plan de tournage, le style de caméra ou le plan d'éclairage.

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

Cette compétence agit comme le réalisateur dans la quatrième étape d'un workflow de production vidéo longue. Elle prend une histoire approuvée (story.md) ainsi qu'une bible visuelle (visual-bible.md) et produit deux fichiers essentiels : film-style.md (le style cinématographique détaillé) et video-script.md (le script vidéo plan par plan). Le réalisateur guide d'abord l'utilisateur sur le mode de narration (narrateur, personnages parlants ou mixte), puis propose des choix techniques professionnels pour la caméra, les objectifs, le mouvement, l'éclairage, la couleur et le rythme, en respectant le style artistique et le budget définis dans la configuration du projet. Il applique strictement des règles de cohérence, de durée (chaque plan ne doit pas dépasser la limite de clip définie, par défaut 10 secondes) et de fidélité à l'histoire originale. Le script final est validé avec l'utilisateur avant d'être verrouillé. Cette compétence est conçue pour les workflows de production vidéo assistés par IA, comme dans Claude Code, et nécessite que les étapes précédentes (histoire et actifs visuels) soient terminées.

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

Demander à votre IA préférée

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

Documentation

Long video director - Réalisateur vidéo longue

Étape 4 du workflow vidéo longue. Vous êtes le réalisateur. Sortie : film-style.md et video-script.md dans le dossier du projet.

Avant de commencer

  1. Trouvez le projet dans ~/.long-video/projects/<slug>/. Exigez story.md avec status: approved. Si ce n'est pas approuvé, arrêtez-vous et exécutez long-video-story.
  2. Exigez visual-bible.md (identifiants des entités et style artistique verrouillé). S'il manque, dites à l'utilisateur que le style artistique est d'abord nécessaire et proposez de lancer long-video-assets. Continuez uniquement si l'utilisateur choisit de l'ignorer. Dans ce cas, demandez une brève description du style artistique et notez-le comme « déverrouillé » dans le style cinématographique.
  3. Chargez la configuration du projet. Prenez-en : la langue, la durée cible, le ratio d'aspect, le public, le ton, l'approche visuelle, la source et le fournisseur de voix off, les sous-titres, la musique, le budget. Ne redemandez pas ce que la configuration a déjà répondu.
  4. Si film-style.md ou video-script.md existe déjà, demandez : continuer, ou recommencer l'un d'eux.

Étape 1 : Narration ou personnages parlants

Demandez : « Comment la vidéo doit-elle parler ? »

  • Narrateur. Une seule voix raconte l'histoire sur les images.
  • Personnages parlants. Les personnages se parlent entre eux à l'écran. Pas de narrateur, ou seulement quelques lignes de titres.
  • Mixte. Un narrateur porte l'histoire et les personnages parlent dans les scènes clés.

Avant que l'utilisateur ne réponde, donnez une ligne sur ce que chaque choix signifie pour la production. Utilisez les visuals.approach et audio.voiceover de la configuration :

  • Les personnages parlants nécessitent une voix distincte par personnage. Les images fixes ou l'animation simple ne peuvent pas montrer un véritable lip-sync, alors dites laquelle de ces options s'applique : outil de lip-sync nécessaire, delivery hors écran (le locuteur n'est pas montré en parlant), ou un style qui cache les bouches.
  • Un narrateur est le moins cher et fonctionne avec toutes les approches visuelles.

Recommandez une option en fonction de l'histoire et de la configuration. Si le choix entre en conflit avec la configuration (par exemple, voiceover.source est none), signalez-le et demandez s'il faut mettre à jour la configuration.

Si les personnages parlent, demandez une description vocale pour chaque personnage de la bible visuelle (âge, ton, accent). Utilisez le fournisseur TTS de la configuration s'il y en a un.

Étape 2 : Style cinématographique, en tant que réalisateur

Lisez references/cinematography-options.md. Parcourez les groupes ci-dessous avec l'utilisateur, un groupe à la fois. Pour chaque groupe, suggérez 3 à 4 options qui conviennent à cette histoire. Donnez à chacune une raison d'une ligne. Marquez celle que vous recommandez. L'utilisateur peut choisir, combiner ou décrire la sienne.

  1. Apparence de la caméra et du format
  2. Objectifs et cadrage
  3. Mouvement de la caméra
  4. Éclairage
  5. Couleur et étalonnage
  6. Rythme et transitions. Le rythme fonctionne dans la limite du clip : la durée moyenne d'un plan doit rester entre 5 et 8 secondes, sauf indication contraire de la configuration. Proposez de la variété par la taille du plan, le mouvement et le rythme de coupe, et non par de longues tenues.

Règles :

  • Tout doit correspondre au style artistique verrouillé et à l'approche visuelle de la configuration. Ne suggérez pas une caméra de cinéma physique pour un style illustré 2D. Pour les styles illustrés ou d'images fixes, proposez plutôt les mouvements de caméra virtuels correspondants (push-in, parallaxe, panoramique sur l'image) et dites ce que la production peut réellement faire.
  • Ne contredisez pas le bloc de style dans visual-bible.md. Le style cinématographique s'y ajoute.
  • Liez chaque suggestion à l'histoire : ambiance, décor, époque, genre.
  • Utilisez des mots simples. Expliquez un terme la première fois que vous l'utilisez.
  • Demandez le choix de l'utilisateur pour chaque groupe avant de passer au suivant. Si l'utilisateur dit « tu décides », choisissez l'option recommandée et dites ce que vous avez choisi.

Étape 3 : Confirmer et enregistrer le style cinématographique

  1. Affichez le style cinématographique complet sous forme d'un résumé : mode de narration, caméra et format, objectifs, mouvement, éclairage, couleur, rythme, transitions, plus le bloc de style artistique copié de la bible visuelle.
  2. Demandez à l'utilisateur de confirmer ou de modifier des éléments.
  3. Sur un oui explicite, écrivez film-style.md en utilisant references/film-style-template.md.
  4. Proposez également de l'enregistrer en tant que preset réutilisable dans ~/.long-video/film-styles/<preset-name>.md. Utilisez des lettres minuscules, des chiffres et des traits d'union. Si l'utilisateur refuse, ignorez.

Le style cinématographique est maintenant verrouillé. Ne le modifiez pas pendant l'écriture du script sans demander.

Étape 4 : Écrire le script

Lisez references/script-format.md et suivez son format et ses règles de minutage.

Règles :

  • Respectez la configuration : langue, durée cible, ratio d'aspect, public, ton, sous-titres, mode de voix off.
  • Restez fidèle à l'histoire approuvée. Couvrez chaque battement. N'ajoutez pas de faits, d'événements ou d'affirmations qui ne sont pas dans l'histoire. Là où l'histoire est un texte de narration (par exemple de long-video-story-questions), conservez ce texte mot pour mot et ajoutez de la structure autour.
  • Décomposez l'histoire en scènes, et chaque scène en plans. Chaque plan obtient : durée, image, caméra (taille, angle, mouvement), éclairage, son, transition.
  • Limite de durée du clip. Chaque plan (une image ou un clip) dure au maximum 10 secondes. Visez 5 à 8 secondes. Lisez video.max_clip_seconds et video.preferred_clip_seconds dans la configuration s'ils sont définis. Par défaut : max 10, préféré 5 à 8. Les plans de moins de 5 secondes ne sont autorisés que pour une raison (un insert rapide, un moment d'impact). Ne dépassez jamais le maximum. Si un moment a besoin de plus de temps que la limite ne le permet, divisez-le en clips (plans) consécutifs à une frontière de phrase, de proposition ou d'action. Les clips peuvent partager le même environnement, la même caméra et le même éclairage, et l'image peut rester la même ou continuer la même action. Le résultat final est plus long que n'importe quel clip individuel. Marquez chaque clip de suivi avec Continues : <id du plan précédent>, et conservez la narration ou le dialogue mot pour mot. N'inventez pas de nouveaux mouvements de caméra ou de nouvelles images juste pour remplir les clips supplémentaires.
  • Appliquez le style cinématographique à chaque plan. Variez la taille du plan et le mouvement pour le rythme, dans le style verrouillé.
  • Utilisez les identifiants d'entité de la bible visuelle pour chaque personnage, environnement et objet. Si un plan nécessite quelque chose qui n'est pas dans la bible, listez-le sous « Nouveaux actifs nécessaires » au lieu de l'inventer silencieusement.
  • Narration : écrivez le texte dans la langue de la configuration. Dialogue : écrivez PERSONNAGE : réplique avec une note de delivery entre parenthèses lorsque c'est important. Gardez chaque réplique prononçable en une seule respiration.
  • Additionnez la durée totale. Elle doit se situer à moins de 10 % de la durée cible. Si ce n'est pas le cas, ajustez avant de la montrer.

Étape 5 : Révision

  1. Affichez un tableau récapitulatif : numéro de scène, titre, durée, nombre de plans, mode de narration. Affichez la durée totale par rapport à la cible.
  2. Affichez la première scène en entier. Proposez d'autres scènes sur demande.
  3. Listez tout « Nouveaux actifs nécessaires ».
  4. Demandez à l'utilisateur d'approuver ou de demander des modifications.
  5. Appliquez les modifications. Conservez le style cinématographique sauf si l'utilisateur demande de le modifier. Si le style cinématographique change, mettez à jour film-style.md et revérifiez chaque plan.
  6. Répétez jusqu'à ce que l'utilisateur approuve explicitement. Le silence ou « ça a l'air bien pour l'instant » ne vaut pas approbation. En cas de doute, demandez : « Verrouiller ce script ? »

Avant de montrer le script, effectuez cette auto-vérification et corrigez toute défaillance :

  • La durée totale est à moins de 10 % de la cible.
  • Chaque battement de l'histoire apparaît dans le script.
  • Chaque plan a une durée, une caméra, un éclairage et un son.
  • Aucun plan n'est plus long que la limite du clip (10 secondes par défaut). La plupart des plans se situent dans la plage préférée (5 à 8 secondes). Signalez le nombre de plans en dehors de celle-ci.
  • Chaque identifiant d'entité existe dans la bible visuelle, ou est listé sous nouveaux actifs.
  • La langue correspond à la configuration.
  • Aucun plan n'utilise un mouvement de caméra ou un éclairage que le style cinématographique exclut.

Étape 6 : Enregistrer

  1. Écrivez video-script.md avec l'en-tête du modèle de format de référence, le statut approved et la date d'approbation.
  2. Assurez-vous que film-style.md est enregistré.
  3. Mettez à jour project.json : "stage": "script-approved", "film_style": "film-style.md", "script": "video-script.md".
  4. Dites à l'utilisateur les deux chemins de fichiers et la durée totale. S'il y a de nouveaux actifs nécessaires, dites-le et proposez d'exécuter long-video-assets pour eux.
  5. Proposez de continuer avec long-video-keyframes (images de début et de fin pour chaque scène). Ne lancez cette étape que si l'utilisateur est d'accord. Ne commencez aucune autre étape ultérieure à moins que l'utilisateur ne le demande et que cette étape existe.

Règles

  • N'écrivez jamais le script avant que le style cinématographique ne soit confirmé.
  • N'approuvez jamais le script sans un oui explicite.
  • Ne modifiez jamais l'histoire. Si l'histoire a un problème, dites-le à l'utilisateur et proposez de rouvrir long-video-story.
  • Ne suggérez jamais un style que la production ne peut pas réaliser avec l'approche visuelle de l'utilisateur.
  • Gardez les messages de chat courts. Mettez le texte complet dans les fichiers.

Individual skills in this repo

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

long-video-assets

Video and animation skill. Build the visual foundation for a long video from an approved story. Extracts the recurring characters, environments and key objects, helps the user choose one art style from suggested options (10 at a time, more on request), then writes image generation prompts for every character (portrait plus character sheet), environment and object, all sharing one locked style. Can also generate the images (installed tool, API, MCP or browser) or hand the user a folder and file names to fill. Use after lon

long-video-keyframes

Create the start and end frame image for every scene (clip) of the approved video script. Writes one image prompt per frame with a fixed file name that holds the scene number and start or end, makes a folder for the images, and can generate the images with an available image tool, or hand the prompts to the user all at once or one by one. Use after long-video-director, or when the user asks for start frames, end frames, keyframes or scene images.

long-video-render

Assemble the finished video and run the review loop. Builds the edit from the clips (or images with camera moves), voice, sound stems and captions, renders a low quality review version with scene numbers and time burned in so a client can review it, collects and applies changes (re-rendering reviews as often as needed), and when the user approves, renders the high quality final video. Uses a video editor with a CLI or MCP (FilmCraft, EffectCraft or another) if one is available and the user wants it, otherwise the bundled ffmpeg renderer. Use after long-video-sound, or when the user asks to render, assemble, export, preview or finalize the video.

long-video-sound

Video and animation skill. Create the sound effects, ambience and background music for the video and place them on the timeline. Plans the sound design from the approved script, sources or makes each sound (Openverse for openly licensed recordings and music, Earshot to make sounds from words and to listen to and judge sounds, Clipwing real-sfx to place real sounds on exact frames), records licences and credits, and mixes separate stems (effects, ambience, music) with the music ducked under speech. Or gives the user a fold

long-video-story

Agree on the story for a long video. The user either supplies a story or asks Claude to write one. When Claude writes, it first asks which story style to use (for example niche discovery, or a provocative-questions narration), runs that style's skill, and revises until the user approves. Use after long-video-setup, or when the user says "story for my video", "give me an idea", or wants to change an unapproved story. Ends only when the user explicitly approves the story.

long-video-voice

Create the spoken audio (narration and character voices) for the approved video script. First decides whether the video needs speech and asks the user to confirm. If yes, builds a voice cast (narrator plus each speaking character), makes a short sample of each voice with an available tool such as an ElevenLabs MCP and asks the user to approve the voices, then generates one audio file per spoken line with a name that holds the scene number and speaker. Or gives the user the lines, file names and folder to record or generate themselves. Use after long-video-clips (or long-video-keyframes), or when the user asks for narration, voiceover, voices or dialogue audio.

Skills associés