Communitygithub.com

10llo/reelkit

Se utiliza cuando llega la grabación del talento para un episodio de reelkit: transcribirla localmente con Whisper, corregir los subtítulos según el guion, reajustar los tiempos de las escenas, revisar los cambios con el usuario y aplicarlos.

¿Qué es reelkit?

Esta skill automatiza la sincronización de un clip de vídeo del talento con un guion predefinido para un episodio en la plataforma reelkit. Es útil para creadores de contenido o equipos de edición que buscan alinear automáticamente las palabras habladas con los subtítulos y los cortes de escena, manteniendo la ortografía del guion y permitiendo una revisión manual antes de aplicar los cambios. Funciona integrando el transcriptor local Whisper, compatible con modelos desde `small` (más rápido, menos preciso) hasta `large-v3-turbo` (más preciso, pero requiere descarga de ~1.6 GB). Tras la transcripción, propone correcciones, marca palabras no escuchadas o añadidas por el talento, y genera un informe de revisión en español. Finalmente, permite al usuario aprobar y aplicar la sincronización, con opciones para manejar desbordamientos de voz o clips incorrectos.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/10llo/reelkit/tree/HEAD/skills/caption-sync

Preguntar en tu IA favorita

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

Documentación

Sincronización de subtítulos

El clip del talento se coloca en la ranura inferior derecha; su voz impulsa los subtítulos y los cortes de escena. Nada cambia en el episodio hasta que el usuario aprueba la revisión.

Todos los comandos se ejecutan desde la raíz del espacio de trabajo.

1. ¿Whisper listo?

npm run reelkit -- whisper check --model=<modelo>   # el modelo que usarás; por defecto large-v3-turbo

Si el modelo no está descargado, sync prepare lo descarga (1.6 GB para large-v3-turbo) — informa al usuario primero, u ofrece --model=small (586 MB, menos preciso). Si WebGPU no está disponible, sync aún adjunta el clip pero los subtítulos se mantienen temporizados desde el guion ("provisional").

2. Preparar (solo escribe propuestas)

npm run reelkit -- sync prepare episodes/<carpeta> <ruta/al/clip> [--model=large-v3-turbo]

Copia el clip como talent.proposed.<ext>, lo transcribe, alinea las palabras con el guion y escribe:

  • sync-report.md — la revisión (español): detalles del clip, silencio recortado al inicio, cortes de escena antes → después, cada palabra que difiere (corregida a la ortografía del guion, ⚠ Revisar sustituciones lejanas que muestran lo que se escuchó, ⚠ No se escuchó palabras omitidas, ad-libs mantenidos tal como se escucharon), advertencias, y si la voz se extiende más allá del final.
  • captions.proposed.json — los subtítulos que usará el vídeo (editables: cambia el "text" de una palabra para corregirla).
  • sync-proposal.json — recorte, inicios de escena, archivos.

Cómo decide la alineación: la ortografía del guion con la temporización de Whisper para palabras que coinciden o casi coinciden (los números coinciden con su forma hablada: "12" ↔ "doce"); una sustitución lejana muestra lo que se escuchó y se marca; las palabras que Whisper no escuchó se omiten de los subtítulos; las palabras adicionales que dijo el talento se mantienen.

3. Revisar con el usuario

Lee sync-report.md y muestra al usuario una tabla breve: cortes de escena (antes → después), cada palabra marcada (escena, guion, escuchado, estado, tiempo), y la línea de desbordamiento si la hay. Pídele que apruebe, o que indique qué palabras cambiar (edita captions.proposed.json, luego muestra el cambio).

  • La voz se extiende más allá del final (⚠ La voz sigue … s): las últimas palabras se cortarían. Recomienda regrabar más corto. Solo con el acuerdo explícito del usuario, aplica con --accept-overrun.
  • Una escena completa no se escuchó: los visuales pueden no coincidir con lo dicho — pregunta si regrabar o continuar.
  • Baja coincidencia ("¿Es el clip correcto?"): confirma que es el clip y episodio correctos.

4. Aplicar (después de la aprobación)

npm run reelkit -- sync apply episodes/<carpeta> [--accept-overrun]

Renombra el clip preparado a talent.<ext>, escribe captions.json, guarda clip, sceneStarts, captionsSrc y stage: "synced" en episode.json, y elimina el clip anterior que reemplazó.

5. Verificar

npm run check -- episodes/<carpeta>
npx remotion still Episode out/<carpeta>-sync.png --public-dir episodes/<carpeta> --frame=<N>

Visualiza un fotograma en medio de una frase: el clip llena la ranura y el subtítulo muestra la palabra que se está diciendo. Ofrece Studio: npm run studio -- episodes/<carpeta>. Siguiente: /reelkit:export.

Skills relacionados