CommunityRedacción y edicióngithub.com

cubxxw/youtube-script-writer

Escribe guiones de YouTube de alta retención — explicativos, tutoriales, videoensayos, reseñas o parlamentos — estructurados con empaque, apertura impactante, acumulación de valor y retención para mantener la audiencia más allá de los puntos de abandono.

¿Qué es youtube-script-writer?

Esta habilidad ayuda a creadores a producir guiones de YouTube altamente atractivos, estructurados y visualmente dinámicos, optimizados para el algoritmo de retención de la plataforma. Convierte ideas, artículos o transcripciones en un guión listo para grabar, con indicaciones visuales claras, marcas de ritmo y direcciones de audio. Genera conceptos de título y miniatura, múltiples opciones de gancho, un cuerpo detallado por capítulos con dispositivos de retención (cambios visuales cada 4-8 segundos, interrupciones de patrón) y un final que evita la salida del espectador. Está diseñado para plataformas como Claude Code, Cursor o cualquier agente que pueda escribir guiones de video, y se adapta a cualquier tema o audiencia especificada, asumiendo razonablemente los detalles faltantes.

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

Installed? Explore more Redacción y edición skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Preguntar en tu IA favorita

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

Documentación

Habilidad de Escritor de Guiones de YouTube

Esta habilidad ayuda a los creadores a escribir guiones altamente atractivos, estructurados y visualmente dinámicos, optimizados para el algoritmo de retención de YouTube. Convierte ideas, artículos o transcripciones en un guión listo para grabar con señales visuales claras, indicadores de ritmo y direcciones de audio.

Qué Produce Esta Habilidad

  • 3 Conceptos de Título y Miniatura: Títulos optimizados para CTR que se corresponden con desencadenantes psicológicos distintos (curiosidad, orientado a resultados, contrario) acompañados de sugerencias claras de diseño de miniatura visual.
  • 3 Variaciones de Gancho (0:00 - 0:30): Diferentes formatos de gancho (declaración contraria, preparación de historia, interrupción de patrón) que cumplen inmediatamente con la promesa del título.
  • Tabla de Guión Optimizada para Retención: Un guión en formato de tabla o bloque que separa las señales de video (B-roll, ángulos de cámara, superposiciones de texto, zooms) y señales de audio (diálogo, voz en off, efectos de sonido, cambios de música).
  • Outro y Metadatos del Video: Un final de video sin interrupciones diseñado para prevenir la salida del espectador, junto con plantillas de descripción optimizadas para búsqueda y etiquetas relevantes.

Entradas Requeridas

Trabaja a partir de lo que se te da. Si falta alguno de estos, aún así produce la salida completa: llena cada vacío con una suposición razonable marcada como (asumido, confirmar) y enumera esas suposiciones al final. Haz una pregunta solo cuando el tema central en sí mismo falte (no hay nada sobre qué escribir).

  • Tema/Concepto — ¿De qué trata el video? (ej., "Cómo construí un SaaS en 30 días")
  • Audiencia Objetivo — ¿Quién está viendo? (ej., desarrolladores principiantes, estudiantes de diseño)
  • Duración Objetivo — Duración aproximada en minutos (ej., 5-7 minutos, 10-15 minutos)
  • Tono/Voz del Guión — Ej., enérgico, educativo, narrativo, conversacional, cómico
  • Objetivo Principal — (ej., conseguir suscripciones al boletín, vender un curso, aumentar la retención de espectadores)

Modelo de Ritmo y Retención

Cada guión de YouTube debe seguir esta estructura para evitar el abandono temprano:

  1. El Gancho (0:00 - 0:30): Promete valor inmediato. Sin introducciones, sin animación de logotipo ni saludo genérico ("Hola chicos, bienvenidos de nuevo...").
  2. Las Apuestas / Re-gancho (0:30 - 1:00): Establece por qué este tema es difícil, urgente o valioso. Introduce al "villano" (el problema) y al "héroe" (la solución).
  3. Capítulos / Hitos (1:00 - 90% del tiempo): Divide el contenido central en 3-5 capítulos distintos. Cada capítulo debe tener un micro-pago claro.
  4. Interrupciones de Patrón: Sugiere cambios visuales o de audio cada 4-8 segundos. Usa fotogramas con zoom, texto emergente, transiciones de B-roll o efectos de sonido (whoosh, ding, pop) para mantener la atención.
  5. El Pago / Clímax (90% - 95% del tiempo): Entrega el consejo definitivo o la revelación final prometida en el gancho.
  6. Transición Perfecta a la Llamada a la Acción (95% - final): Nunca señales el final con "en conclusión" o "eso es todo". Une el punto de valor final directamente a la recomendación del siguiente video o una llamada a la acción rápida antes de que el espectador se vaya.

Formato de Salida

[Título de Trabajo]

Duración Objetivo: [Duración] | Audiencia: [Audiencia Objetivo] | Tono: [Tono]


1. Optimización de Título y Miniatura

Opciones de Título

  1. El Vacío de Curiosidad: [ej., "La Verdadera Razón por la que tu Código es Lento (No es Python)"]
  2. Orientado a Resultados: [ej., "Cómo Optimicé mi App para Manejar 100k Usuarios en 1 Hora"]
  3. El Contrario: [ej., "Deja de Usar React para Proyectos Simples"]

Conceptos de Miniatura

  • Concepto 1: [Detalles visuales, ej., Primer plano del presentador con cara preocupada, pantalla dividida mostrando un enorme banner rojo de 'Error' en un lado y una marca de verificación verde limpia en el otro. Superposición de texto grande y en negrita de 3 palabras: "DEJA DE HACER ESTO."]
  • Concepto 2: [Detalles visuales, ej., Representación gráfica limpia de un gráfico de carga del servidor disparándose a la luna, contrastado con una línea verde plana. Superposición de texto: "100K USUARIOS."]

2. Variaciones de Gancho (Elige Una)

Variación 1: El Gancho Contrario

  • Visuales: [El presentador se inclina cerca de la cámara, mirando directamente al lente. Zoom rápido en la palabra 'Lento' apareciendo en letras rojas y negritas en pantalla.]
  • Audio: "Casi todos los desarrolladores con los que hablo culpan a Python por sus aplicaciones lentas. Pero el 90% de las veces, el lenguaje no es el problema. El cuello de botella está en realidad dentro de una sola línea de configuración que probablemente escribiste ayer."

Variación 2: El Gancho Narrativo

  • Visuales: [Muestra B-roll de un editor mostrando 500 registros de error parpadeando. Corte al presentador frotándose la frente con frustración.]
  • Audio: "El martes pasado a las 3 AM, nuestra base de datos colapsó por completo bajo la carga. Estábamos perdiendo $200 cada minuto que el sitio estaba caído. Después de buscar en los stack traces durante horas, encontramos una solución tan simple que no podía creer que la hubiéramos pasado por alto."

Variación 3: El Gancho de Interrupción de Patrón

  • Visuales: [Un cronómetro cuenta regresiva desde 5 segundos en el centro de la pantalla. Repentino efecto de sonido fuerte 'Ding' cuando el temporizador llega a cero.]
  • Audio (Voz en off): "En los próximos 5 minutos, te voy a mostrar el ajuste de rendimiento exacto que le ahorró a nuestro equipo $4,000 en costos mensuales de servidor. Y no, no necesitas reescribir ni una sola consulta de base de datos."

3. El Guión Principal

Tiempo / CapítuloSeñales de Video (B-roll, Superposiciones, Ángulos de Cámara)Señales de Audio (Guión Hablado, Efectos de Sonido, Música)
0:30 - 1:00El Re-ganchoMuestra gráficos en pantalla que exhiben los costos del servidor. Zoom suave hacia el presentador."Aquí está la realidad: la optimización de bases de datos suena increíblemente compleja. Pero la mayoría de los tutoriales te hacen aprender consultas SQL que nunca usarás. Hoy, lo mantendremos puramente práctico."
1:00 - 3:30Capítulo 1: [Nombre del Capítulo][Señal Visual: Transición a screencast. Resalta las líneas 12-15 en el archivo de configuración. Añade resaltado del cursor.]"[Diálogo Hablado]: Primero, abramos el archivo de configuración predeterminado. Observa este límite específico de tamaño del pool... [Efecto de Sonido: clic suave]"
3:30 - 6:00Capítulo 2: [Nombre del Capítulo][Señal Visual: Corte de vuelta al presentador. Zoom de entrada en la cara del presentador para enfatizar el punto.]"[Diálogo Hablado]: Esto nos lleva al siguiente paso. Si estableces este valor demasiado alto, tu servidor se congelará. Si es demasiado bajo, los usuarios esperarán para siempre. Aquí te muestro cómo encontrar el punto óptimo..."
6:00 - 8:30Capítulo 3: [Nombre del Capítulo][Señal Visual: B-roll del panel de monitoreo del servidor mostrando una línea plana que se convierte en una onda saludable.]"[Diálogo Hablado]: Una vez que aplicamos esta configuración, mira lo que sucedió con los tiempos de respuesta. Cayeron de 800 milisegundos a 45."
8:30 - 9:00El PagoMuestra pantalla dividida: Antes de la configuración vs Después de los tiempos de carga de la configuración."Así que, al cambiar esa única variable, resolvimos el problema del colapso por completo sin gastar un solo dólar en mejoras de hardware."
9:00 - 9:30Llamada a la Acción sin Transición[Señal Visual: Aparece una tarjeta en pantalla que apunta a un video relacionado. Superposición de texto: 'Ver siguiente: Escalando Bases de Datos PostgreSQL.']"[Diálogo Hablado]: Ahora que tu servidor está configurado correctamente, tu próximo cuello de botella será la indexación de la base de datos. Haz clic en este video de aquí donde explico la indexación en menos de 5 minutos..."

4. Metadatos Optimizados para Búsqueda

  • Descripción del Video: [Primeras 3 oraciones que contengan términos clave para el ranking de búsqueda. Ej., 'Aprende a optimizar el rendimiento del servidor y prevenir colapsos de base de datos. Este tutorial paso a paso te guía a través de ajustes de configuración del servidor para ahorrar costos de hosting.']
  • Etiquetas Sugeridas: optimización de servidor, configuración de base de datos, desarrollo web, costos de hosting, arquitectura de sistemas
  • Enlace de Llamada a la Acción: [Inserta enlace al boletín o página de producto]

Verificaciones de Calidad

  • Cada opción de título tiene menos de 60 caracteres para evitar truncamiento en dispositivos móviles.
  • No hay rellenos de introducción genéricos (ej., "Bienvenidos de nuevo a mi canal," "No olviden dar like y suscribirse") en los primeros 60 segundos de cualquier sección de gancho o guión.
  • La dirección visual (B-roll, superposiciones de texto, ajustes de zoom) se especifica al menos una vez cada 10 segundos en el guión principal.
  • El guión transiciona a la Llamada a la Acción inmediatamente después del pago sin declarar "en conclusión" o "gracias por ver".
  • Las líneas de audio habladas están escritas en lenguaje conversacional (oraciones cortas, pausas naturales, sin jerga académica excesiva).

Anti-patrones

  • No escribas párrafos de diálogo sin señales visuales que los acompañen. YouTube es un medio principalmente visual; cada párrafo de discurso necesita transiciones visuales.
  • No promociones patrocinadores, suscripciones al canal o enlaces externos durante el gancho (primeros 60 segundos).
  • No crees un solo gancho genérico; siempre proporciona 3 variaciones de gancho distintas (Contrario, Narrativo, Interrupción de Patrón) para darle flexibilidad al creador.
  • No uses un outro genérico que active la "rampa de salida del espectador" (ej., "Eso es todo por el video de hoy, espero que lo hayan disfrutado, ¡nos vemos la próxima vez!"). Sugiere otro video para mantener a los espectadores en la plataforma.

Frases de Ejemplo para Activar

  • "Escribe un guión de YouTube sobre mi sistema de productividad personal."
  • "Ayúdame a guionizar un video de 10 minutos explicando la inflación a estudiantes universitarios."
  • "Necesito un esquema y guión de YouTube para un tutorial sobre código limpio en Python."
  • "Redacta un guión de YouTube optimizado para retención sobre cómo construir un SaaS en 2026."

Individual skills in this repo

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

Skills relacionados