Communitygithub.com

film-edit

Transforme clipes aprovados em um filme finalizado no corte do cineasta — registre a filmagem, transforme anotações de corte em uma lista de decisões de edição, monte na ordem da tabela de cenas, ajuste o ritmo em finais de frases, pausas e batidas, execute receitas testadas do ffmpeg (cortar, juntar, reenquadrar, acelerar, folhas de contato, legendas), entregue a linha do tempo a um editor como FCPXML, crie e traduza legendas, corrija clipes finalizados, faça upscale por último e construa arquivos de entrega com divulgação de IA e créditos; uploads apenas quando solicitado, privado por padrão. Use quando o usuário disser "montar o corte", "aplicar minhas anotações de corte", "cortar este clipe", "cortar na batida", "juntar estes clipes", "tornar vertical", "folha de contato", "queimar legendas", "traduzir as legendas", "exportar para Final Cut", "fazer upscale", "entregar o filme" ou "fazer upload". Não é para títulos, letreiros inferiores, type cinético ou legendas animadas desenhadas em código (motion-graphics), narração, música, mixagem ou loudness (film-sound), ou geração de cenas e imagens estáticas (cinematic-shots). A correção de cor ainda não está coberta.

O que é film-edit?

Esta skill transforma clipes de vídeo aprovados em um filme finalizado, seguindo o fluxo de trabalho profissional de edição: desde a inspeção e registro da filmagem até a montagem na ordem da tabela de cenas, aplicação de anotações de corte como decisões de edição, ajuste de ritmo em pausas, finais de frases e batidas musicais, e aplicação de receitas testadas do ffmpeg para cortar, juntar, reenquadrar e gerar folhas de contato. Ela também gera legendas e traduções, prepara arquivos de entrega com divulgação obrigatória de uso de IA e créditos, e pode exportar a linha do tempo como FCPXML para finalização em um editor profissional. A skill prioriza a preservação do original, nunca sobrescrevendo ou deletando arquivos, e sempre pedindo permissão antes de qualquer etapa paga ou publicação. Funciona como um assistente que executa as instruções do cineasta, mantendo um registro de produção detalhado e garantindo que todos os direitos e consentimentos sejam respeitados, sendo adequada para uso com agentes de IA como Claude Code, Cursor ou Codex.

Funciona com~Claude Code~Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/nikbearbrown/agentic-filmmaking/tree/HEAD/skills/film-edit

Perguntar na sua IA favorita

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

Documentação

Edição de filme

O cineasta corta; o agente segura a linha do tempo. Esta skill transforma clipes aprovados em um filme finalizado e honestamente rotulado. O trabalho é ffmpeg puro: comandos testados estão em ffmpeg-recipes.md, e o registro da filmagem, a lista de decisões de edição, o registro de produção, a lista de verificação de entrega, o modelo de créditos e um esqueleto de FCPXML estão em edit-sheets.md.

Regras para cada etapa

  • O cineasta conduz; o agente toca. O agente monta, mede, propõe e renderiza. O que manter, cortar, segurar, trocar ou reordenar é a decisão do usuário. Quando uma escolha estiver em aberto (qual take, cortar à esquerda ou à direita, acelerar ou cortar), ofereça as opções com o que cada uma custa.
  • O +1 é intenção, não gosto. Se o corte se desviar do que o usuário disse que queria (uma anotação que não pôde ser aplicada exatamente, uma batida que perdeu sua reação), sinalize uma vez, deixe o usuário decidir e registre a decisão. Sua preferência não é um desvio.
  • Nunca sobrescrever, nunca deletar. Cada passagem escreve um novo arquivo numerado (corte-v4.mp4); as fontes são somente leitura. Use o -n do ffmpeg (recusar sobrescrever), não o -y, a menos que o usuário tenha pedido que aquele arquivo exato fosse substituído. Cortes antigos, takes fracos e clipes substituídos vão para uma pasta superseded.
  • Pergunte antes de gastar e antes de publicar. Antes de qualquer etapa paga (transcrição em nuvem, re-renderização generativa, um upscaler pago), informe a ferramenta, quantas e o custo estimado, e aguarde um sim. Uma re-renderização após um resultado rejeitado é um novo gasto: pergunte novamente. Silêncio não é um sim.
  • Direitos e consentimento. Filmagens, músicas e vozes que não são do usuário precisam de direitos; a semelhança ou voz de uma pessoa real precisa de seu consentimento. Baixar o vídeo de outra pessoa precisa da permissão do proprietário ou de uma licença; um aviso de termos de serviço não é permissão, então aguarde a resposta do usuário.
  • Mantenha um registro de produção: cada versão, as anotações aplicadas, as decisões do usuário e, para cada etapa paga, a ferramenta, o ID do trabalho e o custo. Registre um resultado gerado como mantido somente depois que o usuário o aprovar.

Onde esta skill termina

  • Títulos, letreiros inferiores, type cinético, legendas animadas ou por palavra, setas e mapas desenhados em código: motion-graphics. Esta skill coloca sua saída renderizada sobre o corte limpo.
  • Narração, diálogo, música, efeitos, mixagem e loudness: film-sound. Esta skill coloca a mixagem entregue sob a imagem bloqueada.
  • Cenas, imagens estáticas e clipes: cinematic-shots, incluindo uma cena que falta na cobertura.
  • Ainda não coberto: correção de cor. Deixe a cor como foi gerada, a menos que o usuário peça.

1. Inspecione e registre a filmagem antes de cortar

Inspecione antes de planejar: duração, taxa de quadros (r_frame_rate diferente de avg_frame_rate significa taxa variável), tamanho, formato de pixel e formato, fluxos de áudio. Clipes gerados frequentemente diferem de cena para cena, e alguns não têm som.

Registre cada clipe como um observador, não como um diretor: número da cena, arquivo, o que está no quadro, entrada e saída utilizáveis, onde linhas e ações completas começam e terminam, o momento que carrega a batida, problemas vistos. Mantenha o que você viu separado do que pode significar; escreva "incerto" em vez de inventar uma história. Medições são candidatas, não vereditos:

  • Uma folha de contato de vários quadros por clipe, rotulada com os tempos. Um quadro esconde um objeto fantasma ou um rosto que se move.
  • Candidatos a mudança de cena. Movimento, flashes e dissoluções também pontuam alto; verifique cada um em velocidade normal.
  • Janelas de silêncio, onde os cortes podem pousar. Uma lacuna em uma transcrição não é prova de silêncio.
  • Quadros perdidos: lacunas de carimbo de data/hora maiores que um quadro e meio.
  • Fala: para uma gravação longa, leia a transcrição primeiro, depois puxe quadros apenas onde a imagem importa.

2. Monte na ordem da tabela de cenas

O primeiro corte é mecânico: os clipes aprovados na ordem da tabela de cenas, cada um com sua entrada e saída registradas. É um rascunho para o usuário assistir.

  1. Normalize cada clipe para um formato: tamanho, pixels quadrados, taxa de quadros, formato de pixel, taxa de áudio e canais. Dê a um clipe sem som uma faixa silenciosa. Quando a proporção diferir, ajustar (barras) ou preencher (cortar) é a escolha do usuário.
  2. Junte por cópia de fluxo quando cada peça corresponder exatamente, caso contrário, com o filtro concat (uma re-codificação). Compare as durações de vídeo e áudio após a junção.
  3. Re-codifique o menor número possível de vezes: intermediários de alta qualidade, uma codificação de entrega no final.
  4. Mantenha o som próprio de cada clipe (mantenha a faixa ambiente do modelo de vídeo; nivelá-lo é trabalho do film-sound).
  5. Numere a versão, registre-a, faça uma folha de contato.

3. Anotações de corte tornam-se uma lista de decisões de edição

O usuário assiste e digita anotações em suas próprias palavras: cortar, trocar, segurar, cortar, mover. Cada anotação torna-se uma linha de uma lista de decisões de edição (EDL): número da anotação, as palavras do usuário na íntegra, cena, entrada e saída da fonte, ação, motivo, status. Os tempos permanecem em segundos da fonte; qualquer coisa na linha do tempo de saída (narração, legendas, marcadores) é re-temporizada após cada recorte.

  • Pergunte quando uma anotação for ambígua ("apertar o meio"): ofereça duas leituras concretas com timecodes.
  • Dê a cada linha um motivo: a batida que serve, por que entra e sai ali. Mantenha o momento que faz a batida pousar, não o evento inteiro.
  • Liste os momentos que devem ser mantidos (uma pergunta e sua resposta, uma reação, um payoff); após qualquer mudança automática de limite, verifique se estão completos e em ordem.
  • Para diálogo, mostre a transcrição inteira numerada com tempos e pergunte o que remover, antes que qualquer gráfico seja temporizado para o corte. Quando uma frase é dita duas vezes, o take posterior geralmente é a correção; pergunte antes de descartar qualquer um.
  • Aplique, renderize uma nova versão, registre as anotações e decisões. Repita até que o usuário diga que o corte é deles.

4. Corte e ritmo

Corte em finais de frases e pausas. Um ponto de entrada ou saída pertence a um silêncio medido, no início da fonte, ou em uma junção contínua dentro de um take. Se um limite ainda cair dentro da fala, mova-o ou descarte a frase inteira; nunca corte uma palavra para atingir um comprimento. Corte o ar morto do meio de uma pausa para que ambos os lados mantenham uma respiração. Dê a junções não contínuas um fade de áudio muito curto para que não estalem. Pergunte antes de remover as pausas deliberadamente lentas de um orador.

Evite quadros flash: fragmentos de um ou dois quadros deixados quando um limite cai ao lado de um corte duro na fonte. Mova o limite ou descarte o fragmento; não estique um take curto com um congelamento ou desaceleração, ou esconda um corte ruim sob uma transição.

Metas de comprimento. "Tornar com 60 segundos" por velocidade e por corte são respostas diferentes (a velocidade altera cada movimento e voz; cortar perde material). Mostre ambas.

Ajustando a imagem à narração (o lado da imagem): quando uma linha narrada é mais longa que seu take, desacelere esse clipe em no máximo 10% e deixe o restante derramar no próximo take. Em um filme, 7 de 25 takes precisaram disso. Mantenha a taxa de quadros constante após qualquer mudança de velocidade, para que o clipe ainda corresponda aos outros para junção.

Cortando na batida. Obtenha os tempos das batidas da música aprovada como uma lista de segundos (do film-sound, ou de um detector de batidas executado na faixa). Proponha o momento mais forte de cada clipe, ajuste os cortes à batida mais próxima e mostre uma folha de cenas numerada antes de montar. Onde uma batida e um final de frase discordarem, mostre ambos e deixe o usuário escolher.

5. Correções de efeitos em clipes finalizados

Trabalhe em ordem de custo e mantenha o original junto a cada correção.

  • Correções gratuitas que mantêm os pixels originais: reenquadrar, acelerar, segurar um quadro, preencher quadros perdidos por interpolação, redução de ruído leve.

  • Sobreposições nunca vão para a filmagem gerada. Setas, rotas, rótulos e grades são desenhados por motion-graphics sobre o clipe limpo. Se um clipe gerado tiver um embutido, regenere-o limpo em vez de pintar por cima.

  • Uma re-renderização generativa é uma nova cena, não uma correção. Modelos de vídeo de referência usam o original como guia para movimento e aparência, não como pixels bloqueados, então rostos, adereços e movimentos de câmera podem variar. Se o usuário quiser um:

    1. Leia os quadros em todo o clipe; escreva o que deve permanecer igual (identidade, gestos, movimento de câmera, enquadramento, luz, objetos segurados) e a mudança, temporizada para seu momento.
    2. Onde a ferramenta permitir, mude um quadro parado primeiro e obtenha aprovação antes de pagar pelo movimento.
    3. Informe o modelo, a quantidade e o custo estimado; aguarde um sim.
    4. Verifique o resultado em relação à fonte: comprimento, fala até o fim, a boca se movendo através das últimas palavras, o rosto no início, meio, junções e fim, a mudança aprovada ainda presente. Relate uma falha como uma falha e ofereça um reparo; não escale por conta própria.

    O que um modelo preserva é algo a ser testado em uma cena primeiro.

  • Rotule cada cena como real ou gerada conforme avança; a divulgação precisa disso.

6. Legendas e subtítulos

Faça legendas após o bloqueio da imagem e após qualquer reenquadramento; legendas feitas antes de um corte podem cair fora do quadro.

  • As palavras. Se a narração foi escrita primeiro, o roteiro é o texto da legenda: alinhe-o ao áudio em vez de transcrever. Caso contrário, transcreva; um mecanismo local mantém a mídia na máquina, um serviço em nuvem a envia (pergunte primeiro). Os carimbos de data/hora de reconhecimento são frequentemente janelas grosseiras, não temporizações de palavras; alinhe quando a temporização for importante.
  • Corrija lendo. Reconhecedores entendem mal dialetos, nomes e palavras especializadas. Nunca adicione uma palavra que não foi dita, e nunca encurte ou parafraseie uma legenda para caber: use um tamanho menor ou outra linha, ou pergunte. Palavras reescritas para que uma voz sintética as diga corretamente mantêm sua grafia real nas legendas.
  • Um mestre, muitos formatos. Mantenha a versão mais rica (temporizações de palavras, falantes) e converta a partir dela: SRT para texto e tempo, VTT para players da web, ASS para estilização.
  • Traduza mantendo a temporização: o mesmo número de cues na mesma ordem, com os mesmos tempos e rótulos de falante; sem cues vazias; tags de som mantidas; sem travessões, parênteses ou colchetes que a fonte não tenha. Confirme o idioma de origem se não estiver claro. Legendas que destacam cada palavra à medida que são faladas devem estar no idioma do áudio; para outro idioma, use uma linha traduzida simples.
  • Queime ou multiplex. Legendas queimadas fazem parte da imagem e não podem ser desligadas, então queime por último, após o upscaling; precisa de um ffmpeg compilado com libass. Legendas multiplexadas permanecem alternáveis: uma faixa por idioma, etiquetada com seu idioma. As plataformas aceitam um arquivo de legenda por idioma.
  • Posicionamento: mantenha as legendas fora dos rostos e longe dos botões da plataforma em vídeos verticais; verifique suas áreas seguras atuais.

7. Upscale por último, por clipe

Faça upscale apenas após o corte estar bloqueado, cada clipe individualmente em vez do filme unido, para que os cortes não manchem. Reconstrua o corte a partir dos clipes com upscale usando a mesma EDL, depois adicione legendas e gráficos para que o texto permaneça nítido. O upscaling por IA é adequado para filmagens fotográficas; em uma série de filmes, degradou arte vetorial plana. Pergunte antes de qualquer upscaler pago.

8. A visualização final

Verifique o arquivo que você entregará, não uma versão anterior, um proxy ou um mestre sem legendas.

  1. Reproduza uma vez em velocidade normal sem parar para corrigir; observe o que você nota.
  2. Reproduza cada junção, meio segundo a um segundo de cada lado, em velocidade normal.
  3. Ouça uma vez sem a imagem.
  4. Assista novamente à abertura, ao momento-chave e ao final.
  5. Numa revisão, confirme que cada mudança solicitada aconteceu e que nada mais se moveu.
  6. Em seguida, inspecione os números, execute uma passagem de decodificação, verifique as faixas de legenda e faça uma folha de contato de cada cena.

Folhas e verificações automáticas apenas apontam problemas; a reprodução decide. Se você não puder visualizar imagens ou reproduzir mídia, diga isso em vez de afirmar que fez uma verificação. Corrija um problema onde ele vive (o corte, o som, as palavras), não com empacotamento. Relate no formulário de cinco linhas em edit-sheets.

9. Arquivos de entrega, divulgação e créditos

  • Pergunte para onde está indo. O destino decide proporção, comprimento, codec e loudness. Leia sua especificação atual e anote a data.
  • Um mestre, depois um arquivo por destino codificado a partir dele e inspecionado; junto com eles, arquivos de legenda por idioma, uma transcrição, créditos e divulgação, o registro de direitos.
  • Divulgação e créditos: do que o roteiro foi adaptado, quais imagens e som são gerados por IA e quais são reais, e crédito para filmagens, música e vozes com seus direitos. O agente redige isso com espaços em branco; o usuário edita e assina. Defina a bandeira de mídia sintética de uma plataforma com veracidade.
  • Registro de direitos: cada ativo externo com fonte e licença; cada ativo gerado com modelo e ID do trabalho.

10. Entregando a linha do tempo a um editor (FCPXML)

Quando o usuário ou seu editor finalizar em um programa de edição, entregue uma linha do tempo, bem como um arquivo achatado.

  • Exporte a EDL como FCPXML (pergunte qual formato o programa do editor importa) mais um CSV dela. Aponte para os clipes originais pelo caminho absoluto; liste a mídia ausente.
  • O tempo é quadros sobre taxa de quadros (72/24s), nunca um decimal arredondado. offset é a posição na linha do tempo, start o ponto de entrada dentro da fonte, duration o comprimento. Os marcadores são filhos do clipe que marcam e podem conter as anotações de corte. O spine é a história principal; clipes conectados ficam em faixas, positivo acima, negativo abaixo. Um pacote .fcpxmld é uma pasta com dados auxiliares; mantenha-o inteiro.
  • Nunca edite o arquivo do editor no lugar: escreva uma nova versão e liste o que mudou.
  • Escrever o arquivo não é importá-lo. Importe um pequeno teste primeiro; a importação é a etapa do usuário.

11. Upload: pergunte primeiro, privado por padrão

  • O padrão é um pacote que o usuário envia: arquivo, legendas, título, descrição, tags, capa, divulgação.
  • Faça upload apenas a pedido do usuário, por plataforma, como privado ou rascunho. A liberação pública ou programada exige que o usuário nomeie a plataforma, o arquivo e a hora. "Publique em todo lugar" não é essa aprovação: liste a ação planejada de cada plataforma (arquivo, título, visibilidade, hora) e confirme.
  • Uma plataforma de cada vez. Em uma tela de login, código de verificação, captcha ou aviso de segurança, pare e entregue. Nunca digite senhas ou códigos, ou leia ou repita credenciais.
  • Depois, leia de volta o título, início da descrição, legendas, visibilidade e a configuração de mídia sintética. Sucesso é um ID de vídeo mais um status de processamento; um login falhou não é.

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

cinematic-shots

Take a screenplay or scene to shots an image or video model can make, with the filmmaker making every creative call. Covers notes on the script, the screenplay-to-shot-table conversion, look rules written once and pasted into every prompt, keeping characters, places and props consistent with reference sheets, cheap draft stills before paid hero stills, checking every still before any motion, image-to-video prompts with one action and one gentle camera move, checking several frames per clip, the cost order, a per-session spending cap, and cost and production logs. Use when the user says "shot table", "shot list", "break down this scene", "storyboard", "look rules", "keep the character consistent", "character sheet", "draft stills", "hero still", "animate this still", "image to video", "camera move", "the clip smears" or "what will this cost". Not for narration, dialogue, music or the mix (film-sound); cutting, captions, upscaling or delivery (film-edit); or titles and graphics drawn in

motion-graphics

Make graphics drawn in code that sit over or between shots - titles and title cards, lower thirds, kinetic type, a stat or animated chart, a map or route, logo stings, transitions, captions styled as graphics, beat-synced graphic videos and explainer animation. Sets the house style once (palette, type, pacing), plans beats against measured narration, music or footage timing, builds deterministic seek-safe animation, inspects stills and several frames, then renders, verifies and composites over clean footage instead of baking graphics into generated shots. Works with any code-rendered video engine. Use when the user says "motion graphics", "title card", "lower third", "kinetic type", "animate this chart", "animated map", "draw the route", "logo sting", "beat-synced video", "explainer animation", "styled captions" or "overlay on this footage". Not for generated photoreal footage (cinematic-shots), narration, music or the mix (film-sound), or cutting, plain subtitles, delivery and upload

Habilidades Relacionadas