Communitygithub.com

long-video-keyframes

Crée l'image de début et de fin pour chaque scène (clip) du script vidéo approuvé. Rédige une invite d'image par frame avec un nom de fichier fixe contenant le numéro de scène et le type (début ou fin), crée un dossier pour les images, et peut générer les images avec un outil disponible ou remettre les invites à l'utilisateur en une fois ou une par une.

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

Cette compétence correspond à l'étape 5 du workflow de création vidéo longue. Elle génère les images clés (début et fin) de chaque scène à partir d'un script vidéo approuvé. L'outil numérote automatiquement les scènes, écrit des invites d'image auto-suffisantes (incluant le style, les négatifs, les descriptions des personnages et environnements) et les sauvegarde dans des fichiers batch. L'utilisateur peut choisir de recevoir uniquement les invites, de générer les images via Claude, ou les deux. Le système gère l'ordre de génération, les vérifications de style, les limites de coût, et le suivi de statut. Il est conçu pour fonctionner après `long-video-director` et avant `long-video-clips`. Les frames sont nommées de manière fixe (`scene-001_start.png`, `scene-001_end.png`) pour garantir un tri correct. L'outil détecte automatiquement les scènes de continuation (où la frame de début est identique à la frame de fin de la scène précédente).

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

Demander à votre IA préférée

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

Documentation

Images clés pour vidéo longue

Étape 5 du workflow de vidéo longue. Résultat : une invite d'image pour la frame de début et la frame de fin de chaque scène, un dossier frames/, et éventuellement les images terminées.

Dans cette étape, une scène correspond à un clip du script (un plan, 10 secondes au maximum). Les scènes sont numérotées dans l'ordre sur toute la vidéo.

Avant de commencer

  1. Trouvez le projet dans ~/.long-video/projects/<slug>/. Exigez video-script.md avec status: approved. S'il n'est pas approuvé, arrêtez-vous et exécutez long-video-director.
  2. Exigez film-style.md et visual-bible.md. Ils contiennent le rendu caméra et éclairage ainsi que le style artistique verrouillé.
  3. Chargez la configuration du projet : rapport hauteur/largeur, résolution, fournisseur d'images, niveau d'approbation, budget.
  4. Vérifiez images/ pour les images de personnages, d'environnements et d'objets provenant de long-video-assets. Elles servent de références. Si elles manquent, dites-le. Continuez uniquement si l'utilisateur accepte d'écrire les invites sans elles.
  5. Si frames/ ou frame-prompts/ existent déjà, demandez : continuer (listez ce qui est fait) ou recommencer.

Étape 1 : Numéroter les scènes

  1. Lisez le script dans l'ordre. Donnez à chaque plan un numéro de scène : 1, 2, 3, etc., sur toute la vidéo. Ajoutez des zéros pour obtenir 3 chiffres (scene-001), ou 4 chiffres s'il y a plus de 999 scènes.
  2. Construisez la correspondance entre numéro de scène et identifiant de plan du script (par exemple la scène 7 correspond au plan 2.3).
  3. Marquez les clips de continuation (Continues: dans le script). Pour ceux-ci, la frame de début est la frame de fin de la scène précédente. N'écrivez pas de nouvelle invite de début. L'index pointe vers l'image de fin précédente.
  4. Comptez les images : deux par scène, moins les frames de début réutilisées. Indiquez le total à l'utilisateur.

Étape 2 : Rédiger les invites de frame

Lisez references/frame-prompt-templates.md. Écrivez deux invites par scène (sauf pour une scène de continuation).

Pour chaque frame, déduisez du plan du script :

  • Frame de début. Ce que montre la première image du clip : la première position de la caméra, les poses et positions de départ des personnages, l'éclairage à cet instant.
  • Frame de fin. Ce que montre la dernière image : où la caméra s'est déplacée (par exemple plus serrée après un zoom avant), comment l'action s'est terminée, tout changement de lumière. Elle doit être accessible depuis la frame de début dans la durée du plan. Si la caméra est statique et que rien ne bouge, la frame de fin est la même composition avec un petit changement naturel (un geste, un décalage de lumière).
  • Les deux frames montrent le même lieu, les mêmes personnages et objets, avec le même cadrage caméra sauf si le plan déplace la caméra.

Règles pour chaque invite :

  1. Auto-suffisante. Pas de "idem ci-dessus". Incluez tout ce dont le générateur a besoin.
  2. Bloc de style textuel. Copiez le bloc de style et les termes négatifs de visual-bible.md exactement. Ajoutez la "ligne d'invite pour générateurs" du style film. Ajoutez la caméra, l'objectif et l'éclairage du plan.
  3. Descriptions des entités textuelles. Copiez chaque description de personnage, d'environnement et d'objet de la bible visuelle. Ne paraphrasez jamais.
  4. Références. Listez les fichiers image à attacher : image du personnage et planche, image de l'environnement, objets. Pour une frame de fin, listez la propre frame de début de la scène comme première référence. Utilisez les noms de fichier exacts.
  5. Même cadrage. Utilisez le rapport hauteur/largeur de la configuration dans chaque invite.
  6. Pas de texte dans l'image. Pas de légendes, sous-titres, logos ou panneaux avec du texte lisible, sauf si l'histoire le nécessite.
  7. Pas de noms de personnes réelles, de marques déposées ou de noms d'artistes vivants.

Sauvegardez les invites dans frame-prompts/, dans des fichiers batch de 20 scènes : scenes-001-020.md, scenes-021-040.md, etc. Écrivez aussi frame-prompts/index.md (format dans les modèles).

Étape 3 : Noms de fichiers et dossiers

Créez frames/ dans le dossier du projet. Ne mettez jamais les images ailleurs.

Les noms de fichiers sont fixes et apparaissent dans l'en-tête de chaque invite :

  • scene-<numéro>_start.png
  • scene-<numéro>_end.png

Exemples : scene-007_start.png, scene-007_end.png. N'importe quelle extension fonctionne (png, jpg, webp), mais le nom de base doit correspondre. Le nom contient le numéro de scène et le mot start ou end, afin que chaque frame puisse être trouvée par son nom et triée dans l'ordre.

Étape 4 : Demander ce que veut l'utilisateur

Demandez : "Que voulez-vous de cette étape ?"

  • Invites uniquement. L'utilisateur crée les images avec son propre outil.
  • Images. Claude génère les images.
  • Les deux. L'utilisateur reçoit les invites et Claude génère aussi les images.

Les fichiers d'invite sont toujours sauvegardés. Ce choix décide qui génère les images.

Demandez ensuite comment les délivrer : en une fois, ou une par une.

Invites uniquement

  • En une fois. Montrez le chemin complet de frames/ et de frame-prompts/. Montrez comment fonctionnent les noms de fichiers, avec un exemple. L'utilisateur ouvre les fichiers batch et les traite. Proposez de vérifier le dossier plus tard.
  • Une par une. Montrez la première invite dans le chat avec son nom de fichier et les références à attacher. Attendez que l'utilisateur dise qu'il l'a sauvegardée. Vérifiez que le fichier existe dans frames/ avec le bon nom. Montrez ensuite l'invite suivante. Si l'utilisateur dit "passer" ou "arrêter", sauvegardez la position dans frames/status.md et arrêtez.

Vérifiez le dossier à la demande de l'utilisateur, ou à la fin : comparez les fichiers trouvés par rapport à l'index et listez ce qui manque ou est mal nommé.

Images ou les deux

Lisez ../long-video-assets/references/image-generation.md et suivez ses étapes pour trouver une méthode, gérer l'option navigateur, l'ordre, les vérifications et le statut. Utilisez la méthode sauvegardée dans la configuration si elle existe. Changements pour cette étape :

  • Comptage et coût. Indiquez à l'utilisateur combien d'images sont nécessaires et le temps ou coût approximatif. Demandez avant de lancer un grand lot. Proposez de commencer par une plage, par exemple les scènes 1 à 10.
  • Test de style. Générez d'abord scene-001_start. Montrez-la. Demandez si elle correspond au style verrouillé et à l'apparence du personnage. Corrigez les invites avant de continuer.
  • Ordre. Pour chaque scène : frame de début, puis frame de fin (la frame de fin utilise la frame de début comme référence lorsque la méthode le supporte). Puis la scène suivante.
  • Références. Attachez les images de personnage, d'environnement et d'objets listées dans l'invite. Si la méthode n'accepte qu'une seule référence, utilisez la plus importante (le personnage principal dans la frame) et dites-le.
  • En une fois ou une par une. En une fois : générez toute la plage, puis montrez les résultats. Une par une : montrez chaque paire, attendez l'approbation ou une demande de refaire, puis continuez.
  • Option navigateur. Mêmes règles que dans l'étape des ressources : confirmation explicite du nombre, du temps et du dossier de téléchargement d'abord. Ne saisissez jamais de mots de passe et ne résolvez pas de CAPTCHAs.
  • Vérifications. Après chaque image, vérifiez le sujet, la correspondance de style, l'apparence du personnage par rapport aux références, et la différence entre les frames de début et de fin. Au maximum 2 tentatives, puis marquez needs-manual.
  • Ne jamais écraser. Ne jamais écraser une frame existante sans demander.

Si la génération échoue ou si l'utilisateur refuse, revenez au chemin "invites uniquement" pour les scènes restantes.

Étape 5 : Statut et finition

  1. Tenez frames/status.md à jour :
| Scène | Frame | Fichier | Statut | Note |
|-------|-------|---------|--------|------|
| 001 | start | scene-001_start.png | done | |
| 001 | end | scene-001_end.png | pending | |

Valeurs de statut : pending, done, needs-manual, skipped.

  1. Mettez à jour project.json : "stage": "frames-prompts-done" après que les invites sont sauvegardées, et "stage": "frames-images-done" lorsque chaque frame existe et que l'utilisateur approuve l'ensemble.
  2. Indiquez à l'utilisateur les chemins de frames/ et frame-prompts/, et ce qui manque encore.
  3. Proposez de continuer avec long-video-clips (clips vidéo à partir des frames, ou ignorez-les et utilisez les images uniquement). Lancez-le uniquement si l'utilisateur est d'accord. Ne lancez aucune autre étape ultérieure sauf si l'utilisateur le demande et que cette étape existe.

Auto-vérification avant de sauvegarder les invites

  • Chaque scène a une invite de fin. Chaque scène non-continuation a une invite de début.
  • Chaque invite a le nom de fichier dans son en-tête, correspondant à la règle de nommage.
  • Chaque invite contient le bloc de style, les termes négatifs et la ligne d'invite film, textuellement.
  • Chaque personnage, environnement et objet du plan apparaît avec sa description textuelle et ses fichiers de référence listés.
  • Les frames de début et de fin d'une scène concordent sur le lieu, les personnages et l'éclairage, et diffèrent comme le dit le plan.
  • Le nombre d'invites correspond au nombre promis à l'utilisateur.

Règles

  • Ne jamais commencer sans un script approuvé.
  • Ne jamais générer d'images avant que l'utilisateur n'ait choisi "images" ou "les deux".
  • Ne jamais renommer une image ou un fichier d'invite après que les invites ont été approuvées.
  • Ne jamais demander de clés API dans le chat.
  • Gardez les messages du chat courts. Mettez le texte complet de l'invite dans des fichiers et montrez uniquement des échantillons ou l'invite en cours.

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