Communitygithub.com

histoire-vidéo-longue

Se mettre d'accord sur le scénario d'une longue vidéo. L'utilisateur fournit une histoire ou demande à Claude d'en écrire une. Lorsque Claude écrit, il demande d'abord le style narratif, exécute la compétence correspondante et révise jusqu'à approbation.

Qu'est-ce que histoire-vidéo-longue ?

Cette compétence gère la deuxième étape du workflow de production de longues vidéos. L'objectif est de produire un fichier `story.md` approuvé dans le dossier du projet. Si l'utilisateur a déjà une histoire, il peut la fournir directement ; sinon, Claude propose d'en écrire une en guidant l'utilisateur à travers plusieurs sous-étapes : choix du style narratif (parmi les compétences installées), sélection du sujet, puis rédaction du scénario. Une fois le texte produit (ou saisi par l'utilisateur), Claude le présente et demande une confirmation explicite. Si l'utilisateur demande des changements, Claude les applique en incrémentant le numéro de révision et en affichant les modifications. L'étape se termine uniquement lorsque l'utilisateur donne un « oui » explicite, ce qui verrouille le fichier avec le statut `approved` et met à jour la configuration du projet. La compétence est conçue pour être utilisée après `long-video-setup` ou lorsque l'utilisateur dit « raconte-moi une histoire », « donne-moi une idée » ou souhaite modifier une histoire non approuvée. Elle prend en charge les environnements Claude Code et Cursor, et s'appuie sur les compétences de style installées dans le projet.

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

Demander à votre IA préférée

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

Documentation

Histoire vidéo longue

Étape 2 du workflow de production de vidéos longues. Résultat : un fichier story.md approuvé dans le dossier du projet.

Cette étape se termine uniquement lorsque Claude et l'utilisateur se mettent d'accord sur le scénario. Aucune étape ultérieure ne commence avant cela.

Avant de commencer

  1. Trouver le projet actif : ~/.long-video/projects/<slug>/project.json. Si l'utilisateur en a plusieurs, demander lequel.
  2. S'il n'existe aucun projet, exécuter d'abord long-video-setup.
  3. Charger la configuration du projet depuis ~/.long-video/configs/<nom-de-la-config>.json. L'utiliser pour la durée, la langue, le public cible, le ton, le format et l'approche visuelle. Ne pas redemander ce que la configuration répond.
  4. Si story.md existe déjà avec le statut draft, proposer de le continuer. Si le statut est approved, demander s'il faut le rouvrir.

Étape 1 : Poser la question d'entrée

Demander : « Avez-vous une histoire, ou voulez-vous que j'en écrive une ? »

  • J'ai une histoire. L'utilisateur la colle ou la décrit. Aller à l'Étape 5.
  • Écris-en une pour moi. Aller à l'Étape 2.
  • J'ai une idée vague. L'utilisateur donne une amorce (sujet, thème, une phrase). La conserver, puis aller à l'Étape 2.

Étape 2 : Demander le style narratif

Toujours demander cela lorsque Claude écrit l'histoire. Ne pas sauter cette étape, et ne pas choisir un style pour l'utilisateur.

  1. Lire references/story-styles.md. Vérifier quelles compétences de style sont installées.
  2. Afficher les styles disponibles, chacun avec sa description en une ligne. Inclure toujours open.
  3. Demander à l'utilisateur d'en choisir un. Il peut aussi décrire son propre style. Si c'est le cas, le traiter comme open avec sa description comme instructions supplémentaires.
  4. Enregistrer le choix dans project.json sous la forme "story_style" : "<id>".

Étape 3 : Obtenir le sujet

Suivre le type du style choisi.

  • ideas (par exemple niche) : appeler la compétence de style. Lui passer le résumé de la configuration et toute amorce. Elle retourne un sujet. Puis demander quel rédacteur utiliser (règle d'appariement de l'Étape 4 dans le registre).
  • writer (par exemple questions) : si l'utilisateur a un sujet ou une amorce, l'utiliser. Sinon, lui en demander un. Ne pas suggérer de sujets.
  • open : proposer des idées, comme ci-dessous.

Style open : proposer des idées

  1. S'il n'y a pas d'amorce, poser au maximum 3 questions courtes : domaine d'intérêt ou centres d'intérêt, quelque chose à éviter, des événements réels ou sources à utiliser.
  2. Rédiger 4 propositions qui correspondent à la configuration. Chaque proposition comporte : un titre, un pitch en une phrase, les 15 premières secondes en accroche, et pourquoi cela fonctionne pour ce public.
  3. Faire en sorte que les 4 propositions soient clairement différentes les unes des autres.
  4. Demander à l'utilisateur d'en choisir une, d'en combiner deux, d'en demander d'autres, ou de donner une nouvelle direction. Répéter jusqu'à ce que l'utilisateur choisisse.

Étape 4 : Écrire l'histoire

Appeler le rédacteur.

  • Une compétence de rédacteur (par exemple long-video-story-questions) : l'appeler avec le sujet, la durée cible, la langue et le résumé de la configuration. Son propre format de sortie est prioritaire. Ne pas le remodeler dans la structure par défaut.
  • open : écrire la structure par défaut ci-dessous.

Structure par défaut (style open)

Respecter la durée cible dans la configuration. La narration parlée tourne autour de 150 mots par minute, donc une vidéo de 15 minutes nécessite environ 2 250 mots parlés. Ne pas écrire le script final maintenant. Écrire l'histoire : ce qui se passe, dans l'ordre, avec suffisamment de détails pour que l'utilisateur puisse la juger.

  1. Titre (provisoire).
  2. Logline.
  3. Accroche. Les 15 à 30 premières secondes.
  4. Plan de l'histoire. Actes ou chapitres. Pour chacun : ce qui se passe, le point de retournement, part approximative du temps d'écran.
  5. Histoire complète. Récit en prose, du début à la fin.
  6. Conclusion et appel à l'action.
  7. Faits à vérifier. Lister chaque affirmation factuelle qui nécessite une source. Écrire « aucun » pour la pure fiction.

Règles pour le style open :

  • Ne pas inventer de faits pour une histoire non-fictionnelle. Marquer les inconnues dans « Faits à vérifier ».
  • Ne pas copier d'œuvres existantes. Utiliser une structure et un vocabulaire originaux.
  • Respecter la langue et le ton de la configuration.

Enregistrer le brouillon

Enregistrer dans story.md avec cet en-tête, statut draft :

---
title : <titre provisoire>
status : draft
revision : 1
style : <id du style>
writer : <id du rédacteur ou "open">
config : <nom de la configuration>
---

Placer le texte en dessous de l'en-tête. Afficher l'histoire dans le chat.

Étape 5 : Confirmer ou réviser

Si l'utilisateur a apporté sa propre histoire à l'Étape 1, l'enregistrer d'abord sous story.md avec l'en-tête ci-dessus (style : user).

Demander : approuver, ou demander des modifications. Poser la question dans un nouveau message après l'histoire. Ne pas placer la question à l'intérieur de la sortie d'une compétence de rédacteur.

  • Modifications demandées. Les appliquer. Si une compétence de rédacteur a produit le texte, respecter ses règles (format, ton, honnêteté) tout en éditant. Augmenter revision. Montrer ce qui a changé en deux ou trois lignes, puis afficher l'histoire mise à jour. Demander à nouveau.
  • Question ou doute. Y répondre. Proposer une modification si la réponse révèle un problème.
  • Veut une histoire différente. Revenir à l'Étape 2. Conserver l'ancien fichier sous story.rev<N>.md.
  • Approuver. Nécessite un « oui » explicite. Le silence, « ça a l'air bien jusqu'ici » ou « ok mais... » ne constitue pas une approbation. En cas de doute, poser une question directe : « Verrouiller cette histoire ? »

Boucler jusqu'à approbation. Ne pas brusquer l'utilisateur.

Étape 6 : Verrouiller

  1. Définir status : approved dans le front matter de story.md. Ajouter approved : <date ISO>.
  2. Mettre à jour project.json : définir "stage" : "story-approved".
  3. Indiquer à l'utilisateur le chemin du fichier. Dire que l'étape de l'histoire est terminée.
  4. Proposer de continuer avec long-video-assets (personnages, environnements, objets et style). Ne démarrer que si l'utilisateur est d'accord.

Règles

  • Ne jamais marquer une histoire comme approuvée sans un « oui » explicite.
  • Ne jamais modifier une histoire approuvée silencieusement. La réouverture nécessite une demande de l'utilisateur, et remet le statut à draft.
  • Ne jamais sauter la question du style lorsque Claude écrit l'histoire.
  • Never appeler une compétence de style qui n'est pas installée.
  • Garder les propositions et les révisions courtes. N'afficher le texte complet que pour l'histoire elle-même.

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