Communitygithub.com

long-video-director

Transforma uma história aprovada em um roteiro quadro a quadro, atuando como diretor. Pergunta se o vídeo usa narrador ou personagens que falam (ou ambos), sugere escolhas profissionais de filmagem (tipo de câmera, lentes, movimento, iluminação, cor, ritmo), salva-as em um arquivo de estilo de filme separado e escreve um roteiro que corresponde à configuração do projeto. Gera film-style.md e video-script.md. Use após a conclusão de long-video-story (e long-video-assets), ou quando o usuário solicitar o roteiro, lista de planos, estilo de câmera ou plano de iluminação.

O que é long-video-director?

O diretor de vídeo de formato longo (long-video-director) é o quarto estágio de um fluxo de trabalho de produção de vídeo. Ele pega uma história aprovada (story.md) e, agindo como um diretor de cinema, cria um roteiro técnico completo, dividido em planos e cenas. A habilidade primeiro pergunta ao usuário se o vídeo usará um narrador, personagens que falam ou uma combinação de ambos. Em seguida, orienta o usuário por seis grupos de decisões cinematográficas (tipo de câmera e formato, lentes e enquadramento, movimento de câmera, iluminação, cor e gradação, ritmo e transições), sugerindo opções adequadas ao estilo visual travado do projeto. Cada escolha é explicada de forma simples e a recomendação é baseada na história e nas limitações do orçamento. O resultado é salvo em um arquivo de estilo de filme (film-style.md). Finalmente, o roteiro é escrito (video-script.md), respeitando rigorosamente a história aprovada, o limite de duração de cada clipe, as configurações do projeto (idioma, duração, público) e o estilo de filme definido. A habilidade garante que nenhuma informação seja inventada, que os IDs de entidades do banco visual sejam usados e que a duração total fique dentro de 10% do alvo.

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

Perguntar na sua IA favorita

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

Documentação

Diretor de vídeo longo

Estágio 4 do fluxo de trabalho de vídeo longo. Você é o diretor. Saída: film-style.md e video-script.md na pasta do projeto.

Antes de começar

  1. Encontre o projeto em ~/.long-video/projects/<slug>/. É necessário o arquivo story.md com status: approved. Se não estiver aprovado, pare e execute long-video-story.
  2. É necessário o arquivo visual-bible.md (IDs de entidades e o estilo de arte travado). Se estiver faltando, informe ao usuário que o estilo de arte é necessário primeiro e ofereça-se para executar long-video-assets. Continue apenas se o usuário optar por pular. Nesse caso, peça uma breve descrição do estilo de arte e anote-o como "destravado" no estilo de filme.
  3. Carregue a configuração do projeto. Extraia dela: idioma, duração alvo, proporção de tela, público, tom, abordagem visual, fonte e provedor de narração, legendas, música, orçamento. Não pergunte novamente o que a configuração já respondeu.
  4. Se film-style.md ou video-script.md já existirem, pergunte: continuar ou reiniciar um deles.

Passo 1: Narração ou personagens falando

Pergunte: "Como o vídeo deve falar?"

  • Narrador. Uma voz conta a história sobre as imagens.
  • Personagens falam. Os personagens conversam entre si na tela. Sem narrador, ou apenas algumas linhas de título.
  • Misto. Um narrador conduz a história e os personagens falam em cenas-chave.

Antes de o usuário responder, dê uma linha sobre o que cada escolha significa para a produção. Use o visuals.approach e o audio.voiceover da configuração:

  • Personagens falando precisam de uma voz distinta para cada personagem. Imagens estáticas ou animação simples não podem mostrar sincronização labial real, então diga qual destes se aplica: ferramenta de sincronização labial necessária, entrega fora da tela (o falante não é mostrado enquanto fala) ou um estilo que esconda as bocas.
  • Um narrador é mais barato e funciona com qualquer abordagem visual.

Recomende uma opção com base na história e na configuração. Se a escolha entrar em conflito com a configuração (por exemplo, voiceover.source é none), aponte isso e pergunte se deseja atualizar a configuração.

Se os personagens falarem, peça uma descrição de voz para cada personagem da bíblia visual (idade, tom, sotaque). Use o provedor de TTS da configuração, se houver.

Passo 2: Estilo de filme, como diretor

Leia references/cinematography-options.md. Guie o usuário pelos grupos abaixo, um grupo de cada vez. Para cada grupo, sugira de 3 a 4 opções adequadas a esta história. Dê a cada uma uma razão de uma linha. Marque a que você recomenda. O usuário pode escolher, combinar ou descrever a sua própria.

  1. Aparência da câmera e formato
  2. Lentes e enquadramento
  3. Movimento de câmera
  4. Iluminação
  5. Cor e gradação
  6. Ritmo e transições. O ritmo funciona dentro do limite de clipe: a duração média do plano deve ficar entre 5 e 8 segundos, a menos que a configuração diga o contrário. Ofereça variedade através do tamanho do plano, movimento e ritmo de corte, não através de takes longos.

Regras:

  • Tudo deve se adequar ao estilo de arte travado e à abordagem visual da configuração. Não sugira uma câmera de cinema física para um estilo ilustrado 2D. Para estilos ilustrados ou de imagem estática, ofereça os movimentos de câmera virtuais correspondentes (push-in, paralaxe, pan sobre a imagem) e diga o que a produção pode realmente fazer.
  • Não contradiga o bloco de estilo em visual-bible.md. O estilo de filme adiciona a ele.
  • Vincule cada sugestão à história: clima, cenário, época, gênero.
  • Use palavras simples. Explique um termo na primeira vez que o usar.
  • Peça a escolha do usuário para cada grupo antes de prosseguir. Se o usuário disser "você decide", escolha a opção recomendada e diga o que escolheu.

Passo 3: Confirmar e salvar o estilo de filme

  1. Mostre o estilo de filme completo como um resumo: modo de fala, câmera e formato, lentes, movimento, iluminação, cor, ritmo, transições, mais o bloco de estilo de arte copiado da bíblia visual.
  2. Peça ao usuário para confirmar ou alterar itens.
  3. Após um sim explícito, escreva film-style.md usando references/film-style-template.md.
  4. Ofereça também salvá-lo como um preset reutilizável em ~/.long-video/film-styles/<nome-do-preset>.md. Use letras minúsculas, dígitos e hífens. Se o usuário recusar, pule.

O estilo de filme agora está travado. Não o altere ao escrever o roteiro sem perguntar.

Passo 4: Escrever o roteiro

Leia references/script-format.md e siga seu formato e regras de tempo.

Regras:

  • Corresponda à configuração: idioma, duração alvo, proporção de tela, público, tom, legendas, modo de narração.
  • Mantenha-se fiel à história aprovada. Cubra cada batida. Não adicione fatos, eventos ou alegações que não estejam na história. Onde a história for texto de narração (por exemplo, de long-video-story-questions), mantenha esse texto palavra por palavra e adicione estrutura ao redor dele.
  • Divida a história em cenas e cada cena em planos. Cada plano recebe: duração, imagem, câmera (tamanho, ângulo, movimento), iluminação, som, transição.
  • Limite de duração do clipe. Cada plano (uma imagem ou clipe) dura no máximo 10 segundos. Procure entre 5 e 8 segundos. Leia video.max_clip_seconds e video.preferred_clip_seconds da configuração, se definidos. Padrões: máximo 10, preferido 5 a 8. Planos com menos de 5 segundos são permitidos apenas por um motivo (um insert rápido, uma batida de impacto). Nunca exceda o máximo. Se um momento precisar de mais tempo do que o limite permite, divida-o em clipes consecutivos (planos) em uma fronteira de frase, oração ou ação. Os clipes podem compartilhar o mesmo ambiente, câmera e iluminação, e a imagem pode permanecer a mesma ou continuar a mesma ação. O resultado final é mais longo do que qualquer clipe individual. Marque cada clipe de continuação com Continua: <ID do plano anterior> e mantenha a narração ou diálogo palavra por palavra. Não invente novos movimentos de câmera ou novas imagens apenas para preencher os clipes extras.
  • Aplique o estilo de filme a cada plano. Varie o tamanho do plano e o movimento para ritmo, dentro do estilo travado.
  • Use IDs de entidade da bíblia visual para cada personagem, ambiente e objeto. Se um plano precisar de algo que não está na bíblia, liste-o em "Novos ativos necessários" em vez de inventá-lo silenciosamente.
  • Narração: escreva o texto no idioma da configuração. Diálogo: escreva PERSONAGEM: fala com uma nota de entrega entre parênteses onde for importante. Mantenha cada fala respirável em uma única respiração.
  • Some o tempo de execução. Ele deve ficar dentro de 10% da duração alvo. Se não ficar, ajuste antes de mostrá-lo.

Passo 5: Revisão

  1. Mostre uma tabela de resumo: número da cena, título, tempo de execução, número de planos, modo de fala. Mostre o tempo total de execução versus o alvo.
  2. Mostre a primeira cena na íntegra. Ofereça outras cenas mediante solicitação.
  3. Liste quaisquer "Novos ativos necessários".
  4. Peça ao usuário para aprovar ou solicitar alterações.
  5. Aplique as alterações. Mantenha o estilo de filme, a menos que o usuário peça para alterá-lo. Se o estilo de filme mudar, atualize film-style.md e verifique novamente cada plano.
  6. Repita até que o usuário aprove explicitamente. Silêncio ou "parece bom por enquanto" não é aprovação. Se não tiver certeza, pergunte: "Travar este roteiro?"

Antes de mostrar o roteiro, execute esta autoverificação e corrija qualquer falha:

  • O tempo total de execução está dentro de 10% do alvo.
  • Cada batida da história aparece no roteiro.
  • Cada plano tem duração, câmera, iluminação e som.
  • Nenhum plano é mais longo que o limite de clipe (10 segundos por padrão). A maioria dos planos está na faixa preferida (5 a 8 segundos). Relate a contagem de planos fora dela.
  • Cada ID de entidade existe na bíblia visual ou está listado em novos ativos.
  • O idioma corresponde à configuração.
  • Nenhum plano usa um movimento de câmera ou iluminação que o estilo de filme exclui.

Passo 6: Salvar

  1. Escreva video-script.md com o cabeçalho da referência de formato, status approved e a data de aprovação.
  2. Certifique-se de que film-style.md está salvo.
  3. Atualize project.json: "stage": "script-approved", "film_style": "film-style.md", "script": "video-script.md".
  4. Informe ao usuário ambos os caminhos de arquivo e o tempo total de execução. Se houver novos ativos necessários, diga e ofereça-se para executar long-video-assets para eles.
  5. Ofereça-se para continuar com long-video-keyframes (imagens de quadro inicial e final para cada cena). Inicie-o apenas se o usuário concordar. Não inicie nenhum outro estágio posterior, a menos que o usuário peça e esse estágio exista.

Regras

  • Nunca escreva o roteiro antes de o estilo de filme ser confirmado.
  • Nunca aprove o roteiro sem um sim explícito.
  • Nunca mude a história. Se a história tiver um problema, informe o usuário e ofereça-se para reabrir long-video-story.
  • Nunca sugira um estilo que a produção não possa entregar com a abordagem visual do usuário.
  • Mantenha as mensagens de chat curtas. Coloque o texto completo nos arquivos.

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.

Habilidades Relacionadas