Communitygithub.com

nateherkai/hyperframes-student-kit

Agente 1 do pipeline de edição de vídeo. Remove silêncios e pausas de uma gravação de cabeça falante. Use quando solicitado a cortar silêncios, aparar pausas, remover vazios/lacunas ou apertar o ritmo de um vídeo bruto, dado um transcrição em nível de palavra. Produz uma lista de edição (EDL), uma transcrição com novo tempo para agentes downstream e, opcionalmente, o vídeo cortado via ffmpeg. NÃO corta erros, repetições ou falsos começos — isso é responsabilidade do agente de corte de erros.

O que é hyperframes-student-kit?

Este é o primeiro agente de um pipeline automatizado de edição de vídeo, projetado para trabalhar com gravações de cabeça falante. Sua função principal é remover silêncios e pausas mortas de um vídeo bruto, utilizando como entrada uma transcrição em nível de palavra. O agente é determinístico e orientado pela transcrição, garantindo que as palavras do falante permaneçam intactas, deixando a correção de erros, repetições e falsos começos para um agente downstream (cut-mistakes). A utilidade principal é acelerar significativamente o processo de edição, removendo de 15 a 20% de silêncio puro em takes típicos do YouTube, resultando em um ritmo mais apertado sem perder a naturalidade da fala. O agente suporta qualquer plataforma que possa executar Node.js e ffmpeg, sendo independente de qualquer ambiente de nuvem específico. O funcionamento é baseado em um algoritmo de regras de silêncio: pausas abaixo de um limiar configurável (padrão 0,55s) são mantidas, enquanto pausas maiores são reduzidas para durações naturais de respiração (0,14s a 0,24s). A saída inclui uma lista de edição (EDL), uma transcrição com novo tempo alinhada à linha do tempo editada e, opcionalmente, o vídeo cortado renderizado pelo ffmpeg. O agente também gera um filtro gráfico ffmpeg para manter o áudio e o vídeo sincronizados.

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

Perguntar na sua IA favorita

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

Documentação

Cortar Silêncios (Agente 1 do Pipeline)

Primeira etapa da edição automatizada. Pega uma gravação bruta + sua transcrição em nível de palavra e remove apenas silêncio: vazio antes da primeira palavra e depois da última palavra, mais pausas entre palavras maiores que um limite (reduzidas para uma respiração natural, nunca um intervalo zero duro). Ele deixa as palavras do falante intocadas — falsos começos, retomadas e gagueiras são trabalho do agente corte de erros (Agente 2).

Este agente é determinístico e orientado pela transcrição, portanto sua saída (*.silence-transcript.json) alimenta de forma limpa os próximos agentes e o validador de sincronização de batida.

Quando usar

  • "cortar os silêncios", "aparar as pausas", "remover vazios", "apertar o ritmo"
  • Como o primeiro estágio do fluxo de trabalho mestre de edição, logo após a transcrição.

Pré-requisitos

Um JSON de transcrição em nível de palavra. Pode ser no formato ElevenLabs Scribe ({ words: [{ text, start, end, type }], audio_duration_secs }) ou genérico { words: [{ text, start, end }] }. Gere um com o transcricionador da área de trabalho:

node scripts/transcribe-elevenlabs.mjs path/to/raw.mp4    # -> path/to/raw.json

Uso

# 1) Apenas planejamento — calcula o corte, escreve EDL + transcrição com novo tempo (nenhum vídeo tocado)
node .agents/skills/cut-silences/scripts/cut-silences.mjs <transcript.json> \
  --out-dir video-projects/<slug>/assets

# 2) Com um vídeo — também escreve o comando ffmpeg (ainda não renderiza)
node .agents/skills/cut-silences/scripts/cut-silences.mjs <transcript.json> \
  --video video-projects/<slug>/assets/raw.mp4 --out-dir video-projects/<slug>/assets

# 3) Renderizar o vídeo cortado (ffmpeg local, recodificar, A/V mantido em sincronia)
#    adicione --apply para realmente executar ffmpeg
node .agents/skills/cut-silences/scripts/cut-silences.mjs <transcript.json> \
  --video video-projects/<slug>/assets/raw.mp4 --apply \
  --output video-projects/<slug>/assets/edited-silenced.mp4

Opções

FlagPadrãoSignificado
--video <caminho>—Vídeo fonte; habilita o comando ffmpeg / renderização
--out-dir <dir>próximo ao transcricionadorOnde as saídas são escritas
--output <caminho><video-stem>.silenced.mp4Caminho do vídeo cortado
--gap <s>0.55Pausa mínima tratada como silêncio cortável
--head-pad <s>0.22Silêncio mantido antes da primeira palavra
--tail-pad <s>0.34Silêncio mantido após a última palavra
--applydesligadoExecutar realmente ffmpeg para renderizar o corte

Como ele decide (as regras de silêncio)

  • Pausas abaixo de --gap (0,55s) são deixadas em paz — ritmo natural da fala.
  • Para uma pausa cortada, uma respiração natural é mantida, dimensionada pelo contexto: 0.24s para pausas longas (≥2s), 0.20s após um final de frase (. ! ?), 0,14s caso contrário. A respiração mantida é ligeiramente deslocada para o final da frase anterior.
  • O vazio inicial/final é cortado para --head-pad / --tail-pad.
  • Os intervalos de exclusão são mesclados; os intervalos de manutenção são o complemento. O corte é renderizado com um grafo de filtro ffmpeg trim/atrim + concat (escrito em um script *.silence-filter.txt e passado via -filter_complex), para que vídeo e áudio permaneçam sincronizados.

Saídas (escritas em --out-dir)

ArquivoPropósito
<stem>.silence-edl.jsonIntervalos de manter/excluir, durações, parâmetros — a lista de edição
<stem>.silence-transcript.jsonPalavras com novo tempo na linha do tempo editada (alimenta Agente 2 + batidas)
<stem>.silence-decisions.mdResumo legível por humanos + maiores pausas cortadas
<stem>.silence-filter.txtO grafo de filtro ffmpeg (apenas com --video)
<video-stem>.silenced.mp4O vídeo cortado (apenas com --apply)

O resumo JSON impresso no stdout inclui removed, removedPct, contagens de intervalos e caminhos de saída — útil para o fluxo de trabalho mestre registrar e encadear.

Notas de ajuste

  • Padrão para YouTube de cabeça falante (--gap 0.55) remove aproximadamente 15-20% de um take bruto típico como silêncio puro. Reduza --gap para um corte mais rápido e incisivo; aumente-o para preservar mais espaço natural para respiração.
  • Se um corte parecer muito agressivo nos limites de frase, aumente a respiração de quebra de frase ou aumente --gap.

Transferência para o próximo agente

Passe <stem>.silence-transcript.json (e o silenced.mp4 se renderizado) para o agente corte de erros. Como os timestamps já estão na linha do tempo editada, o tempo de batida downstream e o scripts/validate-beat-sync.mjs funcionam sem ajustes adicionais.

Individual skills in this repo

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

nateherkai/hyperframes-student-kit

Agent 2 of the video editing pipeline. Finds and removes spoken mistakes — stutters, repeated words, false starts, and retakes (re-recorded lines) — from a talking-head recording. Use after cut-silences, when asked to cut mistakes, remove stutters / repeats / filler restarts, clean up flubs, or keep the best take. Works review-gated: it proposes every cut with context and a reason for approval, then renders only the approved cuts via ffmpeg. Requires a word-level transcript.

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