Communitygithub.com

ai-video-script

Redacta la narración y el storyboard para un video corto: guion hablado con revisión de tres pasos para eliminar el sabor a IA, lista de tomas, cuadrícula de ritmo y film.json como única fuente de verdad. Se ejecuta después de ai-video-brief, antes del renderizado.

¿Qué es ai-video-script?

Esta habilidad está diseñada para agentes de IA que crean contenido de video corto, como Claude Code, Cursor o Codex. Su propósito es generar el guion hablado y el storyboard de un video a partir de un resumen creativo previamente bloqueado (ai-video-brief). El flujo de trabajo es riguroso: primero escribe el guion como texto hablado natural, luego aplica una revisión de tres pasos para eliminar clichés de IA, verificar la originalidad (menos del 15% de palabras compartidas con la fuente, sin 8 caracteres consecutivos idénticos) y asegurar que suene a una persona real. Después construye el storyboard con reglas precisas de duración de tomas (1.5 a 5 segundos), animación (fases de preparar, estirar, impacto, aplastar, rebasar, asentar) y uso de ritmo musical (BPM) para sincronizar acciones con beats fuertes. Finalmente, genera cuatro archivos clave: script.md (guion y notas de revisión), storyboard.md (tabla de tomas), beat-grid.json (ritmo musical) y film.json (única fuente de verdad), que luego utilizan otras habilidades para el renderizado. Esta habilidad no genera código de renderizado; solo texto y temporización.

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

Preguntar en tu IA favorita

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

Documentación

ai-video-script: 口播与分镜

Cuándo usarlo

El resumen creativo está bloqueado y el usuario ha elegido un ángulo narrativo. Esta habilidad escribe el guion hablado, la lista de tomas, la cuadrícula de ritmo y film.json. No empieces a renderizar antes de que existan estos archivos.

1. Escribe el guion primero

  • Escribe la narración como texto hablado, no como prosa escrita. Lee cada línea en voz alta en tu mente: si una oración no se puede decir en un solo respiro, divídela.
  • Estima la duración a unos 4.5 caracteres chinos por segundo solo para planificar. La sincronización final siempre proviene de la duración real de la locución, nunca de la estimación.
  • Regla de duración de toma: cada toma dura el máximo del tiempo de acción, tiempo de lectura y estimación de narración, más una pausa. La duración total de la película es la suma de todos los fotogramas de la toma. Nunca estires el audio para que quepa en una toma.

2. Revisión de tres pasos para eliminar el sabor a IA

Ejecuta los tres pasos en el guion antes de pasar al storyboard. Mantén las notas de revisión en script.md.

  • Paso 1, eliminar clichés de IA: corta frases hechas, intensificadores vacíos y oraciones que no dicen nada con muchas palabras. Cada oración debe contener un hecho, imagen o acción concretos.
  • Paso 2, verificación de superposición: si el guion adapta un texto fuente, las palabras reales compartidas con la fuente deben ser como máximo del 15%, sin 8 caracteres consecutivos idénticos. Reescribe, no parafrasees alrededor de los bordes.
  • Paso 3, verificación de lectura en voz alta: el guion debe sonar como una persona hablando, no como un ensayo. Elimina construcciones solo escritas y oraciones que solo funcionan en papel.

3. Construye el storyboard

Usa templates/storyboard.md. Reglas:

  • Una toma dura de 1.5 a 5 segundos y muestra exactamente una cosa.
  • Un cambio visible cada 2 a 3 segundos: entrada, acción principal, acción secundaria, salida o transición.
  • Abre los primeros 3 segundos con una escena pequeña y concreta, no con una tarjeta de título. Un ejemplo concreto recorre toda la película.
  • Cada fila de toma tiene: número, rango de tiempo, imagen, acción, movimiento de cámara, texto en pantalla (máximo 8 caracteres), método.
  • Elige 2 palabras de acento fijas para toda la película, más 3 a 8 palabras de énfasis de subtítulos. Úsalas de manera consistente.
  • Alterna la toma A y la toma B al menos una vez cada 8 a 12 segundos.
  • Nombra el elemento principal, los elementos de apoyo y el fondo para cada toma. El principal se mueve primero y más; los elementos de apoyo lo siguen de 2 a 5 fotogramas después con un movimiento más pequeño.
  • Da a cada acción grande seis fases: preparar, estirar, impacto, aplastar, rebasar, asentar.
  • Mantén una dirección de luz principal para toda la película, con reflejos y sombras de contacto que sigan la acción.

4. Cuadrícula de ritmo

Música primero: elige la pista, establece su BPM, escribe templates/beat-grid.json con marcas de tiempo y marcas de beat fuerte/débil. Coloca acciones pesadas y cortes en beats fuertes. Mueve los efectos de sonido desde el movimiento mismo. Usa curvas de ease-in-out; sin movimiento lineal excepto movimiento mecánico deliberado.

5. film.json es la única fuente de verdad

Escribe templates/film.json: título, formato, fps, duración, estilo, voz y la lista de tomas con tiempos de inicio/fin, imagen, locución, texto en pantalla y método. Cada paso posterior (renderizado, locución, revisión) lee este archivo. Si el guion cambia, actualiza film.json primero, luego vuelve a derivar el resto.

Contrato de salida

  • script.md (narración + temporización + notas de revisión de tres pasos).
  • storyboard.md (tabla de tomas).
  • beat-grid.json (BPM + beats fuertes/débiles).
  • film.json (única fuente de verdad).

Reglas

  • No escribas código de renderizado en esta habilidad. Solo texto y temporización.
  • Una toma que no se puede describir en una fila de la tabla son dos tomas; divídela.
  • Los hechos inciertos se mantienen marcados como "por verificar" hasta que se comprueben; nunca los suavices con un lenguaje seguro.

Individual skills in this repo

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

Skills relacionados