Communitygithub.com

nateherkai/hyperframes-student-kit

Agente 2 del pipeline de edición de video: encuentra y elimina errores hablados (tartamudeos, repeticiones, falsos comienzos y retomas) de una grabación de persona hablando. Se usa después de cortar silencios, cuando se pide corregir errores, eliminar tartamudeos / repeticiones / reinicios de relleno, limpiar equivocaciones o conservar la mejor toma. Funciona con revisión: propone cada corte con contexto y razón para aprobación, y luego renderiza solo los cortes aprobados mediante ffmpeg. Requiere una transcripción a nivel de palabra.

¿Qué es hyperframes-student-kit?

Este agente es el segundo paso de un pipeline automatizado de edición de video diseñado para grabaciones de tipo 'talking-head'. Su función principal es identificar y eliminar errores comunes del habla espontánea, como tartamudeos ('el el', 'yo- yo-'), repeticiones inmediatas de palabras, falsos comienzos (frases abandonadas que se reinician) y retomas (líneas regrabadas; se conserva la toma limpia, se descarta la fallida). A diferencia de un simple filtro mecánico, este agente utiliza un enfoque 'review-gated': primero detecta candidatos a corte mediante heurísticas (similitud de Jaccard para retomas, repeticiones de palabras para tartamudeos, etc.) y luego presenta cada candidato con contexto y justificación para que el agente o el usuario decida si aprobarlo o rechazarlo. Esta revisión es crucial porque patrones como repetición enfática ('nunca, nunca') o doblaje retórico ('la primera pieza es, es esto...') son mecánicamente idénticos a un tartamudeo, pero no deben cortarse. Una vez aprobados los cortes, el agente usa ffmpeg para aplicar trim+concat y genera un nuevo video limpio, además de un transcript re-sincronizado que alimenta al siguiente agente del pipeline (gráficos en movimiento / tarjetas jerárquicas). Soporta integración con el flujo de trabajo general y herramientas de revisión visual. Es ideal para editores que buscan automatizar la tediosa limpieza de tomas habladas sin perder el control creativo sobre qué cortes aplicar.

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

Preguntar en tu IA favorita

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

Documentación

Cortar Errores y Repeticiones (Agente 2 del Pipeline)

Segundo paso de la edición automatizada, se ejecuta después de cortar-silencios. Elimina lo que un editor humano cortaría en una segunda pasada: tartamudeos ("el el", "yo- yo-"), palabras repetidas inmediatamente, falsos comienzos (una frase abandonada que se reinicia) y retomas (una línea regrabada — conserva la toma limpia, descarta la fallida).

Decidir qué cuenta como error es cuestión de criterio, no de fórmula — la repetición enfática ("nunca, nunca") y el doblaje retórico ("la primera pieza es, es esto…") son mecánicamente idénticos a un tartamudeo. Por lo tanto, este agente está restringido por revisión por defecto: presenta candidatos con contexto completo; el agente (y el usuario) deciden; solo se renderizan los cortes aprobados.

Cuándo usarlo

  • "corta los errores", "elimina tartamudeos / repeticiones", "limpia las equivocaciones", "conserva la mejor toma", "corta falsos comienzos"
  • Como la segunda etapa del flujo de trabajo de edición maestro, sobre la salida de cortar-silencios.

El flujo en tres 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

La entrada normalmente es el archivo <stem>.silence-transcript.json del Agente 1, por lo que los cortes se aplican sobre la línea de tiempo ya silenciada. Escribe:

  • <stem>.cut-candidates.json — candidatos estructurados (tipo, confianza, rango de cut propuesto, texto removes/keeps, contexto, recomendación)
  • <stem>.cut-candidates.md — propuesta legible

Tipos de candidatos: stutter (repetición inmediata de palabra), retake (segmento duplicado/casi duplicado mediante similitud de Jaccard), false_start (frase corta abandonada que se reinicia).

2. Revisar (el filtro — OBLIGATORIO)

Lee cada candidato en contexto y decide si conservarlo o cortarlo. El detector mecánico no puede distinguir énfasis/retórica intencional de un verdadero error, así que no confíes ciegamente en recommend: lee removes + context. Falsos positivos comunes: repetición enfática ("es nunca, nunca manos libres"), cópula seguida de pregunta ("la pieza es, es esto…"), enumeraciones.

Presenta los candidatos al usuario con una recomendación por elemento; recopila las aprobaciones. Escribe los cortes aprobados en un archivo:

{ "cuts": [ { "start": 100.93, "end": 101.06, "reason": "Yo- falso comienzo" }, ... ] }

(start/end en segundos sobre la línea de tiempo del video/transcript de entrada. Puedes ampliar el rango de un candidato — por ejemplo, para una retoma, corta desde el inicio de la toma fallida hasta el reinicio limpio.)

3. Aplicar cortes aprobados

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

Escribe el EDL, un transcript re-sincronizado <stem>.mistakes-transcript.json (alimenta al agente de gráficos en movimiento + validate-beat-sync.mjs), un registro de decisiones y — con --apply — el video cortado (ffmpeg trim+concat, A/V sincronizado). Omite --apply para una ejecución de prueba.

Revisar el resultado

Usa la herramienta de revisión compartida para examinar los cortes y verificar los límites:

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

Notas

  • Una toma muy limpia puede generar pocos o ningún corte real; ese es un resultado válido; no cortes el habla natural para alcanzar una cuota.
  • Los cortes entre dos palabras habladas son uniones duras. Por lo general son limpios para tartamudeos/falsos comienzos; para audio más ajustado se puede añadir un fade de 20-30 ms más tarde.
  • Pasa el mistakes-transcript.json + el video limpio al Agente 3 (gráficos en movimiento / tarjetas jerárquicas).

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.

Skills relacionados