Communitygithub.com

prepro-deck-builder

Construye un deck completo de preproducción (.pptx) a partir de uno o más guiones. El formato interno está integrado, no se necesita plantilla ni deck de referencia.

¿Qué es prepro-deck-builder?

Esta habilidad permite construir automáticamente un deck de preproducción profesional en formato PowerPoint (.pptx) a partir de uno o varios guiones en texto, PDF u hoja de cálculo. Está diseñada para directores, productores y equipos creativos que necesitan pasar rápidamente del guion a un documento completo de producción, con secciones como visión general, enfoque creativo, cinematografía, diseño de producción, vestuario y storyboards. Soporta múltiples plataformas (Claude Code, Cursor, etc.) y se integra mediante scripts Python que generan el JSON de especificaciones y la presentación final. Incluye un proceso de revisión en dos pasos para garantizar calidad y coherencia, y permite añadir imágenes ya sea subidas por el usuario o generadas mediante prompts de IA. La habilidad respeta estrictamente el formato de la marca del cliente y verifica automáticamente posibles problemas legales en los guiones.

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

Preguntar en tu IA favorita

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

Documentación

Constructor de Deck de Preproducción

Guion entra. Deck de preproducción terminado sale. El formato es fijo. La redacción es el oficio.

1. Recepción

Pregunta una sola vez, solo por lo que falta:

  • Guion o guiones. Ignora pestañas de borrador o prueba. Pregunta si una pestaña no está clara.
  • Nombre de la marca, exactamente como lo escribe el cliente.
  • Entregables con cantidades (ejemplo: 30s Hero Video (x3), 15s Cutdown (x3)). Nunca inventes cantidades.
  • Días de rodaje y localizaciones, si se conocen. Qué guiones comparten un día.
  • Lista de productos con SKU o ID de producto, si el guion nombra productos.
  • Look. El valor por defecto es la propia marca del cliente (ver más abajo). Si aún no hay nada disponible, ofrece:
    • sky: divisores degradados azul cielo, Avenir. Un marcador de posición neutro hasta que se definan los colores de la marca.
    • ink: divisores negros y carboncillo, Helvetica. Editorial, premium, tecnología.
    • sage: divisores verde suave, Georgia. Tranquilo, natural, bienestar y hogar.
    • custom: el cliente sube un manual de marca, logotipo, capturas de pantalla o un sitio web. Extrae dos colores de divisor, color de texto y fuente. Muestra las selecciones como códigos hex y confirma antes de construir. Si una fuente de la marca no está instalada en la máquina del visor, nombra una fuente del sistema cercana y dila. Si no eligen y no hay marca disponible, usa sky.

La marca primero. El azul cielo es solo el sustituto. Antes de construir, busca los colores del cliente: un manual de marca, logotipo o capturas de pantalla que el usuario comparta, o el sitio web de la marca. Extrae dos colores de divisor, el color de texto y la fuente, muéstralos como códigos hex y confirma. Usa azul cielo solo cuando aún no haya marca de la que extraer, y di en la entrega que es un marcador de posición para intercambiar por los colores de la marca. Escribe el azul cielo en la especificación como "theme": {"base": "gold", "a": "56B4E9", "b": "1F7DC4"}. Nunca uses la paleta amarillo dorado.

2. Estructura del deck

Portada                nombre de la marca, en el color de la marca
Resumen                qué es la campaña, a quién habla, luego Entregables
Enfoque Creativo       el insight, cómo cada spot tira de un hilo, dónde aterriza cada spot
Cinematografía         compartida, solo si un enfoque de cámara cubre todos los spots
-- por guion --
Divisor                nombre del spot; subtítulo opcional (línea temática o "Día 1")
Cinematografía         para este spot, a menos que sea compartida
Localización           marcador de posición para selecciones de localización
Diseño de Producción   para este spot
Casting                marcador de posición para selecciones de casting
Vestuario              para este spot
Storyboards            3 fotogramas por diapositiva
--
Agradecimientos

Las escenas se numeran por guion: guion 1 = 101, 102... guion 2 = 201... Nunca rompas el orden de los guiones. Los guiones que comparten un día de rodaje pueden compartir una sección de Cinematografía, Diseño de Producción y Vestuario. Dilo en el divisor ("Guiones 1 y 3 / Día 1").

3. Redacción de cada diapositiva

Voz: un director escribiendo para el equipo. Párrafos cortos y meditados de dos a cuatro oraciones completas en el lenguaje de la producción: lentes, cobertura, luz, bloqueo, textura, ambientación, ritmo. Cada párrafo le dice al equipo algo que puedan filmar, construir o comprar, y por qué es importante para la historia. Las oraciones se conectan y construyen. Nunca apiles fragmentos ni escribas líneas que parezcan eslóganes. Sin relleno, sin guiones largos, sin "elevar", "sin costuras", "inmersivo".

Resumen (80 a 120 palabras antes de Entregables). Un párrafo corto sobre qué es la campaña y el mundo en el que vive, un segundo sobre a quién habla y qué debería moverlo a hacer. Luego el bloque de Entregables, una línea por formato.

Enfoque Creativo (100 a 150 palabras). Abre con el insight como un pensamiento completo, no un eslogan. Luego una o dos oraciones por spot sobre el hilo que tira y cómo se desarrolla en pantalla. Cierra en dónde aterriza cada spot (cartón final, URL, tagline).

Cinematografía (3 párrafos cortos, de 40 a 55 palabras cada uno). Cómo se mueve la cámara y por qué. Tamaños de plano y cuándo usar gran angular. Qué deben mostrar los insertos y cuán legibles son. Luz. Une movimiento a emoción: cuando se mueve, cuando se mantiene.

Diseño de Producción. Forma fija:

  • Línea de encabezado: NOMBRE DEL SPOT · TAGLINE CORTO en mayúsculas.
  • Dos oraciones de ambiente: cómo debería sentirse el espacio, y por qué.
  • Los Sets: cada set en una o dos oraciones. Detalles vividos (zapatos junto a la puerta, dibujos en la nevera).
  • Paleta: 3 o 4 colores, más dónde aparece el color de la marca en lugares pequeños y reales.
  • Accesorios Esenciales: agrupados, de 2 a 4 líneas. Producto héroe primero, con combinación de colores y SKU. Las listas largas van en las notas, no en la diapositiva.

Vestuario. Forma fija:

  • Dos oraciones de ambiente para la localización o el spot.
  • Una línea por personaje: Nombre (Sexo, Edad): lo que usa, y un detalle que cuenta la historia. Los niños reciben edades exactas. Los adultos reciben un rango (Finales de los 30, Mediados de los 20).
  • Línea Paleta:.
  • Sin logotipos a menos que sean del cliente.

Storyboards. Cada fotograma tiene:

  • VISUAL: titular de escena cuando cambia (INT. COCINA - DÍA). Nombres de personajes en mayúsculas en la primera aparición con edad. Luego 2 o 3 oraciones completas de dirección: la acción, el encuadre y cualquier movimiento de cámara. Usa INSERTAR: para primeros planos de pantalla y producto, CORTE A: para cortes duros, NOTA: para algo imprescindible. Nombra el producto con su SKU.
  • VOZ EN OFF | TEXTO: líneas VO: textuales del guion. TEXTO: para texto en pantalla. EFECTOS DE SONIDO: y MÚSICA: cuando el guion lo requiera. ALT: para una línea de respaldo.
  • El último fotograma es el cartón final. Agrega tomas de la familia de productos o combinaciones de colores como escenas adicionales después.
  • Conserva la VO del guion y los nombres de marca exactamente. Señala contradicciones. Nunca las corrijas en silencio.

4. Ajuste

Las cajas no se encogen automáticamente. Corta palabras, nunca el tamaño de fuente.

  • Diseño de Producción: encabezado, ambiente, 2 bloques cortos, 2 a 4 líneas de accesorios.
  • Vestuario: ambiente, 1 línea por personaje, paleta.
  • Cinematografía: 3 párrafos, de aproximadamente 40 a 55 palabras cada uno.
  • Visual de storyboard: aproximadamente 45 a 55 palabras. VO y texto: aproximadamente 25.

5. Banderas legales

Antes de construir, revisa el guion en busca de estadísticas, superlativos, precios, ofertas, afirmaciones de salud o dinero, testimonios y marcas de terceros. Mantén la línea tal como está escrita, agrega una versión más segura en ALT:, y lista cada bandera en la entrega. Los descargos requeridos van en TEXTO: con un asterisco. Esta es una primera revisión, no un consejo legal.

6. Construcción

Escribe un JSON de especificación, luego ejecuta:

python scripts/build_deck.py spec.json outputs/<Marca>_PrePro_v1.pptx

Forma de la especificación:

{
  "brand": "Nombre de la Marca",
  "theme": {"base": "gold", "a": "56B4E9", "b": "1F7DC4"},
  "cover_sub": "opcional",
  "overview": ["línea", "", "Entregables:", "30s Hero Video (x1)"],
  "creative_approach": ["línea", "", "línea"],
  "shared_cinematography": ["opcional; omitir para escribir por spot"],
  "scripts": [{
    "title": "Nombre del Spot", "subtitle": "opcional", "base": 101,
    "cinematography": ["línea"],
    "production_design": ["SPOT  ·  TAGLINE", "ambiente", "", "Los Sets", "línea", "", "Paleta", "línea", "", "Accesorios Esenciales", "línea"],
    "wardrobe": ["ambiente", "", "Nombre (Sexo, Edad): línea", "", "Paleta: línea"],
    "location_placeholder": true, "casting_placeholder": true,
    "frames": [{"vis": "INT. HABITACIÓN - DÍA\nAcción.", "vo": "VO: línea", "title": "TEXTO EN PANTALLA"}]
  }]
}

theme son los colores de la marca como un dict, azul cielo como arriba cuando aún no hay marca, o la palabra ink o sage. Establece los colores de degradado del divisor (a, b), texto del cuerpo (ink), etiquetas (grey), marcadores de posición (ph), color del título del divisor (title) y font. Cualquier clave omitida vuelve al estilo base.

Un ejemplo completo está en references/example_spec.json.

"" es una línea en blanco. Los encabezados de sección (Entregables:, Los Sets, Paleta, Accesorios Esenciales) y las líneas de encabezado en mayúsculas se ponen en negrita automáticamente. En Vestuario, el texto antes de los dos puntos se pone en negrita.

7. Imágenes (último paso, solo después de que el deck esté aprobado)

No menciones las imágenes hasta que el usuario apruebe el deck. Luego ofrece dos caminos en una línea:

A. Sus propias imágenes. El usuario sube fotogramas de storyboard, fotos de localización, retratos o fotos de producto. Nombra o asigna cada una a una clave, colócalas en una carpeta y reconstruye: python scripts/build_deck.py spec.json out.pptx --images <carpeta>. Las imágenes se recortan para llenar cada espacio. Los espacios vacíos permanecen como marcadores de posición.

B. Paquete de prompts de IA. Ejecuta python scripts/make_prompts.py spec.json <Marca>_Image_Prompts.md. Escribe primero image_style en la especificación: una línea sobre look, luz, paleta y aspecto, tomada del texto de Cinematografía y Diseño de Producción. Entrega el archivo. El usuario pega los prompts en cualquier herramienta de imágenes, guarda cada imagen con la clave como su nombre, las sube y reconstruyes con --images.

Claves de imagen:

  • Fotograma de storyboard: el número de escena (101, 102, 201).
  • Diapositivas de contenido: <clave-guion>-design-1, -design-2, -wardrobe-1, -wardrobe-2, -cine-1, -cine-2.
  • Localización y casting: -location-1 a -3, -casting-1 a -3.
  • La clave del guion por defecto es s1, s2... según el orden del guion. Establece "key" en un guion para anularla.

Nunca generes imágenes de personas reales con nombre o personajes con marca registrada. Los espacios de casting son para las propias fotos de talento del usuario.

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ían un director creativo exigente y un productor, según la lista de verificación a continuación y cada regla de esta habilidad. Lee el texto como si lo escucharas 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: sin cambios necesarios.

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

Lista de verificación

  • El deck usa los colores de la marca del cliente, o azul cielo nombrado como marcador de posición en la entrega. Nunca amarillo.
  • Cada guion tiene su sección completa. Números de escena en orden. VO y nombres de marca coinciden exactamente con el guion.
  • El texto se lee como párrafos meditados en el lenguaje de producción. Sin fragmentos de eslóganes.
  • Renderiza el deck y mira cada diapositiva. Nada se sale de una caja. Sin texto de marcador de posición.
  • Banderas legales listadas. Sin nombres que el usuario no haya dado. Sin guiones largos.

8. Verifica, luego entrega

  • Cada guion tiene su sección completa. Números de escena en orden. Nada se sale de una diapositiva (renderiza con soffice y pdftoppm si están disponibles).
  • Sin texto de marcador de posición, sin nombres que el usuario no haya dado, sin guiones largos.
  • Entrega en 3 líneas: número de diapositivas, guiones y diapositivas de storyboard, luego banderas legales y preguntas abiertas.
  • Las imágenes, el casting y las selecciones de localización se agregan a mano. Dilo.
  • Nunca agregues nombres de equipo, talento o contacto sin preguntar.

Individual skills in this repo

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

Skills relacionados