Communitygithub.com

long-video-story

Definir e aprovar a história de um vídeo longo. O usuário pode fornecer uma história ou pedir que Claude a escreva, usando estilos narrativos.

O que é long-video-story?

Este é o segundo estágio do fluxo de trabalho de vídeos longos, focado exclusivamente na criação e aprovação da história. O agente primeiramente verifica se existe um projeto ativo e carrega suas configurações (duração, idioma, público, tom, formato). O processo é altamente interativo: se o usuário não tem uma história pronta, o agente pergunta qual estilo narrativo usar (como 'descoberta de nicho' ou 'perguntas provocativas') e, em seguida, chama a habilidade específica daquele estilo para gerar o conteúdo. Há suporte para estilos pré-definidos (que possuem suas próprias habilidades) e um estilo 'aberto' onde o próprio agente sugere pitches originais após algumas perguntas ao usuário. O fluxo só termina quando o usuário dá uma aprovação explícita, momento em que o arquivo story.md é travado com status 'approved' e o projeto avança para o próximo estágio (long-video-assets). A habilidade é projetada para Claude Code e ferramentas similares que operam via linha de comando, gerenciando arquivos no sistema de arquivos do usuário.

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

História de vídeo longo

Estágio 2 do fluxo de trabalho de vídeo longo. Saída: um story.md aprovado na pasta do projeto.

Este estágio termina apenas quando Claude e o usuário concordam com a história. Nenhum estágio posterior começa antes disso.

Antes de começar

  1. Encontre o projeto ativo: ~/.long-video/projects/<slug>/project.json. Se o usuário tiver vários, pergunte qual.
  2. Se não existir um projeto, execute long-video-setup primeiro.
  3. Carregue a configuração do projeto de ~/.long-video/configs/<nome-da-config>.json. Use-a para duração, idioma, público, tom, formato e abordagem visual. Não pergunte novamente o que a configuração já responde.
  4. Se story.md já existir com status draft, ofereça-se para continuar. Se o status for approved, pergunte se deseja reabri-lo.

Passo 1: Faça a pergunta inicial

Pergunte: "Você tem uma história, ou quer que eu escreva uma?"

  • Eu tenho uma história. O usuário cola ou descreve. Vá para o Passo 5.
  • Escreva uma para mim. Vá para o Passo 2.
  • Tenho uma ideia vaga. O usuário dá uma semente (tópico, tema, uma frase). Guarde-a, depois vá para o Passo 2.

Passo 2: Pergunte pelo estilo da história

Sempre pergunte isso quando Claude escrever a história. Não pule, e não escolha um estilo para o usuário.

  1. Leia references/story-styles.md. Verifique quais habilidades de estilo estão instaladas.
  2. Mostre os estilos disponíveis, cada um com sua descrição de uma linha. Sempre inclua open.
  3. Peça ao usuário para escolher um. Eles também podem descrever seu próprio estilo. Se o fizerem, trate como open com a descrição deles como instruções extras.
  4. Salve a escolha em project.json como "story_style": "<id>".

Passo 3: Obtenha o tópico

Siga o tipo do estilo escolhido.

  • ideias (por exemplo niche): chame a habilidade do estilo. Passe o resumo da configuração e qualquer semente. Ela retorna um tópico. Depois pergunte qual escritor usar (regra de pareamento do Passo 4 no registro).
  • writer (por exemplo questions): se o usuário tiver um tópico ou semente, use-o. Se não, peça um. Não sugira tópicos.
  • open: apresente ideias, como abaixo.

Estilo open: apresente ideias

  1. Se não houver semente, faça no máximo 3 perguntas curtas: área de interesse, algo a evitar, eventos reais ou fontes a usar.
  2. Escreva 4 pitches que se encaixem na configuração. Cada pitch tem: título, logline de uma frase, os primeiros 15 segundos como gancho, e por que funciona para este público.
  3. Faça os 4 pitches claramente diferentes entre si.
  4. Peça ao usuário para escolher um, combinar dois, pedir mais, ou dar uma nova direção. Repita até o usuário escolher.

Passo 4: Escreva a história

Chame o escritor.

  • Uma habilidade de escritor (por exemplo long-video-story-questions): chame-a com o tópico, a duração alvo, o idioma e o resumo da configuração. O formato de saída dela é o que vale. Não o molde para a estrutura padrão.
  • open: escreva a estrutura padrão abaixo.

Estrutura padrão (estilo open)

Combine com a duração alvo na configuração. Narração falada tem cerca de 150 palavras por minuto, então um vídeo de 15 minutos precisa de cerca de 2.250 palavras faladas. Não escreva o roteiro final agora. Escreva a história: o que acontece, em ordem, com detalhes suficientes para o usuário julgá-la.

  1. Título (provisório).
  2. Logline.
  3. Gancho. A abertura de 15 a 30 segundos.
  4. Esboço da história. Atos ou capítulos. Para cada um: o que acontece, o ponto de virada, parcela aproximada do tempo de duração.
  5. História completa. Recontagem em prosa, do início ao fim.
  6. Final e chamada para ação.
  7. Fatos a verificar. Liste cada afirmação factual que precisa de uma fonte. Escreva "nenhum" para ficção pura.

Regras para o estilo open:

  • Não invente fatos para uma história não ficcional. Marque desconhecidos em "Fatos a verificar".
  • Não copie obras existentes. Use estrutura e redação originais.
  • Mantenha o idioma e o tom da configuração.

Salve o rascunho

Salve em story.md com este cabeçalho, status draft:

---
title: <título provisório>
status: draft
revision: 1
style: <id do estilo>
writer: <id do escritor ou "open">
config: <nome da configuração>
---

Coloque o texto abaixo do cabeçalho. Mostre a história no chat.

Passo 5: Confirme ou revise

Se o usuário trouxe sua própria história no Passo 1, salve-a primeiro como story.md com o cabeçalho acima (style: user).

Pergunte: aprovar, ou solicitar alterações. Pergunte em uma nova mensagem após a história. Não coloque a pergunta dentro da saída de uma habilidade de escritor.

  • Alterações solicitadas. Aplique-as. Se uma habilidade de escritor fez o texto, mantenha suas regras (formato, tom, honestidade) ao editar. Aumente revision. Mostre o que mudou em duas ou três linhas, depois mostre a história atualizada. Pergunte novamente.
  • Pergunta ou dúvida. Responda-a. Ofereça uma mudança se a resposta mostrar um problema.
  • Quer uma história diferente. Volte ao Passo 2. Mantenha o arquivo antigo como story.rev<N>.md.
  • Aprovação. Precisa de um sim explícito. Silêncio, "parece bom até agora" ou "ok, mas..." não é aprovação. Se não estiver claro, faça uma pergunta direta: "Travar esta história?"

Repita até aprovação. Não apresse o usuário.

Passo 6: Travamento

  1. Defina status: approved no front matter de story.md. Adicione approved: <data ISO>.
  2. Atualize project.json: defina "stage": "story-approved".
  3. Diga ao usuário o caminho do arquivo. Informe que o estágio da história está concluído.
  4. Ofereça-se para continuar com long-video-assets (personagens, ambientes, objetos e estilo). Inicie apenas se o usuário concordar.

Regras

  • Nunca marque uma história como aprovada sem um sim explícito.
  • Nunca altere uma história aprovada silenciosamente. Reabrir precisa do pedido do usuário e define o status de volta para draft.
  • Nunca pule a pergunta do estilo quando Claude escrever a história.
  • Nunca chame uma habilidade de estilo que não esteja instalada.
  • Mantenha pitches e revisões curtas. Mostre o texto completo apenas para a história em si.

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.

Habilidades Relacionadas