Communitygithub.com

storyboard-sheet

Convierte cualquier historia, guión o secuencia en viñetas individuales de cámara, genera imágenes de storyboard con estilo unificado cuadro por cuadro y las compone automáticamente en un panel de storyboard con números de viñeta y duración marcados.

¿Qué es storyboard-sheet?

Este skill de agente AI transforma descripciones narrativas textuales (historias, guiones, secuencias de video) en paneles de storyboard visuales y estructurados. Sigue un pipeline estricto de ocho pasos desde la tarjeta de contenido hasta la entrega final, garantizando consistencia a través de tres puertas de control de calidad: validación estática antes de generar imágenes, inspección individual de cada cuadro antes de componer el panel, y registro de trazabilidad antes de la entrega. La clave de la consistencia es una única fuente de verdad en el JSON de viñetas: las frases de anclaje (estilo, personajes, plano de planta, bloqueo, iluminación, accesorios, negativos) se escriben una vez en el bloque `anchors` y se copian textualmente en el prompt de cada cuadro, evitando variaciones entre viñetas. El skill soporta cuadrículas n×n con relación de aspecto 16:9 y paneles personalizados, y proporciona scripts de PowerShell incorporados para validación y composición. Está diseñado para usuarios que necesitan generar de manera confiable storyboards profesionales con calidad de producción a partir de contenido textual, ya sean historias originales, guiones de video AI o segmentos cinematográficos.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/freedonplus/storyboard-sheet/tree/HEAD

Preguntar en tu IA favorita

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

Documentación

Storyboard en Panel

La clave de la estabilidad no es la improvisación, sino fijar este flujo de trabajo: Tarjeta de contenido → Lista de viñetas → Validación estática → Generación cuadro por cuadro → Inspección cuadro por cuadro → Registro de trazabilidad → Composición con texto superpuesto → Revisión final y entrega del panel completo. Cada paso tiene especificaciones fijas; al cambiar la historia solo se cambia el contenido, no la estructura. Tres puertas controlan la calidad: sin validación no se genera imagen, sin inspección individual no se compone el panel, sin registro de frases originales no se entrega.

Flujo de ejecución

  1. Llenar la tarjeta de contenido. Consulta los campos en prompt-templates.md: título y género, anclajes de personajes, escenario, tarjeta de bloqueo, plano espacial y tabla de cámaras, tarjeta de estado, iluminación y textura, relación de aspecto y número de cuadros, lista de viñetas, elementos prohibidos. Si falta algo, el agente lo completa razonablemente según la historia, sin preguntar al usuario por preferencias de estilo.
  2. Dividir en viñetas. Dividir por eventos de contenido, no por número de palabras o estética visual; un cambio de acción principal por viñeta. Escribir en un JSON isomorfo a assets/shots.example.json, copiando estrictamente los campos y nombres. Todas las frases reutilizadas entre viñetas se concentran en el bloque anchors de nivel superior (fuente única de verdad): style/characters/blueprint/blocking/axis/lighting/props/negative. El prompt de cada viñeta se ensambla a partir de estas ocho frases originales; está prohibido escribir variantes por viñeta. La tabla de cámaras se escribe en cameras; cada viñeta debe tener camera/in_state/out_state.
  3. Validación estática (sin validación no se genera imagen). Ejecutar primero scripts/validate-shots.ps1: verificar campos obligatorios, capacidad de cuadros, continuidad de números de viñeta, intervalos de tiempo consecutivos, relevo palabra por palabra de in_state/out_state, que el prompt de cada viñeta incluya todas las frases de anchors textualmente, existencia de referencias de cámara, dirección de la cadena de imágenes de referencia. Si algo falla, corregir el JSON primero, no pasar a generar imágenes.
  4. Generar imágenes de storyboard cuadro por cuadro. En una sola llamada a image_gen se pueden enviar todas las viñetas de una misma escena (varias en request_list), cada una de 1536×864. El prompt de cada viñeta sigue la plantilla de prompt-templates.md: frase de textura global + frase de anclaje de personaje + frase de escenario + frase de anclaje de bloqueo + ancla de proporción + tarjeta de estado + estado de entrada + frase de acción de esta viñeta + estado de salida + frase de prohibición, todas las frases de anclaje copiadas textualmente viñeta por viñeta. Dentro de la misma escena, seguir la cadena de imágenes de referencia según el orden de la tabla de cámaras: la imagen terminada de la viñeta anterior se pasa como referencia a la siguiente, con la instrucción fija "solo referenciar la disposición espacial, proporciones de personajes, relación con el suelo y dirección de la luz; no copiar la composición"; al cambiar de escena, romper la cadena y empezar de nuevo la primera viñeta. Ver continuity.md.
  5. Inspección cuadro por cuadro (sin inspección individual no se compone el panel). En cuanto sale una viñeta, revisar inmediatamente las diez listas de verificación de prompt-templates.md: si la forma de la cara/vestimenta coincide con el anclaje, si la posición está en las coordenadas del plano, si izquierda/derecha sigue la regla del eje, si la proporción coincide con el ancla, si el estado de la luz/tarjeta de estado coincide con el significado real, si la temperatura de color de la luz es consistente, si el estado de entrada ha recibido el estado de salida de la viñeta anterior, si hay marcas de agua de texto. Si no pasa, regenerar en el mismo lugar: modificar el prompt sin reescribir las frases de anclaje, solo corregir el elemento que falla; si después de dos regeneraciones todavía hay desviación, pasar la primera imagen terminada como doble referencia, y si aún falla, reducir el plano (plano cercano es más estable que plano general).
  6. Registro de trazabilidad (sin registro no se entrega). Una vez finalizada cada viñeta, escribir cuatro elementos en el JSON de la lista de viñetas en el shot correspondiente: prompt (la oración completa enviada al modelo de generación, sin cambios), seed (si la herramienta lo devuelve), ref (cadena de IDs de imágenes de referencia usadas, ej. "SH003" o "SH001+SH003"), qa (conclusión de la inspección y notas). Este JSON es el único archivo de trazabilidad: cualquiera que lo tenga podrá reproducir cada viñeta e identificar la frase responsable de errores.
  7. Composición con texto superpuesto. Usar scripts/build-board.ps1 (parametrizado: spec JSON + directorio de frames + ruta de salida), siguiendo la fórmula de proporciones de output-spec.md para determinar el número de cuadros y el lienzo; el número de viñeta, duración y nombre se superponen en la parte inferior de cada cuadro sobre una barra semitransparente, sin hacer que el modelo de imagen dibuje ningún texto. Antes de componer, ejecutar de nuevo validate-shots.ps1 -PanelsDir <directorio de frames> -RequirePanels.
  8. Revisión final y entrega del panel completo. Una vez compuesto, revisar el panel completo: si las viñetas adyacentes encajan, si los personajes mantienen izquierda/derecha consistentes en todo el panel, si los elementos fijos del escenario (línea de parada, bordillo, marco de puerta, etc.) mantienen la misma forma en todo el panel, si la información de la tarjeta de título es correcta. Si se detectan problemas, volver al paso 5 y regenerar solo las viñetas problemáticas. Entregar la imagen del panel compuesto (PNG original + JPG para fácil visualización) y el JSON de la lista de viñetas; si el usuario lo solicita, entregar también los frames individuales.

Reglas estrictas

  • Tres puertas: validación estática de la lista de viñetas fallida → no generar imagen; inspección de una viñeta fallida → no componer panel; prompt/seed/ref/qa no registrado → no entregar.
  • Cuadrícula n×n + cada cuadro 16:9 = panel estrictamente 16:9. 3×3 usar 1280×720 para componer 3840×2160; 4 cuadros usar 2×2; 6 cuadros usar 3×2 (muy ancho) o 2×3 (vertical); 9 cuadros usar 3×3. Para paneles no cuadrados, relación de aspecto = (columnas×16):(filas×9).
  • anchors fuente única de verdad: personajes, posición, plano, posición de luz, tarjeta de estado, elementos prohibidos: cada uno tiene solo una frase original, alojada en el bloque anchors de nivel superior; el prompt de cada viñeta copia textualmente de aquí; está prohibido escribir "igual que arriba" o "mantener la misma apariencia", y está prohibido que cada viñeta reescriba frases sinonímicas. El cambio de cara de un mismo personaje entre viñetas es el fallo más común en los paneles.
  • La posición se basa en elementos fijos del escenario, copiada textualmente viñeta por viñeta: línea de parada, enésima línea blanca, bordillo, borde de la mesa, marco de la puerta, poste de la barandilla. Está prohibido usar "fondo/primer plano/izquierda del encuadre" para describir la posición del personaje — estas cambian con el plano y la cámara, siendo la principal causa de desviación de posición. Los desplazamientos solo se escriben como dirección y distancia relativas al ancla ("dar un paso adelante, cruzar la línea de parada").
  • Tres elementos de consistencia del escenario: plano (coordenadas espaciales) + tarjeta de estado (semántica de objetos variables) + forma de los elementos fijos del escenario (material/color/cantidad); todo el grupo copiado textualmente viñeta por viñeta; solo se permite cambiar al cambiar de escena, marcándolo en la lista de viñetas con scene_break: true y rompiendo la cadena de imágenes de referencia.
  • Frase de posición de luz unificada para todo el grupo, solo se modifica si narrativamente se cambia de período horario; al modificarlo, anotarlo en la lista de viñetas.
  • Una acción por viñeta: estado inicial → trayectoria/punto de contacto → resultado visible. Las acciones de múltiples pasos se dividen en viñetas adyacentes.
  • Las viñetas adyacentes deben encadenarse: el out_state de cada viñeta debe ser textualmente igual al in_state de la siguiente (posición/orientación/fase de acción/punto de contacto/intensidad de expresión), está prohibido "básicamente igual"; al cambiar de escena, romper la cadena declarándolo explícitamente con scene_break: true, no permitir rupturas silenciosas.
  • No cruzar el eje, moverse según la tabla de cámaras: todas las cámaras del grupo en el mismo lado, los personajes no intercambian izquierda/derecha en el encuadre; el ángulo entre cámaras adyacentes ≤ 90°, la diferencia de altura ≤ una altura de persona, el plano no salta dos niveles consecutivos.
  • Escribir el ancla de proporción en cada viñeta: dar un objeto de tamaño fijo del escenario (línea blanca 45 cm, bordillo 15 cm, ancho de mesa 60 cm), el tamaño del personaje se calcula con el ancla para evitar que varíe de tamaño.
  • La tarjeta de estado se copia textualmente viñeta por viñeta, el estado de la luz debe coincidir con el significado real: semáforo rojo para peatones = figura roja de pie, semáforo verde para peatones = figura verde caminando, semáforo para vehículos = disco de color sólido; especificar cuál está orientado hacia quién, y hacer que el flujo de tráfico y el derecho de paso sean consistentes. Prohibido dibujar figuras humanas dentro del disco, o combinar luz roja con número verde.
  • El punto de corte debe especificar qué se recibe: prohibido "transición natural" o "corte fluido".
  • Reemplazar palabras vacías por palabras concretas: elegancia, impacto, cinematográfico, atmósfera máxima, todo reemplazado por luz específica, material, velocidad, distancia, plano.
  • Los elementos prohibidos incluyen fijamente: no aparecer texto, subtítulos, marcas de agua, números, bordes; añadir según el tema (ej. no aparecer salpicaduras de sangre, no aparecer armas de fuego modernas, no estilizar como caricatura).
  • Si hay menos cuadros que filas×columnas y se habilita title_cell, la última celda es la tarjeta de título; de lo contrario, las celdas vacías se dejan con fondo oscuro, no se permiten viñetas irrelevantes para llenar el espacio.

Recursos

ArchivoResponsabilidad
references/prompt-templates.mdTarjeta de contenido, plantilla de prompt para viñeta individual, plantilla de prompt para panel de 9 cuadros, escritura de acción y movimiento de cámara, puerta de inspección de viñeta individual, lista de fallos
references/continuity.mdTarjeta de continuidad: plano espacial, regla del eje, tabla de cámaras, relevo de estado final e inicial, cadena de imágenes de referencia, ancla de proporción, registro de trazabilidad, lista de autoverificación
references/output-spec.mdFórmula de número de cuadros y proporciones, resolución, formato de texto superpuesto, especificación de campos JSON de lista de viñetas (incluyendo anchors y campos de trazabilidad)
assets/shots.example.jsonEjemplo completo de JSON de lista de viñetas (8 viñetas + tarjeta de título, con anchors/cameras/campos de trazabilidad)
assets/demo.jpgEjemplo de producto final: vista previa del panel completo compuesto a partir del JSON anterior (8 viñetas + tarjeta de título, 3×3, JPG de lado largo 2560)
scripts/validate-shots.ps1Validación estática de la lista de viñetas: campos, relevo, inclusión textual de frases de anclaje, referencia de cámara, existencia de archivos de frames
scripts/build-board.ps1Composición con texto superpuesto: leer JSON, generar PNG del panel completo y vista previa JPG

Ambos scripts dependen de PowerShell y System.Drawing integrados en Windows, no requieren instalar bibliotecas adicionales. Modo de ejecución:

# Antes de generar imágenes: validación estática (sin validación no se genera imagen)
& "<directorio-del-skill>\scripts\validate-shots.ps1" -SpecPath <shots.json>

# Antes de componer panel: validación incluyendo archivos de frames (falla inmediatamente si faltan frames)
& "<directorio-del-skill>\scripts\validate-shots.ps1" -SpecPath <shots.json> -PanelsDir <directorio de frames> -RequirePanels

# Composición con texto superpuesto
& "<directorio-del-skill>\scripts\build-board.ps1" -SpecPath <shots.json> -PanelsDir <directorio de frames> -OutputPath <panel.png> -PreviewPath <preview.jpg>

El script de composición recorta y rellena (cover) centrado en la celda, no estira la imagen; si el tamaño del frame no coincide con la proporción de la celda, no se deforma.

Ver el producto final de ejemplo en assets/demo.jpg: vista previa del panel completo de 8 viñetas + tarjeta de título, correspondiente a la lista de viñetas en assets/shots.example.json. Primero ejecutar validate-shots.ps1 para que pase la validación, luego reproducir con el mismo JSON para obtener un panel de la misma estructura.

Skills relacionados