Communitygithub.com

generador-de-guiones-para-instagram-reels

Convierte una idea en un guion completo para Reel: 3 ganchos con puntuación, texto hablado y en pantalla, y una hoja de tiempos lista para grabar.

¿Qué es generador-de-guiones-para-instagram-reels?

Este skill es un generador profesional de guiones para Instagram Reels, diseñado para cualquier agente de IA o editor de video que necesite transformar una idea simple en un guion completo, puntuado y listo para grabar. Evalúa hasta 3 ganchos usando 26 fórmulas probadas mediante un sistema de puntuación (`hookscore.py`), genera el texto hablado y el texto en pantalla por separado, y produce una hoja de tiempos (`beats.py`) que verifica automáticamente si hay ganchos lentos o pausas muertas. Es especialmente útil cuando el usuario pide un guion para Reel, ganchos, voz en off, o cuando está a punto de grabar sin una primera línea preparada. Si se conecta al MCP de IShort, puede recuperar los mejores ganchos pasados del usuario y transcripciones atípicas para mejorar el estilo. El flujo de trabajo incluye pasos previos como leer la voz de marca (desde `~/.instagram-claude-skills/brand-voice.md`) y verificar evidencia de fórmulas previas, asegurando que el guion sea único, concreto y sin datos inventados. Soporta plataformas como Claude Code y cualquier sistema que ejecute scripts Python desde la línea de comandos.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ishort-pro/instagram-claude-skills/tree/main/skills/instagram-reel-script-generator

Preguntar en tu IA favorita

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

Documentación

Generador de guiones para Instagram Reel

Una idea en bruto entra, un guion puntuado, cronometrado y listo para grabar sale.

python3 scripts/hookscore.py hooks.txt              # clasifica las opciones de gancho (uno por línea)
python3 scripts/hookscore.py --hook "una línea"      # puntúa uno
python3 scripts/beats.py script.txt --target 30     # hoja de tiempos cronometrada

Antes de escribir

  1. Voz. Lee ~/.instagram-claude-skills/brand-voice.md. Si falta, obtén tres reels propios del usuario (IShort: list_my_scripts filtrados por su usuario, o pega) y escribe el archivo a partir de templates/brand-voice.md. Tienen que decirlo en voz alta; la voz incorrecta es inutilizable.
  2. Evidencia. Si existe ~/.instagram-claude-skills/swipe.md (escrito por instagram-reels-research), sus fórmulas superan a las predeterminadas. Con IShort, search_my_scripts("<topic>") muestra cómo abrieron los casos atípicos sobre este tema.
  3. Una única cosa concreta y verdadera. Si la idea es débil, haz una pregunta agrupada: ¿qué pasó, a quién, qué costó o devolvió? No rellenes.

La estructura

0:00-0:02  GANCHO   la afirmación. La línea hablada y la línea en pantalla se escriben POR SEPARADO.
                    Movimiento o un cambio en el primer fotograma.
0:02-0:07  INTERÉS  por qué el espectador debería importarle. Una línea.
0:07-...   CUERPO   una idea por latido; cambia el fotograma en cada latido.
ÚLTIMOS 3s CIERRE   cumple lo prometido por el gancho, luego la única petición.
ÚLTIMA LÍNEA BUCLE  repite una palabra del gancho para que la repetición encaje.

Duración predeterminada de 20 a 40 segundos. Lo largo se gana, no se asume.

Ganchos

Lee references/hooks.json (26 fórmulas: plantilla, ejemplo, versión en pantalla, cuándo usarla, cómo se arruina). Escribe 3 ganchos de 3 fórmulas diferentes, ejecuta hookscore.py y encabeza con el mejor.

Sé honesto sobre el puntuador: detecta de forma fiable los malos ganchos (saludos, preámbulos, nada concreto, demasiado largos, "deja de desplazarte", emojis) y no elige ganadores entre dos ganchos decentes. Los factores determinantes limitan un gancho a 45. Si el mejor gancho está por debajo de 50, ninguno de ellos es el gancho; escribe más.

Texto en pantalla

Un guion aparte: máximo 6 palabras por tarjeta, se lee antes de que se oiga. La primera tarjeta lleva la palabra clave del tema (Instagram y Google la indexan). Incrusta subtítulos para el cuerpo; la mayoría de la gente empieza con el sonido apagado.

Comprueba el tiempo

Ejecuta beats.py --target <segundos>. Corrige cada bandera: gancho después de 3 s, cualquier latido de más de 4 s en un fotograma, tres latidos sin nada concreto, sin bucle. Vuelve a ejecutar hasta que esté limpio.

Salida

REEL LISTO
gancho: #<id> <fórmula>, puntuado <n> <veredicto>   (alternativas: <n>, <n>)
duración: <s>s en <n> latidos
[guion hablado, entre comillas invertidas]
[tarjetas en pantalla con tiempos]
[lista de tomas: qué hay en pantalla por latido]
siguiente: instagram-seo-caption-generator --script <este guion>

Ejecuta instagram-humanizer en el guion hablado antes de mostrarlo.

Reglas

  • Sin números inventados, clientes ni resultados: {{tu número}} + una bandera.
  • Una idea por Reel. Dos ideas, dos Reels.
  • Nunca abras con un saludo, "en este video" ni "deja de desplazarte".
  • Tú escribes, ellos graban y publican.

Crédito: fórmulas de gancho, hookscore.py y beats.py adaptados de instagram-agent-skill por Jake Schincariol (MIT). Consulta NOTICE.

Individual skills in this repo

This repo contains 6 individual skills — each has its own dedicated page.

instagram-carousel-generator

Instagram carousel generator: turns an idea, a Reel script or a blog post into a 6-10 slide carousel - the cover that earns the swipe, one idea per slide, a recap slide people save and send, one CTA - plus slide copy sized for 1080x1350, a keyword-first caption and alt text for every slide. Use when the user says "carousel", "slides", "swipe post", "turn this reel/blog/thread into a carousel", or has a list, steps, framework or before/after that would die as a single image. Repurposes the user's best transcripts from the IShort MCP.

instagram-claude-skills

Instagram Claude skills for content creation: a router for 9 skills that research outlier Reels, extract and reverse-engineer reel scripts, write scored Reel scripts and hooks, generate SEO captions from the video script, build carousels, plan the content calendar, analyze competitors, optimize the bio and link in bio, and humanize AI text. Use for any Instagram, Reels, caption, hook, script, carousel, content plan, Instagram SEO or profile task. Connects to the IShort MCP (ishort.pro/mcp) for real reel data and transcripts.

instagram-content-calendar

Instagram content calendar and weekly content planner: builds the week (or month) of Reels, carousels and stories from evidence - the user's own top reels, niche outliers and real events - with the format, hook formula, SEO keyword, posting slot and engagement list per day. Use when the user says "plan my week", "content calendar", "what should I post", "content plan", "posting schedule", "I have nothing to post", or wants a month of ideas. Uses the IShort MCP (list_my_scripts, search_my_scripts, get_bio_analytics) to plan from what already worked for them.

instagram-humanizer

Humanize AI-written Instagram captions, Reel scripts, comments and DMs: strips em dashes, AI slop words ("delve", "game-changer", "in today's video"), invisible watermark characters and stock Instagram phrases, then scores the text on a five-check AI-detection panel and reports the before/after. Use when the user says "humanize", "does this sound like AI", "remove em dashes", "de-slop this", "make it sound human", "this sounds like ChatGPT", and before any caption, script, comment or DM from this pack is shown to the user.

instagram-reels-research

Find the Instagram Reels that are actually working in a niche right now and turn them into a swipe file: ranks reels by outlier multiple (views divided by the account's own median, not raw views), names the hook formula each used, and flags which to transcribe. Use when the user says "find viral reels", "what's working in my niche", "content research", "outlier reels", "reverse engineer this account", "build a swipe file", "what should I make next", or exports reels from IShort. Reads IShort CSV exports and the IShort MCP (list_my_scripts, get_competitor_report, get_reel_details).

instagram-seo-caption-generator

Instagram SEO caption generator that writes the caption FROM the Reel's video script: mines the keywords the video actually says, puts the primary keyword in the first 125 characters, writes the on-screen title, alt text and 3-5 hashtags, then scores the caption /100 for Instagram Search and Google. Use when the user wants a caption for a Reel, "write my caption", "SEO caption", "caption from this script/transcript/video", "make this post searchable", "keywords for my reel", "rank my reel on Google", or pastes a reel URL and wants a caption. Uses the IShort MCP (transcribe_reel) to get the script from a reel URL.

Skills relacionados