Communitygithub.com

long-video-keyframes

Cria a imagem do quadro inicial e final para cada cena (clipe) do roteiro de vídeo aprovado. Escreve um prompt de imagem por quadro com um nome de arquivo fixo que contém o número da cena e a indicação de início ou fim, cria uma pasta para as imagens e pode gerar as imagens com uma ferramenta de imagem disponível, ou entregar os prompts ao usuário de uma vez ou um por um. Use após o long-video-director, ou quando o usuário solicitar quadros iniciais, quadros finais, quadros-chave ou imagens de cena.

O que é long-video-keyframes?

Este estágio 5 do fluxo de trabalho de vídeos longos gera prompts de imagem e arquivos de imagem para os quadros inicial e final de cada cena (clipe) do roteiro aprovado. Ele constrói prompts auto-contidos para geradores de imagem baseados no roteiro, no guia de estilo visual e na bíblia visual do projeto, garantindo consistência visual em todo o vídeo. O stage suporta três modos de entrega: apenas prompts (o usuário gera as imagens), Claude gera as imagens, ou ambos. O usuário pode receber os prompts em lote ou um por um, com verificações automáticas de qualidade, referências a imagens de personagens e ambientes dos estágios anteriores, e um arquivo de status para acompanhar o progresso. O nome do arquivo fixo (ex.: scene-007_start.png) e a estrutura de pastas padronizada facilitam a integração com ferramentas de edição de vídeo posteriores como long-video-clips.

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

Perguntar na sua IA favorita

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

Documentação

Quadros-chave de vídeo longo

Estágio 5 do fluxo de trabalho de vídeo longo. Saída: um prompt de imagem para o quadro inicial e o quadro final de cada cena, uma pasta frames/ e, opcionalmente, as imagens finalizadas.

Neste estágio, uma cena significa um clipe do roteiro (um plano, no máximo 10 segundos). As cenas são numeradas em ordem em todo o vídeo.

Antes de começar

  1. Localize o projeto em ~/.long-video/projects/<slug>/. Exija video-script.md com status: approved. Se não estiver aprovado, pare e execute long-video-director.
  2. Exija film-style.md e visual-bible.md. Eles contêm a aparência da câmera e iluminação e o estilo artístico definido.
  3. Carregue a configuração do projeto: proporção de aspecto, resolução, provedor de imagem, nível de aprovação, orçamento.
  4. Verifique images/ para as imagens de personagem, ambiente e objeto de long-video-assets. Elas servem como referências. Se estiverem faltando, informe. Continue apenas se o usuário concordar em escrever prompts sem elas.
  5. Se frames/ ou frame-prompts/ já existirem, pergunte: continuar (liste o que está feito) ou reiniciar.

Passo 1: Numerar as cenas

  1. Leia o roteiro em ordem. Atribua a cada plano um número de cena: 1, 2, 3, e assim por diante, em todo o vídeo. Preencha com 3 dígitos (scene-001) ou 4 dígitos se houver mais de 999.
  2. Construa o mapa do número da cena para o ID do plano do roteiro (por exemplo, cena 7 é o plano 2.3 do roteiro).
  3. Marque clipes de continuação (Continues: no roteiro). Para estes, o quadro inicial é o quadro final da cena anterior. Não escreva um novo prompt inicial. O índice aponta para a imagem final anterior.
  4. Conte as imagens: duas por cena, menos os quadros iniciais reutilizados. Informe o total ao usuário.

Passo 2: Escrever os prompts dos quadros

Leia references/frame-prompt-templates.md. Escreva dois prompts por cena (um para uma cena de continuação).

Para cada quadro, deduza do plano do roteiro:

  • Quadro inicial. O que o primeiro quadro do clipe mostra: a primeira posição da câmera, as poses e posições iniciais dos personagens, a iluminação naquele momento.
  • Quadro final. O que o último quadro mostra: para onde a câmera se moveu (por exemplo, mais próximo após um push-in), como a ação terminou, qualquer mudança na luz. Deve ser alcançável a partir do quadro inicial na duração do plano. Se a câmera estiver estática e nada se mover, o quadro final é a mesma composição com uma pequena mudança natural (um gesto, uma mudança de luz).
  • Ambos os quadros mostram o mesmo lugar, personagens e objetos, com a mesma configuração de câmera, a menos que o plano mova a câmera.

Regras para cada prompt:

  1. Autocontido. Sem "igual ao anterior". Inclua tudo que o gerador precisa.
  2. Bloco de estilo textual. Copie exatamente o bloco de estilo e os termos negativos de visual-bible.md. Adicione a "linha de prompt para geradores" do estilo de filme. Adicione câmera, lente e iluminação do plano.
  3. Descrições de entidades textuais. Copie cada descrição de personagem, ambiente e objeto da bíblia visual. Nunca parafraseie.
  4. Referências. Liste os arquivos de imagem a anexar: imagem e ficha do personagem, imagem do ambiente, objetos. Para um quadro final, liste o próprio quadro inicial da cena como primeira referência. Use os nomes de arquivo exatos.
  5. Mesmo enquadramento. Use a proporção de aspecto da configuração em cada prompt.
  6. Sem texto na imagem. Sem legendas, subtítulos, logotipos ou placas com texto legível, a menos que a história exija.
  7. Sem nomes de pessoas reais, marcas registradas ou nomes de artistas vivos.

Salve os prompts em frame-prompts/, em arquivos em lote de 20 cenas: scenes-001-020.md, scenes-021-040.md, e assim por diante. Escreva também frame-prompts/index.md (formato nos modelos).

Passo 3: Nomes de arquivos e pastas

Crie frames/ na pasta do projeto. Nunca coloque imagens em outro lugar.

Os nomes dos arquivos são fixos e aparecem no cabeçalho de cada prompt:

  • scene-<número>_start.png
  • scene-<número>_end.png

Exemplos: scene-007_start.png, scene-007_end.png. Qualquer extensão funciona (png, jpg, webp), mas o nome base deve corresponder. O nome contém o número da cena e a palavra start ou end, para que cada quadro possa ser encontrado pelo nome e seja ordenado.

Passo 4: Perguntar o que o usuário deseja

Pergunte: "O que você deseja deste estágio?"

  • Apenas prompts. O usuário cria as imagens com sua própria ferramenta.
  • Imagens. Claude gera as imagens.
  • Ambos. O usuário recebe os prompts e Claude também gera as imagens.

Os arquivos de prompt são sempre salvos. Essa escolha decide quem faz as imagens.

Em seguida, pergunte como entregar: tudo de uma vez, ou um por um.

Apenas prompts

  • Tudo de uma vez. Mostre o caminho completo de frames/ e de frame-prompts/. Mostre como os nomes dos arquivos funcionam, com um exemplo. O usuário abre os arquivos em lote e trabalha neles. Ofereça-se para verificar a pasta mais tarde.
  • Um por um. Mostre o primeiro prompt no chat com seu nome de arquivo e referências a anexar. Aguarde o usuário dizer que foi salvo. Verifique se o arquivo existe em frames/ com o nome correto. Em seguida, mostre o próximo prompt. Se o usuário disser "pular" ou "parar", salve a posição em frames/status.md e pare.

Verifique a pasta sempre que o usuário solicitar, ou no final: compare os arquivos encontrados com o índice e liste o que está faltando ou com nome incorreto.

Imagens ou ambos

Leia ../long-video-assets/references/image-generation.md e siga suas etapas para encontrar um método, lidar com a opção de navegador, ordenação, verificações e status. Use o método salvo na configuração, se houver. Mudanças para este estágio:

  • Contagem e custo. Informe ao usuário quantas imagens são necessárias e o tempo ou custo aproximado. Pergunte antes de iniciar um lote grande. Ofereça-se para começar com um intervalo, por exemplo, cenas 1 a 10.
  • Teste de estilo. Gere scene-001_start primeiro. Mostre. Pergunte se corresponde ao estilo definido e à aparência do personagem. Corrija os prompts antes de continuar.
  • Ordem. Para cada cena: quadro inicial, depois quadro final (o quadro final usa o quadro inicial como referência quando o método suporta). Depois a próxima cena.
  • Referências. Anexe as imagens de personagem, ambiente e objeto listadas no prompt. Se o método aceitar apenas uma referência, use a mais importante (o personagem principal no quadro) e informe.
  • Tudo de uma vez ou um por um. Tudo de uma vez: gere todo o intervalo, depois mostre os resultados. Um por um: mostre cada par, aguarde aprovação ou solicitação de refazer, depois continue.
  • Opção de navegador. Mesmas regras do estágio de ativos: confirmação explícita da contagem, tempo e pasta de download primeiro. Nunca insira senhas ou resolva CAPTCHAs.
  • Verificações. Após cada imagem, verifique o assunto, a correspondência de estilo, a aparência do personagem em relação às referências e a diferença entre os quadros inicial e final. No máximo 2 tentativas, depois marque needs-manual.
  • Nunca sobrescrever. Nunca sobrescreva um quadro existente sem perguntar.

Se a geração falhar ou o usuário recusar, volte para o caminho apenas de prompts para as cenas restantes.

Passo 5: Status e finalização

  1. Mantenha frames/status.md atualizado:
| Cena | Quadro | Arquivo | Status | Nota |
|------|--------|---------|--------|------|
| 001 | start | scene-001_start.png | done | |
| 001 | end | scene-001_end.png | pending | |

Valores de status: pending, done, needs-manual, skipped.

  1. Atualize project.json: "stage": "frames-prompts-done" após os prompts serem salvos, e "stage": "frames-images-done" quando cada quadro existir e o usuário aprovar o conjunto.
  2. Informe ao usuário os caminhos de frames/ e frame-prompts/, e o que ainda está faltando.
  3. Ofereça-se para continuar com long-video-clips (clipes de vídeo a partir dos quadros, ou pular e usar apenas imagens). Inicie apenas se o usuário concordar. Não inicie nenhum outro estágio posterior, a menos que o usuário solicite e esse estágio exista.

Autoverificação antes de salvar os prompts

  • Cada cena tem um prompt final. Cada cena não-contínua tem um prompt inicial.
  • Cada prompt tem o nome do arquivo em seu cabeçalho, correspondendo à regra de nomenclatura.
  • Cada prompt contém o bloco de estilo, termos negativos e linha de prompt do filme textualmente.
  • Cada personagem, ambiente e objeto no plano aparece com sua descrição textual e seus arquivos de referência listados.
  • Os quadros inicial e final de uma cena concordam em local, personagens e iluminação, e diferem na forma como o plano diz.
  • A contagem de prompts corresponde à contagem prometida ao usuário.

Regras

  • Nunca comece sem um roteiro aprovado.
  • Nunca gere imagens antes de o usuário escolher "imagens" ou "ambos".
  • Nunca renomeie uma imagem ou um nome de arquivo de prompt após os prompts serem aprovados.
  • Nunca solicite chaves de API no chat.
  • Mantenha as mensagens de chat curtas. Coloque o texto completo do prompt em arquivos e mostre apenas amostras ou o prompt atual.

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.

Habilidades Relacionadas