Communitygithub.com

ig-reel

Convierte una idea en bruto en un Reel completo: opciones de gancho basadas en 26 fórmulas, el guion hablado, el texto en pantalla y una escaleta cronometrada, todo en la voz del usuario y evaluado antes de grabar. Úsalo siempre que quieras un Reel, un video corto, un gancho, un voiceover, "haz un reel sobre X", "¿qué debería decir en este video?", o estés a punto de grabar y no tengas la primera línea.

¿Qué es ig-reel?

La habilidad **ig-reel** está diseñada para automatizar la escritura de Reels de Instagram, partiendo de una simple idea y generando un guion completo listo para grabar. Es útil porque sistematiza todo el proceso creativo: selecciona y puntúa ganchos entre 26 fórmulas probadas, escribe el guion hablado y el texto en pantalla por separado, cronometra cada sección, y se asegura de que el resultado esté en la voz única del usuario, todo antes de presionar el botón de grabar. Está pensada para agentes como Claude Code, Codex, Cursor o Windsurf y funciona mediante dos herramientas locales: `hookscore.py` para clasificar y puntuar los ganchos, y `beats.py` para generar una escaleta cronometrada. El flujo incluye leer un perfil de voz del usuario (`voice.md`), aplicar las fórmulas de `hooks.json`, y pasar el guion por `/ig-human` para naturalizarlo. El resultado final es un bloque de producción que incluye el gancho vencedor, la duración exacta, el texto en pantalla y el estado de humanización, sin publicar nunca automáticamente, solo registrando el progreso en un log local.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/GouravRusiya30/instagram-kiro-skill/tree/master/skills/ig-reel

Preguntar en tu IA favorita

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

Documentación

¿Qué hace ig-reel?

Convierte una idea en bruto en un Reel que alguien termina.

En esta carpeta viven dos herramientas que realmente funcionan. Úsalas. No calcules el gancho a ojo y no adivines la duración.

python3 hookscore.py hooks.txt              # clasifica tus opciones de gancho
python3 hookscore.py --hook "una línea"      # puntúa un solo gancho
python3 beats.py script.txt --target 30     # escaleta cronometrada antes de grabar

Antes de escribir

  1. Lee ~/.claude/instagram/voice.md si existe. Es el perfil de voz del usuario: cómo habla en cámara, lo que nunca dice, a quién se dirige. Si no existe, pide tres de sus propios reels, transcríbelos o léelos, deduce la voz, y escribe el archivo. Un guion con la voz equivocada no sirve, porque tienen que decirlo en voz alta.
  2. Lee hooks.json en esta carpeta. 26 fórmulas, cada una con una plantilla, un ejemplo completo, la versión en pantalla, para qué sirve y cómo se arruina. Cuatro de ellas están ahí porque aparecían en ganchos reales, no porque completaran un patrón.
  3. Si la idea es demasiado vaga, no la alargues. Haz una pregunta agrupada: ¿qué pasó, a quién, y qué costó o devolvió? Un Reel necesita una única cosa verdadera y específica. Consíguela antes de escribir.
  4. Si existe ~/.claude/instagram/swipe.md, léelo. /ig-viral escribe ese archivo, y es la evidencia del usuario sobre qué fórmulas están funcionando en su nicho ahora mismo. Esto supera los valores por defecto de este archivo.

La estructura

Un Reel se decide en los primeros dos segundos y se mantiene en los siguientes cinco.

0:00 - 0:02   GANCHO      la afirmación. Línea hablada y línea en pantalla,
                          escritas por separado. Movimiento en el primer fotograma,
                          no una cara estática.
0:02 - 0:07   LA APUESTA  por qué esto le importa a la persona que mira. Una línea.
0:07 - ...    EL CUERPO   una idea por sección, y el plano cambia en cada sección.
ÚLTIMOS 3s   EL CIERRE   cumple lo que prometió el gancho, luego la única petición.
ÚLTIMA LÍNEA  EL BUCLE   repite una palabra del gancho para que la repetición
                          encaje limpiamente.

Duración: de 15 a 45 segundos es el rango funcional. Los Reels llegan a 3 minutos casi nadie debería usarlos. Por debajo de 7 segundos los contadores de bucle se inflan y nada más.

El flujo

1. Elige tres ganchos, no uno. Pasa la idea por hooks.json, elige tres fórmulas que realmente encajen, y escribe la línea hablada más la línea en pantalla para cada una. Fórmulas distintas, no tres versiones de la misma.

2. Puntúalos. Pon las tres líneas habladas en un archivo, una por línea, y ejecuta hookscore.py. Muestra al usuario la clasificación. Si el primero está por debajo de 50, aún no tienes el gancho y ninguna edición lo arregla.

3. Escribe el guion sobre el gancho ganador. Lenguaje hablado llano, como habla el usuario realmente. Contracciones. Líneas cortas. Ninguna frase que tuvieran que ensayar.

4. Cronometra. Ejecuta beats.py script.txt --target {duración}. Corrige cada señal: un gancho que pase de 3 segundos, cualquier sección de más de 4 segundos, una secuencia de secciones sin nada concreto, ningún bucle. Vuelve a ejecutar hasta que esté limpio.

5. Humanízalo. Pasa el guion por /ig-human antes de mostrarlo. Una línea que suena escrita es obvia en el momento en que alguien la dice en voz alta.

6. Imprime el bloque. El guion en un bloque de código, el texto en pantalla como una lista separada con tiempos, y luego:

REEL LISTO
gancho:      #3 Nadie te dice, puntuado 86 FUERTE
duración:   28,4 s en 9 secciones a 165 ppm
texto en pantalla:  6 tarjetas
humanizador: 4 artefactos eliminados, puntuación humana 81 APROBADO
pie de foto: ejecuta /ig-caption a continuación

Responde "sí" para registrarlo, o dime qué cambiar.

7. Nunca publiques. Esta habilidad produce un guion. El usuario lo graba y lo publica. Al responder "sí", añade la entrada a ~/.claude/instagram/log.md con la fecha, la fórmula de gancho usada y la primera línea, para que /ig-audit tenga un historial después.

El texto en pantalla es un guion aparte

Escríbelo por separado, siempre. Se lee antes de oírse.

  • Seis palabras o menos por tarjeta. Lo lee alguien con el brazo extendido que aún no está escuchando.
  • La tarjeta del gancho aparece en el fotograma 1, no después de un segundo de silencio.
  • Mantenlo dentro de la zona segura. En un fotograma de 1080x1920, nada por encima de y=230 ni por debajo de y=1440, y mantén los 230 píxeles de la derecha despejados. La interfaz se sitúa encima de todo lo que esté fuera de esa caja: el pie de foto, la barra de acciones, la tira de audio.
  • Nunca pongas el gancho donde va el pie de foto. Es la parte inferior del fotograma y queda cubierta.
  • Incorpora subtítulos para el cuerpo. La mayoría ve primero sin sonido.

Reglas que marcan la diferencia

  • Una idea por Reel. Si el guion tiene dos, tienes dos Reels. Dilo.
  • Números sobre adjetivos. "$4.200" supera a "un montón". Si el usuario no ha dado un número, pídelo en lugar de escribir alrededor del hueco.
  • Elimina la introducción. Sin saludo, sin "en este video", sin nombre, sin logo. El video comienza en la frase a la que normalmente llegarías en el segundo seis.
  • Cambia el plano en cada sección. Un plano fijo de 8 segundos es donde la gente se va, y beats.py lo marcará.
  • Una única petición al final. Comenta una palabra clave, guárdalo o sigue. Una.
  • Nunca inventes. Sin métricas, clientes, ingresos o resultados falsos bajo el nombre del usuario, ni siquiera como marcador de posición. Si se necesita un número y se desconoce, deja {{tu número}} en el guion y márcalo.
  • No escribas un guion alrededor de un audio de moda que el usuario no pueda usar. Si la idea necesita la voz del usuario, dilo.

Ejemplo

/ig-reel redujimos el tiempo de propuesta de 5 horas a 20 minutos con una plantilla
GANCHOS  (puntuados)
  86  FUERTE  #5  Colapso Temporal   "Antes las propuestas me tomaban cinco horas. Ahora veinte minutos."
                                     en pantalla: 5 HORAS -> 20 MIN
  71  FUERTE  #1  Confesión de Coste "Facturé cuatro horas a la semana por dar formato. Durante dos años."
                                     en pantalla: 2 AÑOS PERDIDOS
  54  OK      #9  El Robo            "Roba la plantilla de propuesta que lo logró."
                                     en pantalla: RÓBALA

Grabando #5: la proporción es creíble, se lee de un vistazo en pantalla,
y el número es tuyo.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Skills relacionados