Communitygithub.com

nateherkai/hyperframes-student-kit

Agente 1 del pipeline de edición de video. Elimina silencios y tiempos muertos de una grabación de cabeza parlante. Se usa cuando se pide cortar silencios, recortar pausas, eliminar tiempos muertos o ajustar el ritmo de un video en bruto, dado un transcripción a nivel de palabra. Produce una lista de edición (EDL), una transcripción re-sincronizada para agentes posteriores y, opcionalmente, el video cortado mediante ffmpeg. NO corta errores, repeticiones o falsos comienzos — esa es tarea del agente de corte de errores.

¿Qué es hyperframes-student-kit?

Este agente es el primer paso automatizado en un pipeline de edición de video para grabaciones de cabeza parlante. Su función principal es eliminar únicamente los silencios y tiempos muertos de una grabación en bruto, utilizando una transcripción a nivel de palabra como entrada. Es determinista y basado en la transcripción, lo que garantiza que su salida sea predecible y útil para los agentes posteriores. El agente recorta el silencio antes de la primera palabra y después de la última, y acorta las pausas entre palabras que superan un umbral configurable (por defecto 0.55 segundos), pero preserva una cantidad natural de 'respiración' para mantener un ritmo realista. No altera las palabras del hablante, dejando la eliminación de falsos comienzos, repeticiones y tartamudeos a un agente separado. Soporta las plataformas de transcripción de ElevenLabs y formatos genéricos, y puede ejecutarse solo para planificar (generar la lista de edición y la transcripción re-sincronizada) o con un video para producir el archivo cortado mediante ffmpeg. Su salida incluye un archivo JSON con la lista de edición (EDL), una transcripción re-sincronizada en la línea de tiempo editada, y un resumen legible por humanos. Esta salida se pasa al siguiente agente del pipeline (corte de errores), y gracias a que los timestamps ya están en la línea de tiempo editada, no se requieren ajustes adicionales.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Cortar Silencios (Agente 1 del Pipeline)

Primer paso de la edición automatizada. Toma una grabación en bruto y su transcripción a nivel de palabra y elimina solo silencio: tiempo muerto antes de la primera palabra y después de la última, más las pausas entre palabras que superan un umbral (reducidas a una respiración natural, nunca a un corte a cero brusco). Deja las palabras del hablante intactas — los falsos comienzos, retomas y tartamudeos son tarea del agente de corte de errores (Agente 2).

Este agente es determinista y está basado en la transcripción, por lo que su salida (*.silence-transcript.json) alimenta de forma limpia a los siguientes agentes y al validador de sincronización de ritmo.

Cuándo usarlo

  • "cortar los silencios", "recortar las pausas", "eliminar tiempos muertos", "ajustar el ritmo"
  • Como la primera etapa del flujo de trabajo de edición maestro, justo después de la transcripción.

Requisitos previos

Un JSON de transcripción a nivel de palabra. Puede tener la forma de ElevenLabs Scribe ({ words: [{ text, start, end, type }], audio_duration_secs }) o una genérica { words: [{ text, start, end }] }. Genere uno con el transcriptor del espacio de trabajo:

node scripts/transcribe-elevenlabs.mjs ruta/a/raw.mp4    # -> ruta/a/raw.json

Uso

# 1) Solo planificar — calcular el corte, escribir EDL + transcripción re-sincronizada (no se toca el video)
node .agents/skills/cut-silences/scripts/cut-silences.mjs <transcript.json> \
  --out-dir video-projects/<slug>/assets

# 2) Con un video — también escribir el comando ffmpeg (aún no se 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 el video cortado (ffmpeg local, recodificar, A/V sincronizado)
#    añadir --apply para ejecutar ffmpeg realmente
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

Opciones

BanderasPor defectoSignificado
--video <ruta>—Video fuente; habilita el comando ffmpeg / renderizado
--out-dir <dir>junto al transcriptDirectorio donde se escriben las salidas
--output <ruta><video-stem>.silenced.mp4Ruta del video cortado
--gap <s>0.55Pausa mínima tratada como silencio recortable
--head-pad <s>0.22Silencio conservado antes de la primera palabra
--tail-pad <s>0.34Silencio conservado después de la última palabra
--applydesactivadoEjecutar ffmpeg realmente para renderizar el corte

Cómo decide (las reglas de silencio)

  • Las pausas por debajo de --gap (0.55s) se dejan intactas — ritmo natural del habla.
  • Para una pausa recortada, se conserva una respiración natural, escalada según el contexto: 0.24s para pausas largas (≥2s), 0.20s después de un final de oración (. ! ?), 0.14s en otros casos. La respiración conservada se sesga ligeramente hacia el final de la frase anterior.
  • El silencio inicial/final se recorta a --head-pad / --tail-pad.
  • Los rangos de eliminación se fusionan; los rangos de conservación son el complemento. El corte se renderiza con un filtro trim/atrim + concat de ffmpeg (escrito en un script *.silence-filter.txt y pasado mediante -/filter_complex), por lo que el video y el audio se mantienen sincronizados.

Salidas (escritas en --out-dir)

ArchivoPropósito
<stem>.silence-edl.jsonRangos de conservar/eliminar, duraciones, parámetros — la lista de edición
<stem>.silence-transcript.jsonPalabras re-sincronizadas en la línea de tiempo editada (alimenta al Agente 2 + ritmo)
<stem>.silence-decisions.mdResumen legible para humanos + las pausas más grandes recortadas
<stem>.silence-filter.txtEl filtro de ffmpeg (solo con --video)
<video-stem>.silenced.mp4El video cortado (solo con --apply)

El resumen JSON impreso en stdout incluye removed, removedPct, conteos de rangos y rutas de salida — útil para que el flujo de trabajo maestro registre y encadene.

Notas de ajuste

  • Por defecto para YouTube de cabeza parlante (--gap 0.55) se elimina aproximadamente 15-20% de una toma en bruto típica como silencio puro. Reduzca --gap para un corte más enérgico y rápido; auméntelo para preservar más espacio natural de respiración.
  • Si un corte se siente demasiado agresivo en los límites de las oraciones, aumente la respiración de fin de oración o aumente --gap.

Transferencia al siguiente agente

Pase <stem>.silence-transcript.json (y silenced.mp4 si se renderizó) al agente de corte de errores. Dado que los timestamps ya están en la línea de tiempo editada, la sincronización de ritmo posterior y scripts/validate-beat-sync.mjs funcionan sin ajustes adicionales.

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.

Skills relacionados