Communitygithub.com

Cortar Erros e Repetições (Agente 2 do Pipeline)

Segundo agente do pipeline de edição de vídeo. Encontra e remove erros de fala — gaguejos, palavras repetidas, falsos começos e retomadas (linhas regravadas) — de uma gravação de cabeça falante. Use após cortar silêncios, quando for solicitado a cortar erros, remover gaguejos/repetições/recomeços com preenchimento, limpar falhas ou manter a melhor tomada. Funciona com revisão obrigatória: propõe cada corte com contexto e motivo para aprovação, depois renderiza apenas os cortes aprovados via ffmpeg. Requer uma transcrição em nível de palavra.

O que é Cortar Erros e Repetições (Agente 2 do Pipeline)?

Este agente, o segundo no pipeline de edição automatizada, é especializado em identificar e remover erros de fala de gravações de cabeça falante. Ele detecta gaguejos (ex: "o o", "eu- eu-"), repetições imediatas de palavras, falsos começos (frases abandonadas que recomeçam) e retomadas (linhas regravadas onde a versão limpa é mantida e a falha descartada). Sua principal vantagem é o fluxo de revisão obrigatória: o agente gera uma proposta detalhada com contexto textual e recomendações para cada corte candidato, mas um humano (ou o agente supervisor) decide o que aprovar. Isso evita falsos positivos comuns, como ênfases retóricas ou listagens. Após a aprovação, o agente aplica os cortes usando ffmpeg e produz um novo vídeo sincronizado com áudio, juntamente com uma transcrição atualizada que alimenta o próximo agente de gráficos em movimento. Ele é executado após o agente de corte de silêncios e requer uma transcrição em nível de palavra. Suporta plataformas como Claude Code, Cursor, Codex, etc., e é implementado como um conjunto de scripts Node.js que processam arquivos JSON de transcrição e vídeo. Ideal para fluxos de edição rápida onde a precisão é crítica e o usuário deseja manter controle sobre cada alteração.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/nateherkai/hyperframes-student-kit/tree/HEAD/.agents/skills/cut-mistakes

Perguntar na sua IA favorita

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

Documentação

O que Cortar Erros e Repetições (Agente 2 do Pipeline) faz?

Segunda etapa da edição automatizada, executada após cortar-silêncios. Remove o que um editor humano corta numa segunda passada: gaguejos ("o o", "eu- eu-"), palavras imediatamente repetidas, falsos começos (uma frase abandonada que recomeça) e retomadas (uma linha regravada — mantenha a versão limpa, descarte a falha).

Decidir o que conta como erro é julgamento, não fórmula — repetição enfática ("nunca, nunca") e duplicação retórica ("a primeira peça é, é isto…") parecem idênticas a um gaguejo mecanicamente. Portanto, este agente é revisão-obrigatória por padrão: ele apresenta candidatos com contexto completo; o agente (e o usuário) decidem; apenas os cortes aprovados são renderizados.

Quando usar

  • "cortar os erros", "remover gaguejos / repetições", "limpar as falhas", "manter a melhor tomada", "cortar falsos começos"
  • Como segundo estágio do fluxo de edição mestre, na saída de cortar-silêncios.

Fluxo em três partes

1. Encontrar candidatos (mecânico)

node .agents/skills/cut-mistakes/scripts/find-cut-candidates.mjs \
  <silence-transcript.json> --out-dir video-projects/<slug>/assets

Entrada normalmente é o <stem>.silence-transcript.json do Agente 1, para que os cortes caiam na linha do tempo já sem silêncio. Escreve:

  • <stem>.cut-candidates.json — candidatos estruturados (tipo, confiança, intervalo de corte proposto, texto remove/mantém, contexto, recomendação)
  • <stem>.cut-candidates.md — proposta legível

Tipos de candidatos: gaguejo (repetição imediata de palavra), retomada (segmento duplicado/quase duplicado por similaridade Jaccard), falso_comeco (frase curta abandonada que recomeça).

2. Revisão (a barreira — OBRIGATÓRIA)

Leia cada candidato em contexto e decida manter-ou-cortar. O detector mecânico não consegue distinguir ênfase intencional/retórica de um erro real, portanto não confie em recomendar cegamente — leia remove + contexto. Falsos positivos comuns: repetição enfática ("nunca é nunca é mãos-livres"), cópula-seguida-de-pergunta ("a peça é, é isto…"), listagem.

Apresente os candidatos ao usuário com uma recomendação por item; colete aprovações. Escreva os cortes aprovados num arquivo:

{ "cortes": [ { "inicio": 100.93, "fim": 101.06, "motivo": "eu- falso começo" }, ... ] }

(inicio/fim em segundos na linha do tempo do vídeo/transcrição de entrada. Pode-se alargar o intervalo de um candidato — por exemplo, para uma retomada, corte do início da tomada falha até o reinício limpo.)

3. Aplicar cortes aprovados

node .agents/skills/cut-mistakes/scripts/apply-cuts.mjs \
  <silence-transcript.json> --cortes aprovados-cortes.json \
  --video video-projects/<slug>/assets/edited-silenced.mp4 \
  --output video-projects/<slug>/assets/edited-clean.mp4 --apply

Escreve a EDL, uma transcrição re-temporizada <stem>.mistakes-transcript.json (alimenta o agente de gráficos em movimento + validate-beat-sync.mjs), um registro de decisões e — com --apply — o vídeo cortado (ffmpeg trim+concat, A/V em sincronia). Remova --apply para uma execução de teste.

Revisando o resultado

Use a ferramenta de revisão compartilhada para examinar os cortes e verificar os limites:

node scripts/build-edl-review.mjs <stem>.mistakes-edl.json \
  --original video-projects/<slug>/assets/edited-silenced.mp4 \
  --editado   video-projects/<slug>/assets/edited-clean.mp4 \
  --saida     video-projects/<slug>/assets/mistakes-review.html
npx serve . -p 8080 -n

Notas

  • Uma gravação muito limpa pode render poucos ou zero cortes reais — isso é um resultado válido; não corte a fala natural para atingir uma cota.
  • Cortes entre duas palavras faladas são uniões secas. Geralmente são limpos para gaguejos/falsos começos; para áudio mais apertado, um fade de 20-30ms pode ser adicionado posteriormente.
  • Passe o mistakes-transcript.json + o vídeo limpo para o Agente 3 (gráficos em movimento / cartões em camadas).

Individual skills in this repo

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

nateherkai/hyperframes-student-kit

Agent 1 of the video editing pipeline. Removes silences and dead air from a talking-head recording. Use when asked to cut silences, trim pauses, remove dead air / gaps, or tighten the pacing of a raw video, given a word-level transcript. Produces an edit list (EDL), a re-timed transcript for downstream agents, and optionally the cut video via ffmpeg. Does NOT cut mistakes, repeats, or false starts — that is the cut-mistakes agent.

nateherkai/hyperframes-student-kit

Edit a raw talking-head video through transcription, silence trimming, mistake review, visual storytelling, motion graphics, and verified HyperFrames rendering. Use for a complete edit; route a single requested operation directly to its specialist skill.

nateherkai/hyperframes-student-kit

GSAP animation reference for HyperFrames. Covers gsap.to(), from(), fromTo(), easing, stagger, defaults, timelines (gsap.timeline(), position parameter, labels, nesting, playback), and performance (transforms, will-change, quickTo). Use when writing GSAP animations in HyperFrames compositions.

nateherkai/hyperframes-student-kit

HyperFrames CLI tool — hyperframes init, lint, preview, render, transcribe, tts, doctor, browser, info, upgrade, compositions, docs, benchmark. Use when scaffolding a project, linting or validating compositions, previewing in the studio, rendering to video, transcribing audio, generating TTS, or troubleshooting the HyperFrames environment.

nateherkai/hyperframes-student-kit

Install and wire registry blocks and components into HyperFrames compositions. Use when running hyperframes add, installing a block or component, wiring an installed item into index.html, or working with hyperframes.json. Covers the add command, install locations, block sub-composition wiring, component snippet merging, and registry discovery.

nateherkai/hyperframes-student-kit

Plan, write, time, style, and validate motion-graphic beats for long-form talking-head HyperFrames videos. Use when Codex is asked to add or improve visual beats, glassmorphism lower thirds, crumpled-paper full-screen takeovers, transcript-synced callouts, pacing coverage, YouTube retention graphics, or render-ready overlays in an existing HyperFrames video project.

nateherkai/motion-showreel

Build 10–30s motion-design showreels in the style of Nate's Opus 5.5 CLAUDE/MOTION REEL — brand motif chapters, HUD, BPM-locked cuts, logo lockup.

nateherkai/website-to-hyperframes

Capture a website URL and produce a HyperFrames promo/product-tour video — site → finished marketing video outcome.

Habilidades Relacionadas