Communitygithub.com

corte-de-takes

Transforme uma gravação bruta de uma pessoa falando para a câmera em um corte bruto: a melhor versão de cada fala mantida uma vez, pausas encurtadas, entregue como uma linha do tempo editável para DaVinci Resolve, Premiere Pro, Final Cut Pro ou CapCut desktop e opcionalmente como MP4. Funciona em qualquer idioma, com ou sem o roteiro lido. Não adiciona legendas, música ou efeitos.

O que é corte-de-takes?

A habilidade "corte-de-takes" (cut-takes) automatiza a pós-produção de gravações de cabeça falante, transformando horas de material bruto com repetições, falsos começos e pausas em um corte bruto limpo e editável. Ela transcreve a fala, identifica as melhores tomadas de cada frase usando um roteiro opcional como referência, e permite que o usuário revise e ajuste as escolhas antes da renderização final. O resultado é exportado como arquivos de projeto para os principais editores de vídeo (DaVinci Resolve, Premiere Pro, Final Cut Pro) e CapCut, ou como um arquivo MP4. A ferramenta funciona em qualquer idioma, suporta aceleração NVIDIA GPU e depende de FFmpeg e do pacote Python faster-whisper para transcrição. Ideal para YouTubers, criadores de conteúdo e editores que precisam acelerar o processo de corte de vídeos de monólogo.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/MikolajKopec/skills/tree/HEAD/skills/video/cut-takes

Perguntar na sua IA favorita

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

Documentação

Corte de takes

Transforme uma gravação bruta de uma pessoa falando para a câmera em um corte bruto: cada fala dita uma vez, em sua última tomada completa, com pausas longas encurtadas. O script encontra a fala, a transcreve frase por frase e mede os níveis. Você decide quais takes permanecem.

Script: python "${CLAUDE_SKILL_DIR}/scripts/cut_takes.py" (use python3 onde python é Python 2 ou está ausente). Abaixo é escrito como cut_takes.py.

0. Configuração (uma vez)

Execute cut_takes.py doctor. Se algo estiver faltando, informe ao usuário e ofereça o comando de instalação:

  • FFmpeg: Windows winget install Gyan.FFmpeg, macOS brew install ffmpeg, Linux sudo apt install ffmpeg.
  • Pacote Python: python -m pip install faster-whisper.
  • GPU NVIDIA opcional: python -m pip install nvidia-cublas-cu12 "nvidia-cudnn-cu12==9.*" (cerca de 2 GB). Sem ela, tudo roda na CPU, apenas mais devagar.

1. Analisar

Pergunte pelo caminho do vídeo e, se o orador leu um roteiro, o roteiro como texto simples (opcional). Escolha uma pasta de trabalho ao lado do vídeo, por exemplo <pasta_do_video>/<nome_do_video>-corte/.

cut_takes.py analyze VIDEO --work WORK [--script SCRIPT.txt] [--language en]
  • O idioma é detectado automaticamente; passe --language se a linha de detecção na saída estiver errada.
  • Na CPU, uma gravação longa leva um tempo. Para uma passagem rápida, adicione --model small.
  • Arquivos muito grandes (4K, acima de 20 minutos) funcionam, mas a renderização é mais rápida a partir de uma cópia em 1080p.

Saída em WORK: takes.md (leia isto), takes.json e um rascunho de cuts.json.

2. Escolher takes

Leia takes.md. Cada frase tem um id, tempo de origem, texto e status:

  • KEEP / DROP retaken in #N - o script já assume que a última tomada completa vence. Verifique cada suposição.

  • DROP unclear (noise?) - uma tosse, clique ou respiração que o Whisper transformou em palavras ("Thank you."). DROP not in script - somente com --script.

  • (cut before "word" ...) - apenas o final da frase foi dito novamente depois; o clipe do rascunho termina antes dessa palavra.

  • !! repeated ... / !! false start ... / !! long word ... - um tropeço dentro de uma frase (uma palavra longa é frequentemente uma repetição que o Whisper mesclou). Verifique transcrevendo pequenas janelas e, em seguida, remova-a com skip ou use outra tomada:

    cut_takes.py transcribe VIDEO --work WORK --at 86.1 87.0 87.4 88.6
    
  • Script words not found - linhas que nenhuma frase mantida cobre. Procure por elas nas frases DROP; se estiverem faltando, informe ao usuário.

Em seguida, edite cuts.json:

  • Descarte conversas fora da câmera ("okay, mais uma vez", "está gravando?"), verificações de microfone e takes incompletos. Uma fala incompleta é melhor removida do que mantida.
  • Um comentário geralmente se refere ao take anterior: "não vamos usar isso" logo após uma fala significa que essa fala também sai.
  • Se dois takes são igualmente completos, prefira aquele mais próximo do roteiro.
  • from vai no silêncio antes do take, to no silêncio depois dele. Mantenha os clipes na ordem em que devem ser reproduzidos.
  • Um tropeço dentro de um bom take: "skip": [[a, b]] com a logo após a última palavra boa e b pouco antes da repetição limpa. Use os tempos das palavras de takes.json para posicioná-lo.

Opcional: verifique para onde o orador olha no final de um take (olhar para anotações arruína o corte):

cut_takes.py frames VIDEO --at 41.2 --dur 2 --png WORK/end.png

Veja o PNG e termine to antes que o olhar saia da câmera.

3. Renderizar

cut_takes.py render WORK/cuts.json [--style natural|tight] [--mp4]
  • natural (padrão, YouTube e formato longo): pausas acima de 0,5 s são reduzidas para 0,3 s.
  • tight (curtos, reels): toda pausa é cortada, e respirações e estalos de lábios entre frases também vão (listados como dropped breath/noise).
  • Ajuste fino com --max-pause e --keep-pause (segundos).
  • Adicione --mp4 apenas quando o usuário quiser um arquivo de vídeo pronto.

Ele escreve <video>-cut.fcpxml, .xml, .edl, uma pasta de projeto CapCut <video>-cut-capcut/, -segments.json (e .mp4) em WORK e termina com CHECK OK quando todas as exportações concordam entre si e com o MP4. Em CHECK FAILED, reporte a mensagem e não entregue os arquivos.

Com --mp4, transcreva o resultado uma vez (cut_takes.py transcribe WORK/<video>-cut.mp4 --work WORK --at 0 <comprimento>) e leia: cada fala uma vez, sem repetições, sem palavra cortada ao meio.

4. Entregar

Informe ao usuário a duração antes e depois, o número de segmentos, quais takes você descartou e por quê, e algo para ouvir. Em seguida, diga a ele como importar:

EditorArquivoComo
DaVinci Resolve.fcpxml (ou .xml)File > Import > Timeline, então escolha o arquivo. Vincule novamente a mídia se solicitado
Premiere Pro.xmlFile > Import, escolha o .xml; uma nova sequência aparece no projeto
Final Cut Pro.fcpxmlFile > Import > XML
Outros editores.edlCMX 3600 EDL, importe e vincule novamente ao vídeo de origem
CapCut desktoppasta -capcut/Saia do CapCut, copie a pasta inteira para a pasta de projetos do CapCut (abaixo), inicie o CapCut e abra o projeto pela tela inicial

Pasta de projetos do CapCut: Windows %LOCALAPPDATA%\CapCut\User Data\Projects\com.lveditor.draft, macOS ~/Movies/CapCut/User Data/Projects/com.lveditor.draft, ou o caminho definido nas configurações do CapCut. Não escreva nela você mesmo; diga ao usuário para copiar a pasta. Se o projeto não aparecer ou não abrir, recorra ao .mp4.

A linha do tempo aponta para o arquivo de vídeo original, portanto não o mova ou renomeie antes de importar. Cada corte é um corte seco em uma única faixa; adicione crossfades no editor se um corte estalar.

Para alterar algo, edite cuts.json e renderize novamente.

Habilidades Relacionadas