¿Qué hace Redactor de Guiones de Video?
Escribe guiones de video para demos de producto, tutoriales de funcionalidades y videos de lanzamiento. Gestiona el ritmo, las indicaciones visuales, la temporización y las duraciones adecuadas para cada plataforma.
Resolución de Entrada
Resuelve el argumento (si se proporciona) en este orden:
- Ruta a un brief de marketing existente (
.mdque contenga "Resumen Ejecutivo" o "Mensajes Clave") -> brief de marketing - Ruta a una publicación de blog existente (
.mdcon estructura de blog) -> publicación de blog - Ruta a un changelog existente -> changelog
- Ruta a un boletín existente -> boletín
- Coincide con URL de GitHub o patrón
#\d+-> PR - Contiene
...o..-> rango de referencias de git - Se resuelve a un archivo/directorio existente -> funcionalidad del código base
- De lo contrario -> texto libre
Si no se proporciona ningún argumento, pregunta: "¿Sobre qué debería tratar el video? Puedes proporcionar un brief de marketing, publicación de blog, changelog, URL/número de PR, rango de referencias de git, ruta de archivo/directorio, o simplemente describir la funcionalidad."
Si múltiples interpretaciones coinciden, confirma con el usuario.
Flujo del Proceso
digraph video_script {
rankdir=TB;
"Resolve input" [shape=box];
"Phase 1: Discovery" [shape=box];
"Phase 2: Configure" [shape=box];
"Phase 3: Outline" [shape=box];
"Outline approved?" [shape=diamond];
"Phase 4: Write" [shape=box];
"Phase 5: Review" [shape=box];
"Approved?" [shape=diamond];
"Phase 6: Output" [shape=box];
"Resolve input" -> "Phase 1: Discovery";
"Phase 1: Discovery" -> "Phase 2: Configure";
"Phase 2: Configure" -> "Phase 3: Outline";
"Phase 3: Outline" -> "Outline approved?";
"Outline approved?" -> "Phase 3: Outline" [label="no, revise"];
"Outline approved?" -> "Phase 4: Write" [label="yes"];
"Phase 4: Write" -> "Phase 5: Review";
"Phase 5: Review" -> "Approved?";
"Approved?" -> "Phase 4: Write" [label="revisions"];
"Approved?" -> "Phase 6: Output" [label="yes"];
}
NO omitas fases. Haz preguntas a un ritmo natural. Si el usuario responde varias a la vez, acepta las respuestas agrupadas y salta adelante.
Si el usuario dice "elige los valores predeterminados" o similar, elige valores predeterminados razonables, indica lo que has elegido y pide una sola confirmación.
Fase 1: Descubrimiento
Paso 1 - Analiza la entrada
| Tipo de entrada | Qué leer |
|---|---|
| Brief de marketing | Extrae declaración del problema, propuesta de valor, audiencia, mensajes clave. Salta al Paso 3. Aún así haz el Paso 2 si el brief carece de contexto del producto. |
| Publicación de blog | Extrae título, puntos clave, audiencia, CTA. Salta al Paso 3. |
| Changelog | Extrae entradas clave, céntrate en los cambios más impactantes. Salta al Paso 3. |
| Boletín | Extrae asunto, actualizaciones clave, CTA. Salta al Paso 3. |
| PR | Diff, descripción del PR, comentarios de revisión, mensajes de commit. Para PRs grandes (20+ archivos), céntrate en cambios visibles para el usuario. |
| Referencias de git | git diff y git log entre referencias. Prioriza cambios visibles para el usuario. |
| Funcionalidad del código base | Lee los archivos/directorios especificados. |
| Texto libre | Analiza la descripción del usuario. Si carece de detalles, pide al usuario que proporcione más información o que señale un archivo/PR específico. |
Cambios visibles para el usuario incluyen: nuevas funcionalidades, cambios en la interfaz de usuario, cambios en la API, mejoras de rendimiento, correcciones de errores y actualizaciones de documentación. Cambios internos incluyen: refactorizaciones, adiciones de pruebas, cambios en CI y actualizaciones de dependencias.
Manejo de errores:
ghno disponible -> informa al usuario, ofrece entrada alternativa- PR/ref inválido -> pide al usuario que verifique
- Archivo no encontrado -> pide la ruta correcta
Paso 2 - Lee el contexto más amplio del producto
Lee si existen: README, docs/, package.json (o equivalente).
Si no se encuentra nada, pregunta: "¿Puedes describir brevemente el producto y para quién es?"
Paso 3 - Presenta el entendimiento
"Esto es lo que usaré como base para el guion del video:"
- Funcionalidad A - descripción breve
- Funcionalidad B - descripción breve
"¿Algo que añadir, eliminar o corregir?"
NO continúes hasta que el usuario confirme el alcance.
Paso 4 - Verificación de contenido sensible
Antes de continuar, busca contenido potencialmente sensible: parches de seguridad, precios internos, credenciales, elementos de hoja de ruta no publicados o contenido marcado como confidencial. Señala cualquier cosa cuestionable al usuario.
Fase 2: Configuración
Haz estas preguntas:
P1 - Duración del video:
- Formato corto (30-90 segundos) - redes sociales (Reels, Shorts, TikTok)
- Formato mediano (3-5 minutos) - YouTube, demos de producto, tutoriales
P2 - Tipo de guion:
- Voz en off - texto de narración leído sobre grabaciones de pantalla/material de archivo
- Dos columnas - columna izquierda: indicaciones visuales/acciones en pantalla, columna derecha: narración
- Talking-head - orador en cámara, entrega conversacional
P3 - Tono: Lee el contenido existente del repositorio para detectar la voz. Confirma:
"Basado en tu contenido existente, el tono parece [ej. conversacional y amigable para desarrolladores]. ¿Debo mantener ese tono o ir en una dirección diferente?"
Si no hay contenido para analizar, pregunta directamente.
P4 - CTA: Infiere del contexto:
- Código abierto -> "Da una estrella al repo", "Pruébalo"
- SaaS -> "Regístrate gratis", "Inicia tu prueba"
- Actualización de funcionalidad -> "Pruébalo ahora", "Revisa la documentación"
"Sugiero que el CTA sea: [CTA inferido]. ¿Quieres usarlo o algo diferente?"
Fase 3: Esquema
Genera un esquema estructurado con temporización. Usa la plantilla adecuada según la duración del video:
Formato corto (30-90 segundos) - 3-4 secciones:
## [Título provisional] - [duración total]
1. **Gancho** (0:00-0:05) - [enfoque]
- Punto clave
- Visual: [qué mostrar]
2. **Problema** (0:05-0:15) - [punto de dolor a establecer]
- Visual: [qué mostrar]
3. **Solución** (0:15-0:45) - [tutorial de la funcionalidad]
- Punto clave A
- Visual: [qué mostrar]
- Punto clave B
- Visual: [qué mostrar]
4. **CTA** (0:45-0:60) - [acción a realizar]
- Visual: [pantalla final]
Total estimado: ~X palabras (~Y segundos a 135 PPM)
Formato mediano (3-5 minutos) - 5-8 secciones:
## [Título provisional] - [duración total]
1. **Gancho** (0:00-0:10) - [enfoque]
- Visual: [qué mostrar]
2. **Problema** (0:10-0:30) - [punto de dolor, contexto, por qué importa]
- Visual: [qué mostrar]
3. **Visión general de la solución** (0:30-1:00) - [a alto nivel, lo que construiste]
- Visual: [qué mostrar]
4. **Inmersión profunda: [Funcionalidad A]** (1:00-2:00) - [tutorial]
- Puntos clave
- Visual: [pasos de grabación de pantalla]
5. **Inmersión profunda: [Funcionalidad B]** (2:00-3:00) - [tutorial]
- Puntos clave
- Visual: [pasos de grabación de pantalla]
6. **Inmersión profunda: [Funcionalidad C]** (3:00-3:45) - [tutorial]
- Puntos clave
- Visual: [pasos de grabación de pantalla]
7. **Resumen** (3:45-4:30) - [resumir beneficios clave]
- Visual: [diapositiva de resumen o comparación lado a lado]
8. **CTA** (4:30-5:00) - [acción a realizar]
- Visual: [pantalla final]
Total estimado: ~X palabras (~Y segundos a 135 PPM)
Escala el número de segmentos de inmersión profunda para que coincida con las funcionalidades que se están cubriendo.
Presenta el esquema y espera la aprobación antes de escribir.
Fase 4: Redacción
Referencia de ritmo
| Duración del video | Palabras objetivo | PPM |
|---|---|---|
| 30 segundos | ~65 palabras | 130 |
| 60 segundos | ~135 palabras | 135 |
| 90 segundos | ~200 palabras | 135 |
| 3 minutos | ~400 palabras | 135 |
| 5 minutos | ~675 palabras | 135 |
Apunta a 130-145 PPM para una entrega conversacional. Marca cualquier sección que exceda su tiempo asignado.
Formato del guion por tipo
Guion de voz en off:
## [Título]
### Gancho (0:00-0:05) - ~15 palabras
VISUAL: [Descripción de lo que está en pantalla]
[Texto de narración aquí.]
### Nombre de la sección (0:05-0:20) - ~30 palabras
VISUAL: [Descripción de lo que está en pantalla]
[Texto de narración aquí.]
Guion de dos columnas:
| Tiempo | Visual | Narración |
|---|---|---|
| 0:00-0:05 | [Pantalla: página de inicio carga] | [Texto de narración] |
| 0:05-0:15 | [Pantalla: clic en menú de configuración] | [Texto de narración] |
| 0:15-0:30 | [Pantalla: activar modo oscuro] | [Texto de narración] |
Guion de orador frente a cámara:
## [Título]
### Gancho (0:00-0:05) - ~15 palabras
CÁMARA: [Orador en cámara, plano medio]
[Texto del orador aquí. Conversacional, directo a cámara.]
### Nombre de la sección (0:05-0:20) - ~30 palabras
CÁMARA: [Corte a grabación de pantalla]
VOZ EN OFF: [Narración sobre grabación de pantalla]
CÁMARA: [Vuelta al orador]
[Texto del orador aquí.]
Gancho
Los primeros 3-5 segundos determinan si los espectadores siguen viendo. El gancho debe:
- Abordar un punto de dolor o hacer una pregunta provocativa
- NO empezar con el nombre de tu empresa/producto
- NO empezar con "En este video, te mostraré..."
- Crear curiosidad inmediata o resonancia emocional
Indicaciones visuales
Incluye siempre indicaciones visuales en línea, independientemente del tipo de guion:
VISUAL:/PANTALLA:para grabaciones de pantalla y material de archivoCÁMARA:para direcciones de cámara del orador- Sé específico: "PANTALLA: Haz clic en el botón de exportar, muestra la descarga del PDF" no "PANTALLA: Muestra la funcionalidad"
- Incluye notas de transición entre escenas
Temporización por sección
Incluye duración estimada y recuento de palabras para cada sección:
### Nombre de la sección (0:15-0:30) - ~30 palabras- Marca si alguna sección excede su presupuesto de tiempo
- El recuento total de palabras del guion debe coincidir con la duración objetivo a 135 PPM
Reglas de redacción
- Conversacional, que no suene a guion. Escribe como la gente habla realmente.
- Frases cortas. Máximo 10-15 palabras por frase.
- Una idea por frase.
- Voz activa siempre.
- Nunca uses guiones largos (em-dash) en el contenido generado. Sin caracteres "---". Usa comas, dos puntos, puntos o paréntesis en su lugar.
- Muestra, no digas. "Mira lo rápido que carga esto" > "Carga muy rápido"
- Para videos de formato mediano, usa la regla de tres: tres beneficios, tres funcionalidades, tres ejemplos. Para formato corto, céntrate en un solo beneficio clave.
CTA
- Últimos 5-10 segundos del video
- Una sola acción clara
- Incluye indicación visual para la pantalla final (botón de suscripción, superposición de enlace, código QR)
Fase 5: Revisión
Presenta el guion completo con el desglose de temporización:
"Aquí está el guion:"
[Guion completo]
Desglose de temporización:
- Gancho: 5s (~15 palabras)
- Problema: 10s (~25 palabras)
- Solución: 30s (~70 palabras)
- CTA: 10s (~20 palabras)
- Total: 55s (~130 palabras a 135 PPM)
"¿Quieres algún cambio?"
Espera la aprobación. Solo procede a la salida una vez que el usuario confirme.
Fase 6: Salida
Siempre imprime el guion final aprobado en la terminal.
Luego pregunta: "¿Quieres que guarde esto en scripts/<slug>.md? ¿O en una ruta diferente?"
Crea el directorio si no existe. Si el archivo ya existe, pregunta si sobrescribir o crear una copia versionada.
Manejo de Errores
ghno disponible -> informa al usuario, ofrece entrada alternativa- PR/ref inválido -> pide al usuario que verifique
- Sin contexto del producto -> pide al usuario que describa el producto
- El guion excede la duración objetivo -> señala y sugiere cortes antes de la revisión
Lo que esta habilidad NO hace
- Grabar o editar video
- Generar miniaturas o activos visuales
- Crear animaciones o gráficos en movimiento
- Escribir publicaciones de blog o copy para redes sociales (usa
/blog-posto/social-copy)