Communitygithub.com

jhatpat-reel

Convierte una larga toma parlante en un Reel de Instagram o Short de YouTube ajustado. Elimina silencios, conserva la mejor toma de cada línea, reencuadra a 9:16 / 1:1 / 16:9, añade subtítulos al estilo Instagram y exporta un EDL para Premiere Pro. Ideal para creadores en hinglish e hindi que graban una sola toma con el móvil o la DSLR.

¿Qué es jhatpat-reel?

jhatpat-reel es un skill de edición de primer paso para creadores de contenido que graban una única toma de hablar a cámara (talking head) con el teléfono o una DSLR. Está diseñado específicamente para generar automáticamente un Reel de Instagram o un Short de YouTube a partir de ese metraje largo, eliminando silencios y tiempos muertos, manteniendo la mejor repetición de cada línea (si se proporciona una transcripción) y reencuadrando el video a formatos verticales (9:16), cuadrados (1:1) y horizontales (16:9). Además, quema subtítulos dinámicos al estilo Instagram y genera un EDL (Edit Decision List) que se puede importar directamente en Adobe Premiere Pro para ajustes finales. El skill funciona en sistemas que tengan ffmpeg, ffprobe y Python 3.9+ instalados; la transcripción es opcional pero necesaria para detectar retomas y tartamudeos. Está pensado para contenido en hinglish, hindi o inglés. Su flujo consta de varias etapas: inspección del metraje, corte bruto (rough cut), verificación auditiva, reencuadre, quema de subtítulos y un checklist de calidad final. El skill nunca modifica el metraje original y sigue reglas estrictas como no aplicar zoom en los cortes y mantener pausas naturales mínimas de 0.2 segundos.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ankurrattan0110-spec/jhatpat-reel/tree/HEAD

Preguntar en tu IA favorita

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

Documentación

¿Qué hace jhatpat-reel?

La cosa clara: dame una toma larga, recibe un reel ajustado. El primer borrador lo hace la máquina, el gusto lo pones tú.

Este skill es un editor de primer paso, no un editor final. El script elimina silencios y tiempos muertos; los retomas y titubeos los indicas tú (o Claude, leyendo la transcripción). El metraje original nunca se modifica.

Cuándo usarlo

  • Un solo orador, una sola toma, desde el móvil o la DSLR — talking head.
  • Instagram Reel, YouTube Short, o ambos a partir de la misma toma.
  • Hinglish, hindi o inglés — los tres funcionan.

Cuándo no: entrevista multicámara, videoclip musical, o una edición donde cada corte requiera criterio artístico. Para eso, abre la línea de tiempo tú mismo.

Qué necesitas

ElementoPor quéVerifica
ffmpeg + ffprobecortar, reencuadrar, subtítulosffmpeg -version
python3 3.9+los tres scriptspython3 --version
transcripción (opcional)para detectar retomaswhisper / whisperx / cualquier STT
fuente Devanagari (opcional)subtítulos en hindiNoto Sans Devanagari

Pipeline

La salida de cada etapa alimenta la siguiente. Puedes detenerte a medio camino para revisar y luego continuar.

Etapa 0 — mira, luego corta

Analiza el metraje. Dile al creador en una línea: duración, resolución, fps, en qué canal está el audio. Si ya es vertical, se puede omitir el reencuadre. Si el audio solo está en un canal (problema común con micrófonos inalámbricos), arréglalo primero — de lo contrario, después del corte la mitad del reel se quedará sin sonido.

Si se puede obtener una transcripción, tráela ya. Sin transcripción, este skill solo puede eliminar silencios; no puede detectar retomas ni tartamudeos. Dilo claramente al creador.

Etapa 1 — corte bruto

python3 scripts/rough_cut.py take.mp4 --preset reel

Presets: reel (por defecto, apretado), calm (poesía, historia, conversación larga), tight (gancho pesado, rápido).

Esto genera tres cosas: cuts.json, <name>_cut.mp4, <name>.edl.

Si hay transcripción, lee cuts.json y elimina los fragmentos de retomas: si una misma línea se dice dos o tres veces, quédate con la última clara y borra las demás. "perdón", "una vez más", "emm" — también se eliminan. Luego renderiza de nuevo. No edites cuts.json a mano; cambia el preset o la configuración y vuelve a ejecutar el script.

Etapa 2 — escucha el corte para verificar

Es obligatorio escuchar 0.2 segundos a cada lado de cada corte. Si alguna palabra se corta por la mitad, aumenta --pre-pad o --post-pad. La transcripción puede verse bien aunque el audio esté partido.

Etapa 3 — reencuadre

python3 scripts/reframe.py take_cut.mp4 --all        # 9:16 + 1:1 + 16:9
python3 scripts/reframe.py take_cut.mp4 --to 9:16 --anchor 0.3

Con --anchor se determina desde dónde se corta el encuadre. En un talking head la cara queda arriba, por eso el valor por defecto es 0.35. Si se corta la cara, reduce el anchor. Para grabaciones de pantalla usa --mode pad — con crop se corta el texto.

Etapa 4 — subtítulos

python3 scripts/burn_captions.py take_cut_9x16.mp4 take.srt --style pop --accent "#C6FF3D"

Estilos: pop (1-3 palabras grandes en el centro — ideal para reel y gancho), box (caja sólida, legible incluso sobre metraje con mucho movimiento), bar (línea fina abajo, para formato largo).

El script divide automáticamente las pistas largas en fragmentos pequeños, para que el estilo pop tenga sentido. Para subtítulos en hindi, pasa la ruta de una fuente Devanagari con --font — de lo contrario, la mitad de los caracteres no se dibujarán.

Etapa 5 — última revisión

Antes de exportar, pasa esta lista de verificación sobre tu propio trabajo:

  1. El primer segundo. Que haya algo en el primer fotograma — cara, una palabra grande, o movimiento. Un fotograma vacío = el usuario se desplaza.
  2. Ninguna palabra cortada. Escucha tres cortes al azar.
  3. Subtítulos no tapan la cara. En 9:16, pop aparece en el centro; si la cara está en el centro, es mejor --style box.
  4. Los últimos 2 segundos. Que se vea la llamada a la acción y se detenga, que no se escape.
  5. El audio. Tanto Instagram como YouTube normalizan a -14 LUFS. Si lo dejas más bajo, ellos lo subirán y sonará mal:
    ffmpeg -i final.mp4 -af loudnorm=I=-14:TP=-1.5:LRA=11 -c:v copy out.mp4
    

Reglas (cada regla con su motivo)

  • Nunca toques el metraje original. Todo se hace en archivos nuevos. Porque un solo render incorrecto y la grabación se pierde.
  • Sin zoom en los cortes. Porque el zoom en el corte anuncia el corte.
  • Un reel, una idea. La segunda idea es otro reel. Porque dos ideas juntas = ninguna se recuerda.
  • No elimines todas las pausas. No bajes pause_keep de 0.2 s. Porque las palabras completamente pegadas suenan a robot, y se necesita espacio para respirar.
  • Solo después del gancho. Si los primeros 3 segundos no están bien, el resto de la edición sobra. Porque ahí es donde la gente se desplaza.
  • Lo que el creador eliminó a mano, no lo recuperes. Antes de volver a renderizar, lee su versión.
  • Sin transcripción, no prometas detección de retomas. Sé claro: "eliminé silencios, las retomas las tienes que revisar tú".

Configuración

Copia config.example.json a config.json, luego usa --config config.json. El significado de cada valor está escrito ahí mismo.

Lo que este skill NO hace

  • No graba. La grabación es tuya.
  • No publica en Instagram.
  • No descarga ni copia el video de otro.
  • No elige música — la licencia es tu responsabilidad.
  • No genera transcripciones; tú ejecutas el STT y proporcionas el SRT.

Incorpora las notas de vuelta al skill

Cuando el creador diga "el corte está muy entrecortado" o "el subtítulo tapa la cara", arréglalo y escribe esa nota aquí como una regla, con su motivo. Después de dos o tres reels, este skill se ajustará a tu gusto.

Skills relacionados