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
| Banderas | Por defecto | Significado |
|---|---|---|
--video <ruta> | — | Video fuente; habilita el comando ffmpeg / renderizado |
--out-dir <dir> | junto al transcript | Directorio donde se escriben las salidas |
--output <ruta> | <video-stem>.silenced.mp4 | Ruta del video cortado |
--gap <s> | 0.55 | Pausa mínima tratada como silencio recortable |
--head-pad <s> | 0.22 | Silencio conservado antes de la primera palabra |
--tail-pad <s> | 0.34 | Silencio conservado después de la última palabra |
--apply | desactivado | Ejecutar 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.24spara pausas largas (≥2s),0.20sdespués de un final de oración (. ! ?),0.14sen 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+concatde ffmpeg (escrito en un script*.silence-filter.txty pasado mediante-/filter_complex), por lo que el video y el audio se mantienen sincronizados.
Salidas (escritas en --out-dir)
| Archivo | Propósito |
|---|---|
<stem>.silence-edl.json | Rangos de conservar/eliminar, duraciones, parámetros — la lista de edición |
<stem>.silence-transcript.json | Palabras re-sincronizadas en la línea de tiempo editada (alimenta al Agente 2 + ritmo) |
<stem>.silence-decisions.md | Resumen legible para humanos + las pausas más grandes recortadas |
<stem>.silence-filter.txt | El filtro de ffmpeg (solo con --video) |
<video-stem>.silenced.mp4 | El 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--gappara 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.