CommunityRedacción y edicióngithub.com

guión-de-video

Escribe un guión de vídeo a partir de un brief en uno de tres modos: animación (motion graphics), acción real (grabable, consciente del presupuesto) o documental (ritmo narrativo, guía de entrevistas, lista de B-roll). Genera un archivo .xlsx con formato más una pestaña de PRÓXIMOS PASOS que incluye resumen, notas de tratamiento, prompts de imagen con IA, un primer análisis legal y notas de viabilidad.

¿Qué es guión-de-video?

Esta skill de agente de IA permite generar guiones de vídeo profesionales a partir de breves o ideas desestructuradas, en tres modos: animación (motion graphics), acción real (comerciales, guionizados) y documental (testimonios, entrevistas, historias de marca con personas reales). Es útil para creativos publicitarios, productoras y equipos de marketing que necesitan pasar rápidamente de un concepto a un guión listo para producción. La skill guía al agente en la elección del modo, la ingesta de parámetros clave (marca, tiempo, audiencia, perfil de marca), la estructuración del arco narrativo (gancho, problema, giro, prueba, producto, recompensa, cierre) y la escritura siguiendo reglas específicas para VO y VISUAL. Además, genera notas de tratamiento, prompts para storyboards con IA, un primer análisis legal y una pestaña de próximos pasos que incluye viabilidad (días, localizaciones), banderas legales y preguntas abiertas. Soporta las tres plataformas principales: Cursor, Codex y Claude Code, y se activa automáticamente cuando el usuario comparte un brief, deck, notas de producto o una idea vaga y solicita un guión, guión AV, vídeo explicativo, comercial, testimonio, documental o preguntas para entrevista, incluso si solo dice “escribe el guión de 30 segundos”. El agente sigue un proceso de revisión interno (borrador, revisión contra checklist, corrección) antes de presentar el resultado final, garantizando calidad profesional.

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

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

Guión de Vídeo

El guión es el producto. PRÓXIMOS PASOS es un extra que apunta al siguiente trabajo.

1. Elige primero el modo

Pregunta: ¿animación, acción real o documental? Si el brief lo deja claro, di cuál elegiste y por qué en una línea. Luego lee la guía correspondiente antes de escribir:

  • Animación o motion graphics: references/animation.md
  • Acción real, comercial, guionizado: references/live-action.md
  • Documental, testimonial, entrevistas, historia de marca con personas reales: references/documentary.md

Un híbrido (acción real con gráficos animados, un documental con apertura guionizada) utiliza la guía del modo principal y toma prestadas reglas del otro para esas escenas. Dilo.

2. Ingreso (un mensaje corto, solo lo que falta)

  • Nombre de la marca y el producto, exactamente como lo dice el cliente.
  • Duración (15, 30, 60, 90 s, o más larga).
  • Audiencia y la única cosa que deben hacer o sentir.
  • Perfil de marca. Acepta una guía de marca PDF, logotipos, capturas de pantalla, un sitio web o notas escritas. Extrae paleta, tipo, reglas del logotipo, tono, eslogan, palabras obligatorias y prohibidas. Resume en 5 a 8 líneas y confirma. Ofrece guardarlo como references/brands/<marca>.md a partir de _template.md. Nunca redibujes un logotipo.
  • Preguntas específicas del modo de la guía (días de rodaje y presupuesto para acción real; sujetos y B-roll para documental).
  • Notas legales que el cliente ya tenga. No esperes a ellas. El paso 5 realiza un primer análisis.

Trabaja con información parcial. Señala las carencias. Nunca las inventes.

3. Estructura

Construye el arco antes de escribir líneas: gancho, problema, giro, prueba, producto, recompensa, cierre. Los espacios cortos lo comprimen. Usa los nombres de secciones del brief como columna vertebral.

4. Escribe

Sigue la guía del modo. Reglas compartidas para todos los modos:

  • VO es el texto definitivo, escrito para ser hablado: oraciones completas y naturales que transmitan un pensamiento real y conecten una escena con la siguiente. Sin cadenas de fragmentos, sin eslóganes apilados. Un fragmento al cierre, si se lo gana.
  • VISUAL se escribe como dirección: de dos a tres oraciones completas sobre encuadre, movimiento, luz y transición, en lenguaje de producción o animación según el modo.
  • Aproximadamente 2 palabras de VO por segundo. La introducción y el cierre deben ser ligeros. Recorta primero las escenas más densas.
  • Nunca inventes estadísticas, citas, nombres o afirmaciones. Usa la fuente tal como está escrita.
  • TÍTULOS: de 2 a 6 palabras. Reflejan el ritmo, nunca repiten el VO palabra por palabra. Líneas legales marcadas como LEGAL:.
  • Sin rayas. Sin relleno. Sin frases de IA ("desbloquear", "sin fisuras", "en el mundo actual").

5. Primer análisis legal

Una lista de banderas, no un asesoramiento legal. Dilo una vez. Revisa cada escena para detectar:

  • Afirmaciones: números, superlativos ("mejor", "#1", "probado"). Cada uno necesita una fuente, fecha y alcance.
  • Comparaciones con competidores, nombrados o implícitos.
  • Testimonios y citas: aprobación por escrito, resultados típicos, divulgación pagada.
  • Categorías reguladas: salud, suplementos, finanzas, seguros, niños, alcohol, afirmaciones medioambientales.
  • Precios, ofertas, pruebas: términos en pantalla.
  • Marcas registradas, marcas de terceros e interfaces de usuario. Derechos: música, material de archivo, imagen, fuentes.
  • Autorizaciones para personas y lugares (acción real y documental).
  • Accesibilidad: superposiciones mantenidas el tiempo suficiente para leer, subtítulos planificados.

Cada bandera: escena, palabras exactas, el riesgo en una línea, una reescritura más segura. Nunca cambies el texto aprobado en silencio.

6. Próximos pasos (extra, mantenlo conciso)

  • Resumen: una oración.
  • Notas de tratamiento: un párrafo corto de 3 a 5 oraciones sobre aspecto, ritmo, música y tono del VO, transiciones.
  • Ancla de estilo + prompts de escena: una línea de estilo, luego un prompt de imagen con IA por escena, para storyboards. Sin texto en las imágenes excepto el marco del logotipo. Sin personas reales ni personajes con marca registrada.
  • Viabilidad (acción real): días, localizaciones, actores principales, banderas.
  • Banderas legales y preguntas abiertas.
  • Siguiente skill: acción real pasa a un deck de preproducción; documental pasa a un calendario de entrevistas y lista de tomas de B-roll.

7. Generar

python scripts/build_script.py frames.json outputs/<nombre>.xlsx \
    --title "<Marca> - <Proyecto>" --runtime "60-seconds" --type "Live Action" --notes notes.json

--type: Animation, Live Action o Documentary. Cada escena: frame, time, visual, audio, title, prompt. Para documental, audio contiene la FUENTE y la CITA DESTINO, title el tercio inferior o superposición. notes.json: summary, treatment, style_anchor, feasibility, legal_flags, open_questions (listas), más para documental interviews ([{"subject": "", "questions": [""]}]) y broll ([{"location": "", "shots": [""], "must": true}]). Ejemplos: references/frames_example.json, references/notes_example.json, references/documentary_example.json.

Nombre de archivo: código de proyecto si se proporciona, de lo contrario <Marca>_<Proyecto>_Script_v1.xlsx.

Guarda una copia del guión como un archivo JSON (title, runtime, type, frames, notes). El generador lo lee directamente, y la siguiente etapa (deck de preproducción) toma el título de ahí.

Revisión (siempre, antes de presentar)

Cada respuesta se ejecuta dos veces. El usuario nunca ve el primer borrador.

  1. Redacta la respuesta completa.
  2. Revisa como lo haría un director creativo y un productor exigentes, contra la lista de verificación siguiente y cada regla de esta skill. Lee el texto como si lo oyeras en una reunión con el cliente. Marca cada fallo.
  3. Corrige cada fallo, luego presenta solo la versión revisada.
  4. Termina con una línea: Revisión: <lo que cambió> o Revisión: no se necesitaron cambios.

Esto se aplica a cada paso que produzca algo: investigación, opciones, texto, especificaciones y archivos. Para un archivo, constrúyelo, ábrelo o genéralo, verifícalo, luego corrige y reconstruye antes de entregarlo.

Lista de verificación

  • Los códigos de tiempo se ejecutan sin espacios y terminan en la duración. El VO se ajusta al presupuesto. Advertencias del generador en cero.
  • El VO se lee de forma natural en voz alta como pensamientos completos que conectan una escena con la siguiente, no eslóganes apilados.
  • Cada VISUAL le dice al director, director de fotografía o animador qué hacer: encuadre, movimiento, luz, transición.
  • Sin estadísticas, citas, nombres o afirmaciones inventados. Análisis legal completo. Sin rayas, sin frases de IA.

8. Verifica, luego presenta

  • El generador verifica los códigos de tiempo (sin espacios, que terminen en la duración) e imprime el recuento de VO contra un presupuesto de 2 palabras por segundo. Corrige cada advertencia.
  • Sin números, nombres o citas inventados. Sin rayas. Análisis legal realizado.
  • Presenta el archivo. Luego de 2 a 4 líneas: modo, arco, recuento de escenas, palabras de VO, principales banderas.
  • No hagas nada adicional a menos que te lo pidan.

Individual skills in this repo

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

Skills relacionados