Communitygithub.com

Redactor de Guiones de Video

Úsalo cuando el usuario quiera escribir un guion de video para una demo de producto, tutorial de funcionalidades, video de lanzamiento o video para redes sociales sobre una funcionalidad o cambio en el producto.

¿Qué es Redactor de Guiones de Video?

Esta habilidad de agente de IA, 'Redactor de Guiones de Video', guía a un asistente de IA (como Claude Code, Cursor, etc.) a través de un proceso completo de seis fases para producir guiones de video profesionales y listos para producción. Acepta múltiples fuentes de entrada, como briefs de marketing, publicaciones de blog, changelogs, solicitudes de extracción (PR) y referencias de Git, y las convierte en guiones estructurados para videos de formato corto (redes sociales) o mediano (YouTube, demos). El proceso incluye descubrimiento, configuración (longitud, tipo de guion, tono, llamado a la acción), generación de esquemas, redacción con pautas detalladas de ritmo y formato, revisión y finalmente salida a archivo. La habilidad está diseñada para seguir meticulosamente cada fase, haciendo preguntas de sondeo y esperando confirmación antes de continuar, al tiempo que permite una colaboración eficiente a través de respuestas agrupadas o selección de valores predeterminados. Se ejecuta en cualquier plataforma que admita habilidades de agente de IA definidas en Markdown (como Claude Code, Cursor, Codex) y está disponible bajo la licencia Apache 2.0.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/AlemTuzlak/skills/tree/HEAD/skills/video-script

Preguntar en tu IA favorita

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

Documentación

¿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:

  1. Ruta a un brief de marketing existente (.md que contenga "Resumen Ejecutivo" o "Mensajes Clave") -> brief de marketing
  2. Ruta a una publicación de blog existente (.md con estructura de blog) -> publicación de blog
  3. Ruta a un changelog existente -> changelog
  4. Ruta a un boletín existente -> boletín
  5. Coincide con URL de GitHub o patrón #\d+ -> PR
  6. Contiene ... o .. -> rango de referencias de git
  7. Se resuelve a un archivo/directorio existente -> funcionalidad del código base
  8. 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 entradaQué leer
Brief de marketingExtrae 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 blogExtrae título, puntos clave, audiencia, CTA. Salta al Paso 3.
ChangelogExtrae entradas clave, céntrate en los cambios más impactantes. Salta al Paso 3.
BoletínExtrae asunto, actualizaciones clave, CTA. Salta al Paso 3.
PRDiff, 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 gitgit diff y git log entre referencias. Prioriza cambios visibles para el usuario.
Funcionalidad del código baseLee los archivos/directorios especificados.
Texto libreAnaliza 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:

  • gh no 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 videoPalabras objetivoPPM
30 segundos~65 palabras130
60 segundos~135 palabras135
90 segundos~200 palabras135
3 minutos~400 palabras135
5 minutos~675 palabras135

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 archivo
  • CÁ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

  • gh no 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-post o /social-copy)

Individual skills in this repo

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

AlemTuzlak/skills

Use when the user wants to write a blog post about a feature, product change, PR, git diff, or any technical topic - accepts marketing briefs, PRs, git refs, codebase paths, or freeform descriptions as input

AlemTuzlak/skills

Use when the user wants to generate a changelog, release notes, or document what changed between versions, tags, or PRs

AlemTuzlak/skills

Use when writing, editing, or organizing documentation, when planning what docs a feature needs, and whenever planning or implementing a new feature or change in a repo (docs ship with the code). Also use when tempted to write docs without showing the discovered readers to the user, without asking for tone, or without loading simple-english and i-have-adhd. Triggers on "write docs for X", "document this feature", "add a guide", "update the docs", "reorganize the docs", "plan feature X", "implement X", or /docs.

AlemTuzlak/skills

Use when a bug is in play: a test fails, CI is red, an API returns the wrong result, a stack trace appears, or the user says it is broken or fix this. Don't use for a new feature with no failure, for types-only work, or for docs.

AlemTuzlak/skills

Use when the user invokes /i-have-adhd, says they have ADHD, or asks for ADHD-friendly output. Also used as a required writing filter by the docs skill. Don't use for marketing copy or after the user says "stop adhd mode" or "normal mode".

AlemTuzlak/skills

Use when a settled change must be turned into an ordered stack of small blocks before anyone implements. Don't use for unsettled intent, typos, comments, formatting, docs-only work, or writing the implementation itself.

AlemTuzlak/skills

Use when the user wants to write a product update email, feature announcement newsletter, or digest email for users or subscribers

AlemTuzlak/skills

Use when the user wants to turn a raw talking-head / screen-share recording into a finished, edited, annotated video plus a full content package. Removes silences, flags mistakes for the user to cut, transcribes, adds transcript-synced overlays (code, on-screen code highlights, word highlights, lists, comparisons, diagrams, section labels, punch-in zooms), renders with original audio, then generates blog/socials/YouTube content. Triggers on "produce a video", "edit my video", "annotate my recording", "/produce-video".

AlemTuzlak/skills

Use when the user runs /prove-it or says prove it, prove the changes, show me in the browser, or asks to prove a UI or API change. Don't use only because the agent is about to say done, for types-only work, or for docs with no behavior to prove.

AlemTuzlak/skills

Use when the user wants to write, draft, or author an RFC (Request for Comments) / technical design doc for a feature, change, or architectural decision. Interactively interviews the user, grounds the proposal in the actual codebase, presents 2-3 concrete API/code-snippet approaches to choose from, then writes a review-ready RFC. Triggers on "write an RFC", "draft an RFC", "RFC for X", "design doc for X", or /rfc.

AlemTuzlak/skills

Use when the user wants to deeply learn a new topic from scratch. Runs a pre-interview (current knowledge, end-goal proficiency, depth, practice load, background, scope), researches online (articles, niche-influencer blogs, canonical docs, subtopic landscape), then produces a structured markdown course with mandatory visual diagrams, evidence-based learning-science features (retrieval practice, spaced callbacks, worked-example fading, concept ledger, jargon gate, analogy hygiene), and a self-contained interactive HTML mini-course. Triggers on /teach-me, "teach me about X", "I want to learn X", "deep dive on X", "create a course on X", "study X with me".

AlemTuzlak/skills

Use when the change intent is already settled and the agent must map what a behavior change touches before an implementation plan or any code. Use for new features, bug fixes, and refactors that move a boundary. Don't use for typos, comments, formatting, lockfile-only diffs, docs with no code, or while the user is still deciding what they want.

AlemTuzlak/skills

Use when the user wants to transcribe a video or audio file to text with word-level timestamps — spins up a self-contained local Whisper (whisper.cpp) Docker service bundled in this skill and returns transcript.txt, transcript.srt, and word-level transcript.words.json. Also used as a building block by /produce-video. Triggers on "transcribe this video", "get a transcript", "transcribe-video".

AlemTuzlak/skills

Use when the user wants YouTube metadata for a video — a click-worthy title, an SEO/above-the-fold description, tags, and timestamped chapters. Accepts a transcript (ideally timestamped SRT), a topic, a PR, or a freeform description. Used standalone and by /produce-video. Triggers on "youtube title", "youtube description", "youtube chapters", "youtube tags", "youtube metadata", "youtube-copy".

Skills relacionados