Communitygithub.com

nategoldai/guion-youtube

Escribe un guion de video de YouTube a partir de una idea básica: opciones de gancho basadas en 21 fórmulas, puntuadas y luego el guion completo con las marcas de retención. Utilízalo siempre que el usuario quiera un guion, un gancho, una línea de apertura, '¿qué debería decir?', 'escribe mi próximo video' o esté a punto de grabar sin tener claro los primeros quince segundos.

¿Qué es guion-youtube?

Esta habilidad transforma una simple idea en un guion de video de YouTube completo y optimizado para retención de audiencia. Está diseñada para creadores de contenido que necesitan superar el bloqueo del escritor y asegurar que sus videos enganchen desde el primer momento. El flujo de trabajo incluye la generación de múltiples opciones de gancho basadas en 21 fórmulas probadas, que luego se puntúan automáticamente con una herramienta Python (`hookscore.py`) para presentar al usuario las dos mejores opciones. A partir del gancho seleccionado, la habilidad estructura el guion en cinco partes clave: gancho, giro (primeros 15-45 segundos), cuerpo (con marcas visuales), recompensa y cierre. Además, respeta la voz del usuario mediante un perfil opcional (`voice.md`) y evita inventar datos o fuentes. El resultado incluye los dos mejores ganchos con su puntuación, el guion completo con indicaciones visuales, el tiempo estimado de lectura y una recomendación sobre la fórmula de gancho utilizada. Es compatible con entornos de línea de comandos y se integra en asistentes de IA como Claude, Cursor, o Codex.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/nategoldai/youtube-agent/tree/HEAD/skills/yt-script

Preguntar en tu IA favorita

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

Documentación

yt-script

Convierte una idea en un guion que la gente ve hasta el final.

Hay herramientas en esta carpeta y realmente funcionan. Úsalas. No juzgues el gancho solo con la vista.

python3 hookscore.py hooks.txt              # clasifica tus opciones de gancho
python3 hookscore.py --hook "una línea"      # puntúa solo uno

Antes de escribir

  1. Lee ~/.claude/youtube/voice.md si existe. Es el perfil de voz del usuario: cómo habla en cámara, palabras que nunca dice, a quién se dirige y qué no afirmará. Si falta, pide tres de sus propios videos, léelos o transcríbelos, deduce la voz y escribe el archivo. Un guion con la voz equivocada es peor que ninguno, porque tienen que decirlo en voz alta.
  2. Nunca inventes un número, un resultado o una fuente. Si una cifra ayudara y no la tienes, pídela o escribe la línea sin ella.

La estructura

Los primeros 15 segundos son todo el trabajo. Deben hacer tres cosas o el video pierde audiencia: confirmar lo que prometió el título, abrir una pregunta que el espectador no pueda dejar ir y mostrar que la recompensa está por llegar.

  1. Gancho. Escribe CINCO usando las 21 fórmulas, pásalos por hookscore.py, conserva los dos mejores y muéstrale al usuario ambos con sus puntuaciones. Nunca entregues solo uno.
  2. El giro (0:15-0:45). Di lo que hará el video, en una oración, y empieza a hacerlo. Sin introducción del canal, sin "antes de empezar", sin pedir suscripción. Esas son la causa más común de abandono a los 0:30.
  3. El cuerpo. Una idea por cada tiempo. Marca cada tiempo con lo que se ve EN PANTALLA, no solo lo que se dice: una cabeza parlante sin nada que mirar es un podcast.
  4. La recompensa. Entrega lo que prometió el gancho, claramente, y di que lo estás entregando: "ese es el prompt, está en la descripción".
  5. El cierre. Una sola petición. No tres.

Qué entregar

  • los dos mejores ganchos con sus paneles de puntuación
  • el guion, tiempo por tiempo, con [EN PANTALLA: ...] en cada tiempo
  • una duración estimada a 150 palabras por minuto
  • una línea que diga qué fórmula usó el gancho ganador y por qué se adapta a esta idea

La regla

Nada de esto se publica. Esta habilidad escribe y tú publicas. Cada resultado termina con un bloque que el usuario copia, y la última línea de cada ejecución pregunta: ¿lo envías, o lo cambias?

Individual skills in this repo

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

nategoldai/youtube-agent

>- Review a YouTube channel from top to bottom - packaging, consistency, the first fifteen seconds, and what to fix first. Use for "audit my channel", "why isn't my channel growing", "look at my videos", or a pasted channel URL.

nategoldai/youtube-agent

>- Write replies to YouTube comments in the creator's voice, sorted by which ones are worth answering. Use for "reply to my comments", "deal with the comment section", "someone asked X", or a pasted comment thread.

nategoldai/youtube-agent

>- Turn the transcript of a raw recording into an edit decision list - dead air, filler lines and retakes, with timecodes. Use for "edit this", "cut the dead space", "tighten this video", "I rambled", or any request to shorten footage from a transcript.

nategoldai/youtube-agent

>- Write and check a YouTube video's title and thumbnail as one pair, testing for truncation, repetition and vagueness before it goes live. Use for "title ideas", "what should I call this", "thumbnail text", "my CTR is low", packaging, or any request to rename or repackage an existing video.

nategoldai/youtube-agent

>- Plan a week or a month of YouTube uploads - what to post, when, and in what order, sized to how much time the creator really has. Use for "plan my week", "content calendar", "what should I post", "no idea what to make next".

nategoldai/youtube-agent

>- Read a YouTube Studio audience-retention export, find where viewers really drop off, and say what to change. Use for "why do people stop watching", "my retention is bad", a pasted retention chart or CSV, or "fix my pacing".

nategoldai/youtube-agent

>- Write the description, chapters, tags and search-facing text for a YouTube video, aimed at what a real person would type. Use for "write my description", "add chapters", "timestamps", "tags", "SEO", "help this video get found", or "nobody can find this".

nategoldai/youtube-agent

>- Find the Shorts hiding inside a long video and write them, using the transcript to pick moments that stand on their own. Use for "cut this into shorts", "clip this", "repurpose this video", or "what should I clip".

nategoldai/youtube-agent

>- Find what's really working in the user's niche on YouTube, rank it by how far each video beat its own channel, then name the formula. Use for "what's working right now", "find viral videos in my niche", "why did this blow up", competitor research, or a swipe file.

Skills relacionados