Communitygithub.com

subtítulos

Genera subtítulos sincronizados con la voz para videos cortos como un clip separado en pantalla verde (más opcional ProRes 4444 con alfa) para After Effects: texto blanco en mayúsculas, contorno negro, sombra paralela dura, 2-3 palabras a la vez, centrado en la parte baja del fotograma, evitando la interfaz de YouTube Shorts y sincronizado con la narración. Úsalo cuando el usuario solicite subtítulos,

¿Qué es subtítulos?

Esta habilidad genera subtítulos sincronizados con la voz como un clip separado en pantalla verde (verde puro #00FF00) que el usuario puede componer en After Effects usando Keylight, evitando que los subtítulos se quemen permanentemente en el video. El estilo de texto está bloqueado según el marco de referencia del usuario: blanco, mayúsculas, Arial Black, con contorno negro y sombra paralela dura (sin desenfoque ni transparencia para evitar bordes verdes difusos al aplicar keying). El tamaño de fuente es del 3,2 % de la altura del fotograma (82 px a 2560) y la posición vertical está al 71,5 % de la altura del fotograma para evitar que la interfaz de YouTube Shorts (botones, título, barra superior) cubra los subtítulos. Cada subtítulo muestra un máximo de 2-3 palabras, nunca cruza una pausa o coma, evita palabras conectoras (the, of, with, yang, di, dengan...) y no divide nombres propios. La puntuación se conserva tal como aparece en el guion. La habilidad verifica automáticamente que cada subtítulo se mantenga dentro de la zona segura de YouTube Shorts (ancho derecho 16 %, inferior 25 %, superior 8 %) y advierte si algún subtítulo la invade. El proceso comienza obteniendo los tiempos de palabra desde un archivo JSON generado por `scripts/words_from_voice.py`, luego se ejecuta una prueba corta con `scripts/captions.py` usando parámetros como `--start` y `--dur`, y finalmente se renderiza la duración completa cuando el usuario da su aprobación. Está optimizado para ejecutarse en Haiku (modelo económico) para ahorrar tokens, dejando Sonnet solo para evaluar nuevos estilos y Opus para cambios en la lógica del script. Esta habilidad es esencial para creadores de contenido que necesitan subtítulos precisos, sincronizados y compatibles con flujos de trabajo profesionales de postproducción.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/fahniazz/claude-shorts-skills/tree/HEAD/skills/captions

Preguntar en tu IA favorita

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

Documentación

Subtítulos (pantalla verde, sincronizados con la voz, seguros para Shorts)

El usuario edita los subtítulos posteriormente en After Effects, por lo que NUNCA se queman en el video. Entregue un clip separado sobre verde puro (#00FF00), del mismo tamaño, fps y número de fotogramas que el video, que se pueda extraer con Keylight.

Aspecto (acordado el 2026-11-11, según el fotograma de referencia "BLOQUEADO" del usuario)

  • Posición: centrado horizontalmente; el centro de las mayúsculas al 71,5 % de la altura del fotograma (debajo del pecho del personaje). El centro de las mayúsculas es el ancla, así que una coma o una Q nunca mueven un subtítulo.
  • Blanco, MAYÚSCULAS, Arial Black, 3,2 % de la altura del fotograma (82 px a 2560). Al principio era 4 %, y el usuario pidió más pequeño para que la interfaz de Shorts nunca lo cubra. Contorno negro; sombra paralela dura hacia abajo a la derecha. La sombra es sólida a propósito: una sombra borrosa/semitransparente al hacer keying produce un borde verde-gris.
  • Se conserva la puntuación tal como aparece en el guion (MONA LISA. / PARIS, / 1911.). El usuario lo pidió. --strip-punct elimina los puntos, comas, punto y coma y dos puntos finales.
  • Máximo 2-3 palabras por subtítulo. Un subtítulo nunca cruza una oración/comma o una pausa en la voz, nunca termina en una palabra conectora (the, of, with, yang, di, dengan ...), nunca divide un nombre (Mona | Lisa) y evita palabras sueltas.
  • Cada subtítulo aparece en el fotograma en el que se pronuncia su primera palabra (un pop de 5 fotogramas 0.85 -> 1.06 -> 1) y se mantiene hasta el siguiente. Después de una pausa en la voz, desaparece 0.25 s después de su última palabra.

Zona segura de YouTube Shorts (debe cumplirse para cada subtítulo, en el pico 1.06 del pop)

Áreas de superposición conservadoras:

  • botones de acción: 16 % derecho del ancho
  • título/canal/música: 25 % inferior de la altura
  • barra superior: 8 % superior de la altura

El script mide la tinta de cada subtítulo, imprime ADVERTENCIA: fuera de la zona segura de Shorts: <texto> para cualquier subtítulo que cruce una zona, e imprime el alcance (debe ser aproximadamente "83.8 % del ancho, 69.8-74.0 % de la altura"). Los fragmentos se dividen para que quepan en --max-width 0.68. Una palabra larga solitaria se reduce para que quepa. Nunca entregue con una ADVERTENCIA: reduzca --size, o suba un poco --y.

Modelo (ahorro de tokens, aprobado el 2026-11-12)

Ejecute subtítulos en Haiku 5.5 (agente remotion-renderer con model: "haiku", o una sesión de Haiku): el script realiza la sincronización, división y comprobaciones de zona segura y las imprime como texto. Use Sonnet solo para evaluar un nuevo aspecto de subtítulos; Opus solo para cambiar la lógica de scripts/captions.py.

Pasos

  1. Tiempos de palabra: el archivo stories/<slug>/voice/words.json del video corto. Es creado por scripts/words_from_voice.py (faster-whisper alineado con la ortografía del guion). Si falta, créelo primero: python scripts/words_from_voice.py <voice.wav> <SCRIPT.md> <words.json> [en|id]. Los tiempos deben coincidir con el audio del video (la voz del video final comienza en 0 s).
  2. Pruebe un fragmento primero (el usuario quiere VER una prueba corta antes de un renderizado completo):
    python scripts/captions.py stories/<slug>/voice/words.json out/<slug>/captions --start 0 --dur 10 \
      --preview "out/<slug>/final/<Título>.mp4" --alpha
    
    Esto imprime cada subtítulo con sus tiempos y la comprobación de zona segura, y escribe:
    • captions_green.mp4
    • captions_alpha.mov
    • captions.json
    • captions_preview.mp4 (video + subtítulos extraídos + sonido, solo para verificar)
  3. Verifique:
    • Extraiga fotogramas de los subtítulos más anchos de la vista previa con las zonas de Shorts dibujadas en rojo (ffmpeg drawbox: x=iw0.84 desde y=ih0.45, y=ih0.75 hasta el fondo, la parte superior ih0.08), apílelos con hstack en una sola hoja y observe.
    • Observe un recorte a resolución completa en busca de bordes verdes.
    • Envíe al usuario captions_preview.mp4, captions_green.mp4 y la lista impresa de subtítulos.
  4. Después de la aprobación del usuario, renderice la duración completa con --dur <fotogramas del video / fps> para que el clip tenga exactamente el número de fotogramas del video (verifique con ffprobe -count_packets).

Parámetros (scripts/captions.py)

  • --y 0.715: posición
  • --size 0.032: tamaño de fuente
  • --max-width 0.68: subtítulo más ancho
  • --font <ttf>
  • --max-words 3
  • --gap 0.30: pausa que rompe una frase
  • --hold 0.25
  • --lead 0: fotogramas adelantados
  • --no-pop
  • --lower: conservar mayúsculas/minúsculas
  • --strip-punct
  • --alpha: ProRes 4444

Notas para After Effects (para el usuario)

  • Clip verde: use Keylight con Color de Pantalla = verde puro. Está en yuv444 crf 8, por lo que los bordes se mantienen limpios.
  • Alpha .mov: no necesita keying en absoluto (colóquelo encima).
  • captions.json: lista el texto de cada subtítulo y los segundos de entrada/salida, para reconstruirlos como capas de texto.

Skills relacionados