Communitygithub.com

renderização-de-vídeo-longo

Montar o vídeo finalizado e executar o loop de revisão. Constrói a edição a partir dos clipes (ou imagens com movimentos de câmera), voz, trilhas sonoras e legendas, renderiza uma versão de revisão de baixa qualidade com números de cena e tempo embutidos para que o cliente possa revisá-la, coleta e aplica alterações (re-renderizando as revisões quantas vezes forem necessárias) e, quando o usuário aprova, renderiza o vídeo final em alta qualidade. Usa um editor de vídeo com CLI ou MCP (FilmCraft, EffectCraft ou outro) se houver um disponível e o usuário quiser, caso contrário, o renderizador ffmpeg incluso. Use após long-video-sound, ou quando o usuário pedir para renderizar, montar, exportar, pré-visualizar ou finalizar o vídeo.

O que é renderização-de-vídeo-longo?

Esta skill implementa o Estágio 9 do fluxo de trabalho de vídeo longo. Ela pega todos os componentes produzidos nas etapas anteriores (clipes de vídeo, imagens com movimentos de câmera, locução em áudio, trilhas sonoras e legendas) e os monta em um vídeo completo. Primeiro, ela constrói uma lista de edição (EDL) respeitando as durações exatas do roteiro aprovado e aplica regras para lidar com clipes mais longos ou mais curtos que a cena. Em seguida, renderiza versões de revisão de baixa qualidade com números de cena e tempo embutidos, permitindo que o cliente forneça feedback específico. Cada comentário de feedback é classificado e direcionado ao estágio apropriado (edição, imagem, voz, som ou roteiro), e a skill re-renderiza revisões até que o usuário aprove explicitamente uma versão. Finalmente, renderiza o vídeo final em alta qualidade com as especificações de resolução, codec e loudness definidas no projeto. Ela pode usar um editor de vídeo dedicado (como FilmCraft ou EffectCraft) via CLI ou MCP, se disponível, ou o renderizador ffmpeg incluso. A skill nunca renderiza o vídeo final sem aprovação explícita, nunca altera o roteiro aprovado sem permissão e nunca envia ou faz upload do vídeo sem solicitação 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-render

Perguntar na sua IA favorita

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

Documentação

Renderização de vídeo longo

Estágio 9 do fluxo de trabalho de vídeo longo. Saída: renders de revisão (baixa qualidade) até o usuário aprovar, depois um vídeo final em alta qualidade.

Uma cena significa um clipe do roteiro, numerado em ordem ao longo do vídeo, como nas etapas anteriores. Os números de cena são embutidos no vídeo de revisão, para que o revisor possa apontar para eles.

Antes de começar

  1. Encontre o projeto em ~/.long-video/projects/<slug>/. É necessário que video-script.md exista com status: approved.
  2. Carregue a configuração do projeto: resolução, proporção de aspecto, modo de legendas (visuals.captions), necessidades de loudness, plataforma.
  3. Verifique ffmpeg e ffprobe (ffmpeg -version). O renderizador incluso precisa de ffmpeg com libx264 e libass.
  4. Se render/ já existir, pergunte: continuar (liste as versões) ou reiniciar.

Etapa 1: Inventário

Verifique cada cena e liste o que existe:

ItemOndeUsado como
Clipe de vídeoclips/scene-<NNN>_clip.* (ou _take2 e posteriores, o que o usuário aprovou)A imagem da cena
Apenas imagensframes/scene-<NNN>_start.*Um still com movimento de câmera do roteiro (push-in, pull-out, pan)
Vozaudio/lines/scene-<NNN>_<speaker>_<NN>.*Narração e diálogo
Trilhas sonorassound/mix/sfx_track.wav, amb_track.wav, music_track.wavEfeitos, ambiente, música

Relate as lacunas em uma tabela curta. Uma cena sem clipe e sem imagem é um bloqueador: liste essas cenas e ofereça voltar para long-video-keyframes ou long-video-clips. Voz ou som faltando são permitidos apenas se o usuário optou por pular essas etapas. Se uma etapa foi pulada, não peça novamente.

Se a etapa de clipes foi pulada (clips_mode: images-only), toda cena se torna um still com movimento de câmera extraído do roteiro.

Etapa 2: Escolha a ferramenta de montagem

  1. Verifique se há um editor de vídeo que Claude possa usar: um servidor MCP de edição conectado nesta sessão, ou uma CLI no dispositivo (FilmCraft: filmcraft-cli commands; EffectCraft: effectcraft-cli --help). Consulte ../long-video-sound/references/tools.md, seção 5.
  2. Se houver um disponível, pergunte: usar (o usuário pode abrir o projeto e ajustá-lo) ou usar o renderizador incluso. Padrão: renderizador incluso. Se o usuário escolher o editor, leia sua lista de comandos e documentação primeiro, trabalhe em uma cópia, peça permissão antes de instalar ou compilar qualquer coisa e mantenha os mesmos nomes de arquivo.
  3. Diga qual ferramenta será usada.

O restante desta skill descreve o renderizador incluso. Com um editor, faça os mesmos passos através de seus comandos e exporte os arquivos de revisão e final para as mesmas pastas e nomes.

Etapa 3: Construir a lista de edição

Leia references/edl-format.md. Escreva render/edl.json a partir dos arquivos do projeto:

  • uma entrada por cena com sua duração (do roteiro, ou o comprimento real do clipe quando menor ou maior dentro da duração da cena), origem da imagem, movimento de câmera para stills e transição de saída,
  • posicionamentos de voz: o tempo de início da cena mais um pequeno offset (0,3 s por padrão), linhas em ordem com pequenas lacunas,
  • as trilhas sonoras,
  • legendas a partir do texto da voz (início e fim da duração de cada arquivo de voz), se a configuração pedir legendas,
  • largura, altura e fps da configuração. O fps padrão é 24. O alvo de loudness padrão é -14 LUFS com pico verdadeiro abaixo de -1,5 dBTP.

Regras:

  • Use as durações exatas das cenas do roteiro aprovado. Não estique ou encurte a história para caber.
  • Um clipe mais longo que sua cena é cortado do final. Um clipe mais curto que sua cena mantém seu último quadro. Relate ambos.
  • Uma linha de voz que ultrapassa o final da cena, ou o final do vídeo, é relatada como um aviso.
  • Transições: cut por padrão. fade (escurecimento) apenas onde o roteiro diz. Cross-dissolves precisam de uma ferramenta de editor.
  • Verifique o plano antes de renderizar: node <pasta da skill>/scripts/build-render.mjs render/edl.json review render/review --plan.

Mostre um resumo curto: número de cenas, tempo total de execução contra o alvo, clipes versus stills, avisos. Corrija problemas que podem ser corrigidos sem mudar a história. Pergunte ao usuário sobre qualquer coisa que não possa.

Etapa 4: Renderizar a versão de revisão

Qualidade de revisão: baixa resolução (cerca de 360p), alta compressão, número de cena e tempo embutidos no canto superior esquerdo e legendas se a configuração usar legendas embutidas.

node <pasta da skill>/scripts/build-render.mjs render/edl.json review render/review --version 1
  • Saída: render/review/<slug>_review_v1.mp4, mais um .report.json com duração, tamanho e loudness.
  • Segmentos de cena são armazenados em cache. Revisões posteriores re-renderizam apenas as cenas alteradas, portanto são muito mais rápidas.
  • Para vídeos com mais de alguns minutos, execute o comando em segundo plano e aguarde sua conclusão. Não faça polling.
  • Se o modo de legendas for srt, um arquivo .srt é escrito ao lado do vídeo.

Verifique o relatório: duração real versus a planejada, loudness, streams. Em seguida, informe ao usuário o caminho completo e o tamanho.

Diga como revisar: assista ao arquivo, anote o número da cena e o tempo mostrados no canto com cada comentário. Claude não envia ou faz upload do arquivo. O usuário o compartilha com o cliente. Ofereça-se para preparar um upload apenas se o usuário pedir, e pergunte primeiro.

Etapa 5: Coletar alterações

Pergunte: "Alguma alteração? Se estiver finalizado, diga e eu renderizarei a versão de alta qualidade."

O usuário pode colar o feedback do cliente. Leia references/review-feedback.md. Para cada comentário:

  1. Encontre o número da cena ou o tempo ao qual ele se refere. Se o comentário for vago, faça uma pergunta curta.
  2. Classifique-o e escolha a rota:
    • Nível de edição (corte, duração, ordem, texto da legenda, legendas ativadas ou desativadas, transição, níveis de voz, música ou efeitos): corrija aqui no edl.json ou no ganho das trilhas.
    • Imagem de uma cena (aparência, personagem, composição, movimento): volte para long-video-keyframes ou long-video-clips para essas cenas. Novos arquivos recebem nomes com estilo _take2. Em seguida, atualize a lista de edição.
    • Linha de voz (entrega, pronúncia, redação): long-video-voice para essas linhas. Uma alteração de redação no roteiro aprovado precisa da aprovação do usuário e de uma revisão do roteiro.
    • Som (efeito, ambiente, música): long-video-sound para essas pistas, depois mixe novamente.
    • História ou estrutura (adicionar ou remover cenas): long-video-director, depois refaça apenas as cenas afetadas a jusante.
  3. Escreva a lista em render/review-log.md com a versão, cena, solicitação, rota e status.
  4. Mostre ao usuário o plano em uma tabela curta. Peça um sim antes de qualquer regeneração que custe créditos ou tempo.
  5. Aplique as alterações, depois renderize a próxima revisão (--version 2, e assim por diante). Mantenha todos os arquivos de revisão anteriores.
  6. Informe ao usuário o que mudou, cena por cena, e o novo caminho do arquivo.

Repita até o usuário aprovar. Silêncio ou "parece bom até agora" não é aprovação.

Etapa 6: Renderizar o vídeo final

Somente após o usuário dizer explicitamente que uma versão de revisão específica é final.

  1. Confirme: "Renderizar o final a partir da revisão v?" Verifique se a lista de edição corresponde a essa versão e se nenhuma solicitação de alteração ainda está aberta no registro de revisão.
  2. Qualidade final: resolução da configuração, H.264 de alta qualidade (crf 18, preset lento), AAC 192k, normalização de loudness em duas passagens para o alvo, sem rótulos de revisão. Legendas são embutidas apenas se a configuração disser "burned-in". Caso contrário, um arquivo .srt é escrito.
  3. Execute, em segundo plano para vídeos longos:
node <pasta da skill>/scripts/build-render.mjs render/edl.json final render/final
  1. Verifique com o relatório e ffprobe: duração corresponde ao plano, resolução e fps estão corretos, há um fluxo de vídeo e um de áudio, loudness está próximo do alvo (dentro de cerca de 1 LU) e o pico verdadeiro está abaixo de -1 dBFS.
  2. Opcionalmente, verifique se há quadros pretos inesperados e silêncio longo: ffmpeg -i ARQUIVO -vf blackdetect=d=0.5 -af silencedetect=noise=-50dB:d=3 -f null -. Relate as descobertas.
  3. Atualize project.json: "stage": "final-rendered", "final_video": "<caminho>" e a versão de revisão aprovada.
  4. Informe ao usuário o caminho completo, tamanho e duração. Lembre-o dos créditos em sound/credits.md para a descrição do vídeo.
  5. Ofereça-se para continuar com long-video-publish (opções de título do YouTube, descrição, tags e prompt de miniatura). Inicie apenas se o usuário concordar. Não publique ou faça upload. Não inicie nenhum outro estágio posterior, a menos que o usuário peça e esse estágio exista.

Regras

  • Nunca renderize o final sem uma aprovação explícita de uma versão de revisão específica.
  • Nunca altere o roteiro aprovado. Se o feedback precisar, direcione-o e pergunte.
  • Nunca envie, compartilhe ou faça upload de um vídeo sem uma solicitação clara do usuário.
  • Nunca exclua renders de revisão anteriores.
  • Nunca regenere imagens, clipes, voz ou som sem o sim do usuário no plano.
  • Mantenha as mensagens de chat curtas. Coloque a lista de alterações em render/review-log.md.

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