Communitygithub.com

long-video-render

Assemblez la vidéo finalisée et exécutez la boucle de révision. Construit le montage à partir des clips (ou images avec mouvements de caméra), voix, pistes sonores et sous-titres, génère une version de révision basse qualité avec numéros de scène et timecode incrustés pour une révision client, collecte et applique les modifications (réédite autant que nécessaire), et lorsque l'utilisateur approuve, rend la vidéo finale haute qualité. Utilise un éditeur vidéo avec une CLI ou MCP (FilmCraft, EffectCraft ou autre) si disponible et si l'utilisateur le souhaite, sinon le moteur de rendu ffmpeg intégré.

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

Ce skill de l'agent (étape 9 du workflow vidéo longue durée) assemble la vidéo finale et gère la boucle de révision. Il construit le montage à partir des clips vidéo, des images fixes avec mouvements de caméra, des voix, des pistes sonores et des sous-titres. Il utilise un éditeur vidéo pilotable par Claude (via CLI ou MCP) si disponible et si l'utilisateur le souhaite, sinon il utilise le moteur de rendu ffmpeg intégré. Le skill génère d'abord une version de révision basse qualité avec le numéro de scène et le timecode incrustés dans le coin supérieur gauche. L'utilisateur partage cette version avec son client, collecte les retours, et le skill applique les modifications (scène par scène) et génère de nouvelles révisions jusqu'à approbation explicite. Enfin, il rend la version finale haute qualité (H.264, AAC, normalisation du volume) et met à jour le projet.

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

Demander à votre IA préférée

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

Documentation

Rendu vidéo longue durée

Étape 9 du workflow vidéo longue durée. Sortie : rendus de révision (basse qualité) jusqu'à l'approbation, puis une vidéo finale haute qualité.

Une scène correspond à un clip du script, numéroté dans l'ordre dans la vidéo, comme dans les étapes précédentes. Les numéros de scène sont incrustés dans la vidéo de révision, afin que le relecteur puisse les désigner.

Avant de commencer

  1. Trouver le projet dans ~/.long-video/projects/<slug>/. Exiger video-script.md avec status: approved.
  2. Charger la configuration du projet : résolution, ratio d'aspect, mode de sous-titrage (visuals.captions), besoins en loudness, plateforme.
  3. Vérifier ffmpeg et ffprobe (ffmpeg -version). Le moteur de rendu intégré nécessite ffmpeg avec libx264 et libass.
  4. Si render/ existe déjà, demander : continuer (lister les versions) ou recommencer.

Étape 1 : Inventaire

Vérifier chaque scène et lister ce qui existe :

ÉlémentOùUtilisé comme
Clip vidéoclips/scene-<NNN>_clip.* (ou _take2 et suivants, selon ce que l'utilisateur a approuvé)L'image de la scène
Images uniquementframes/scene-<NNN>_start.*Un plan fixe avec un mouvement de caméra du script (push-in, pull-out, pan)
Voixaudio/lines/scene-<NNN>_<speaker>_<NN>.*Narration et dialogue
Pistes sonoressound/mix/sfx_track.wav, amb_track.wav, music_track.wavEffets, ambiance, musique

Signaler les lacunes dans un petit tableau. Une scène sans clip et sans image est un blocage : lister ces scènes et proposer de revenir à long-video-keyframes ou long-video-clips. L'absence de voix ou de son n'est autorisée que si l'utilisateur a choisi de sauter ces étapes. Si une étape a été sautée, ne pas la redemander.

Si l'étape des clips a été sautée (clips_mode: images-only), chaque scène devient un plan fixe avec un mouvement de caméra tiré du script.

Étape 2 : Choisir l'outil d'assemblage

  1. Vérifier la présence d'un éditeur vidéo que Claude peut piloter : un serveur MCP d'édition connecté dans cette session, ou une CLI sur l'appareil (FilmCraft : filmcraft-cli commands ; EffectCraft : effectcraft-cli --help). Voir ../long-video-sound/references/tools.md, section 5.
  2. Si l'un est disponible, demander : l'utiliser (l'utilisateur peut ouvrir le projet et l'ajuster), ou utiliser le moteur de rendu intégré. Par défaut, utiliser le moteur de rendu intégré. Si l'utilisateur choisit l'éditeur, lire d'abord sa liste de commandes et sa documentation, travailler sur une copie, demander avant d'installer ou de construire quoi que ce soit, et conserver les mêmes noms de fichiers.
  3. Dire quel outil sera utilisé.

Le reste de ce skill décrit le moteur de rendu intégré. Avec un éditeur, effectuer les mêmes étapes via ses commandes et exporter les fichiers de révision et finaux dans les mêmes dossiers et avec les mêmes noms.

Étape 3 : Construire la liste de montage

Lire references/edl-format.md. Écrire render/edl.json à partir des fichiers du projet :

  • une entrée par scène avec sa durée (du script, ou la durée réelle du clip si plus courte ou plus longue dans les limites de la durée de la scène), source de l'image, mouvement de caméra pour les plans fixes, et transition de sortie,
  • placements des voix : le temps de début de la scène plus un court décalage (0,3 s par défaut), lignes dans l'ordre avec de petits écarts,
  • les pistes sonores,
  • les sous-titres à partir du texte des voix (début et fin selon la durée de chaque fichier voix), si la configuration le demande,
  • largeur, hauteur et fps de la configuration. Le fps par défaut est 24. La cible de loudness par défaut est -14 LUFS avec un pic vrai en dessous de -1,5 dBTP.

Règles :

  • Utiliser les durées exactes des scènes du script approuvé. Ne pas étirer ou raccourcir l'histoire pour l'adapter.
  • Un clip plus long que sa scène est rogné à la fin. Un clip plus court que sa scène conserve sa dernière image. Signaler les deux.
  • Une ligne de voix qui dépasse la fin de sa scène, ou la fin de la vidéo, est signalée comme un avertissement.
  • Transitions : cut par défaut. fade (fondu au noir) uniquement là où le script le dit. Les cross-dissolves nécessitent un outil d'édition.
  • Vérifier le plan avant le rendu : node <skill folder>/scripts/build-render.mjs render/edl.json review render/review --plan.

Afficher un court résumé : nombre de scènes, durée totale par rapport à la cible, clips par rapport aux plans fixes, avertissements. Corriger les problèmes qui peuvent l'être sans changer l'histoire. Demander à l'utilisateur pour tout ce qui ne peut pas être corrigé.

Étape 4 : Rendre la version de révision

Qualité de révision : basse résolution (environ 360p), compression élevée, numéro de scène et timecode incrustés dans le coin supérieur gauche, et sous-titres si la configuration utilise des sous-titres incrustés.

node <skill folder>/scripts/build-render.mjs render/edl.json review render/review --version 1
  • Sortie : render/review/<slug>_review_v1.mp4, plus un .report.json avec durée, taille et loudness.
  • Les segments de scène sont mis en cache. Les révisions suivantes ne rendent que les scènes modifiées, donc elles sont beaucoup plus rapides.
  • Pour les vidéos de plus de quelques minutes, exécuter la commande en arrière-plan et attendre qu'elle se termine. Ne pas interroger.
  • Si le mode de sous-titrage est srt, un fichier .srt est écrit à côté de la vidéo.

Vérifier le rapport : durée réelle par rapport à la durée prévue, loudness, flux. Puis indiquer à l'utilisateur le chemin complet et la taille.

Expliquer comment réviser : regarder le fichier, noter le numéro de scène et le timecode affichés dans le coin avec chaque commentaire. Claude n'envoie ni ne télécharge le fichier. L'utilisateur le partage avec le client. Proposer de préparer un téléchargement uniquement si l'utilisateur le demande, et demander d'abord.

Étape 5 : Collecter les modifications

Demander : "Des modifications ? Si c'est final, dites-le et je rendrai la version haute qualité."

L'utilisateur peut coller les retours du client. Lire references/review-feedback.md. Pour chaque commentaire :

  1. Trouver le numéro de scène ou l'heure à laquelle il fait référence. Si le commentaire est vague, poser une question courte.
  2. Le classer et choisir la route :
    • Niveau montage (trim, longueur, ordre, texte des sous-titres, sous-titres activés ou désactivés, transition, niveaux de la voix, musique ou effets) : le corriger ici dans edl.json ou le gain des pistes.
    • Image d'une scène (aspect, personnage, composition, mouvement) : revenir à long-video-keyframes ou long-video-clips pour ces scènes. Les nouveaux fichiers reçoivent des noms de style _take2. Puis mettre à jour la liste de montage.
    • Ligne de voix (prononciation, formulation) : long-video-voice pour ces lignes. Un changement de formulation du script approuvé nécessite l'approbation de l'utilisateur et une révision du script.
    • Son (effet, ambiance, musique) : long-video-sound pour ces repères, puis remixer.
    • Histoire ou structure (ajouter ou supprimer des scènes) : long-video-director, puis refaire uniquement les scènes affectées en aval.
  3. Écrire la liste dans render/review-log.md avec la version, la scène, la demande, la route et le statut.
  4. Montrer à l'utilisateur le plan dans un court tableau. Demander un oui avant toute régénération qui coûte des crédits ou du temps.
  5. Appliquer les modifications, puis rendre la révision suivante (--version 2, etc.). Conserver chaque ancien fichier de révision.
  6. Dire à l'utilisateur ce qui a changé, scène par scène, et le chemin du nouveau fichier.

Répéter jusqu'à ce que l'utilisateur approuve. Le silence ou "ça a l'air bien pour l'instant" n'est pas une approbation.

Étape 6 : Rendre la vidéo finale

Seulement après que l'utilisateur a dit explicitement qu'une version de révision spécifique est finale.

  1. Confirmer : "Rendre la finale à partir de la révision v ?" Vérifier que la liste de montage correspond à cette version, et qu'aucune demande de modification n'est encore ouverte dans le journal de révision.
  2. Qualité finale : la résolution de la configuration, H.264 haute qualité (crf 18, presse slow), AAC 192k, normalisation du volume en deux passes vers la cible, aucune étiquette de révision. Les sous-titres sont incrustés uniquement si la configuration le demande. Sinon, un fichier .srt est écrit.
  3. Exécuter, en arrière-plan pour les longues vidéos :
node <skill folder>/scripts/build-render.mjs render/edl.json final render/final
  1. Vérifier avec le rapport et ffprobe : la durée correspond au plan, la résolution et le fps sont corrects, il y a un flux vidéo et un flux audio, le volume est proche de la cible (à environ 1 LU près) et le pic vrai est inférieur à -1 dBFS.
  2. Optionnellement, rechercher des images noires inattendues et de longs silences : ffmpeg -i FILE -vf blackdetect=d=0.5 -af silencedetect=noise=-50dB:d=3 -f null -. Signaler les résultats.
  3. Mettre à jour project.json : "stage": "final-rendered", "final_video": "<chemin>", et la version de révision approuvée.
  4. Indiquer à l'utilisateur le chemin complet, la taille et la durée. Lui rappeler les crédits dans sound/credits.md pour la description de la vidéo.
  5. Proposer de continuer avec long-video-publish (options de titre YouTube, description, tags et suggestion de miniature). Commencer uniquement si l'utilisateur accepte. Ne pas publier ni télécharger. Ne pas démarrer d'autre étape ultérieure sauf si l'utilisateur le demande et que cette étape existe.

Règles

  • Ne jamais rendre la version finale sans une approbation explicite d'une version de révision spécifique.
  • Ne jamais modifier le script approuvé. Si les retours l'exigent, le rediriger et demander.
  • Ne jamais envoyer, partager ou télécharger une vidéo sans demande claire de l'utilisateur.
  • Ne jamais supprimer les anciens rendus de révision.
  • Ne jamais régénérer d'images, clips, voix ou sons sans l'accord de l'utilisateur sur le plan.
  • Garder les messages de chat courts. Mettre la liste des modifications dans render/review-log.md.

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-director

Turn an approved story into a shot-by-shot video script, acting as the director. Asks whether the video uses a narrator or characters who speak (or both), suggests professional filming choices (camera type, lenses, camera movement, lighting, color, pacing), saves them as a separate film style file, then writes a script that matches the project config. Outputs film-style.md and video-script.md. Use after long-video-story (and long-video-assets) are done, or when the user asks for the video script, shot list, camera style or lighting plan.

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-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