Communitygithub.com

storyboard-interactivo

Convierte un storyboard terminado en una **historia visual interactiva**: una página web donde el espectador avanza la historia haciendo clic, manteniendo presionado y arrastrando sobre los propios dibujos, con sonido, subtítulos/diálogos y transiciones que respetan el ritmo de la película. Está pensado para personas que ya saben qué es un storyboard (tableros, planos, slugs, notas); no es un generador de animáticas.

¿Qué es storyboard-interactivo?

Esta habilidad transforma un storyboard terminado (en PDF o imágenes) en una historia visual interactiva en una sola página HTML. Utiliza gestos guiados (clic, mantener presionado, arrastrar) para que el espectador interactúe con los dibujos originales, añadiendo sonido (grabado o sintetizado), texto multilingüe y transiciones que respetan el ritmo de la película. Está diseñada para personas que ya conocen el formato de storyboard (tableros, planos, slugs, notas) y quieren crear una experiencia inmersiva sin generar animáticas. Soporta múltiples idiomas, efectos visuales como granulado o trama de puntos, y cortes de sonido anticipados. La habilidad se implementa en una sola página con un lienzo (canvas) y un sistema de máquina de estados por escena, optimizando el rendimiento mediante precarga de imágenes y audio. Ejemplos del autor incluyen 'La alegría de la habitación blanca' y 'Fahrenheit 451' (escenas 1, 8, 9), disponibles en los ejemplos y en vivo. El enfoque principal es preservar los dibujos originales del usuario, añadiendo solo los efectos y la interactividad necesarios, y siempre preguntando antes de realizar cambios significativos.

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

Preguntar en tu IA favorita

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

Documentación

Storyboard interactivo

Convierte un storyboard terminado en una historia visual interactiva: una página web donde el espectador avanza la historia haciendo clic, manteniendo presionado y arrastrando sobre los propios dibujos, con sonido, subtítulos/diálogos y transiciones que respetan el ritmo de la película. Está pensado para personas que ya saben qué es un storyboard (tableros, planos, slugs, notas); no es un generador de animáticas.

Ejemplos del autor de esta habilidad, Ding Yilin: La alegría de la habitación blanca y Fahrenheit 451 (escenas 1, 8, 9) — ver examples/; jugar en vivo: La alegría de la habitación blanca, Fahrenheit 451, escenas 1 → 8 → 9.

0. Preguntar antes de construir (una ronda, luego adelante)

Pregunta solo qué cambia la construcción; toma valores predeterminados sensatos para el resto y di cuáles.

  1. Qué escenas / tableros (un storyboard largo: primero prueba una escena, luego haz las demás de la misma manera).
  2. Apariencia: uno de los ajustes predefinidos a continuación, o "dejar mis dibujos como están".
  3. Texto: solo diálogo / narración / ambos / ninguno. Usa las líneas originales del storyboard; nunca inventes diálogos ni narración.
  4. Sonido: grabaciones del usuario (pide los archivos y a qué tablero pertenece cada uno) o sonido sintetizado.
  5. Idiomas: pregunta siempre qué idiomas necesita la pieza; no hay un conjunto predeterminado. Construye solo esos. Cada cadena en pantalla (títulos, slugs, pistas, globos, créditos) vive en una tabla por idioma y se puede cambiar en vivo; con más de un idioma, el inicial puede seguir a una página anfitriona (?lang=, un postMessage, o <html lang>). Las traducciones que hagas son borradores que el usuario debe revisar.
  6. Dónde vivirá: solo una página compartible, o también incrustada en el sitio web del usuario (entonces pregunta por el paquete del sitio y edita su copia).
  7. Línea de crédito: usa exactamente las palabras que el usuario dé (ej. "Hecho por …"); no añadas roles que no haya listado.

1. Leer el storyboard

  • Storyboarder / exportaciones PDF: pdfimages -png da cada tablero a tamaño completo incluyendo el área de NOTAS; encuentra el marco del dibujo una vez (escanea filas/columnas en busca de las líneas del marco) y recorta todos los tableros de la misma manera al área de dibujo (mantén una ventana 16:9 si el escenario es 16:9). Renderiza las páginas con pdftoppm -r 150 y lee las notas, slugs (EXT./INT. … – DÍA/NOCHE), duraciones y diálogos; pdftotext -layout obtiene los slugs.
  • Haz una hoja de contactos y una vista cuadriculada (líneas cada 0.1 del ancho/alto) de cada tablero: cada coordenada posterior (dónde está una figura, dónde tocar, dónde está una pantalla) se mide sobre estas, en fracciones de imagen, nunca adivinadas.
  • Escribe una lista de tiempos: tablero → qué sucede → el gesto que haría que el espectador hiciera esa acción → sonido → texto.

2. Planos antes que efectos

  • Encuentra las tomas largas. Tableros consecutivos con el mismo escenario y sujetos en movimiento (A→B→C de personas caminando) son una sola toma continua: construye un fondo limpio (parchea al sujeto usando los otros tableros), recorta al sujeto y muévelo, con la cámara siguiéndolo. No disuelvas tableros enteros allí.
  • Plano cerrado → plano general de los mismos sujetos (o al revés) es un solo movimiento: encuadra el tablero general ampliado para que sus sujetos tengan el mismo tamaño y posición que en el plano cerrado (calcula el zoom y el centro a partir de las posiciones medidas de cabeza/pies), termina la disolución en ese encuadre coincidente, luego retrocede. Verifica el encuadre coincidente en una captura de pantalla; las fantasmas significan que los números están mal.
  • Los tableros que deben leerse como un solo movimiento comparten una paleta (procesarlos con el mismo color preestablecido).
  • Cuando el usuario dice que un tablero muestra la parte trasera de un TV, una puerta vista desde atrás, etc., no dibujes nada que el tablero no muestre: la luz y el sonido pueden sugerir lo que está fuera de pantalla.

3. Ajustes predefinidos de apariencia

Todos los ajustes mantienen el dibujo a línea del usuario; nunca lo redibujan.

  • Película / riso (el aspecto de la Habitación Blanca): etalonaje por escena (color brillante y saturado sobre penumbra), textura de papel suave, grano suave; ocasional — no constante — bamboleo de fotograma, parpadeo y arañazos tenues; una sombra de registro. Los efectos son raros y silenciosos: el parpadeo o la vibración constantes cansan.
  • Cómic americano: suavizado bilateral; una capa de tinta a partir de un umbral oscuro más sombrero negro para que los trazos finos a lápiz queden entintados; un color plano de punto en las áreas dibujadas, puntos Ben-Day a 45° en los tonos medios y una pantalla clara sobre todo el panel, más densa en los bordes; la placa de color desplazada 1–2 px de la placa de tinta; salida ~1.5×. Un color plano por ubicación/tiempo (día cálido, noche azul, CCTV verde, alarma roja…). Rotulación: cuadros de título amarillos para slugs, palabras de SFX de cómic en la imagen, globos de diálogo para el diálogo.
  • Píxel: reducir a una cuadrícula pequeña con una paleta limitada y tramado ordenado, ampliar con vecino más cercano; texto en una fuente de píxeles.

El cromo de la página sigue el ajuste (sala de proyección, página de periódico, pantalla de juego). Las fuentes web se cargan con una carrera de respaldo de 2–3 s para que la historia nunca espere por ellas.

4. Construcción: una página HTML, un lienzo

  • Un escenario 16:9, un lienzo, un área de subtítulos/pistas debajo, un selector de idioma (si hay más de un idioma) y un conmutador de sonido.
  • Máquina de estados de escena: cada escena es un objeto con enter / render(t) / tap / drag / down / up / hover / key; go(scene) cambia; st() es el tiempo en la escena. Un ayudante de cámara (setCam(img, zoom, cx, cy), toScreen, toImg) para que cada área de interacción y efecto se coloque en fracciones de imagen y siga la cámara.
  • Cada escena tiene una salida: una tecla de teclado y una alternativa automática lenta (10–20 s) para que nadie se quede atascado, además de un enlace "saltar" en las largas.
  • Envuelve cada llamada de sonido para que un contexto de audio faltante o una decodificación fallida nunca rompan la historia.
  • Carga imágenes con <img> (funciona también en file://); audio mediante fetch + decodeAudioData, con retroceso a elementos <audio> cuando fetch está bloqueado.

5. Diseño de interacción

  • El gesto es la acción de la historia. Correr = clics rápidos; contener la respiración = no tocar; asomarse para mirar = mantener; escalar = arrastres repetidos hacia arriba; entregar algo = llevarlo; pasar una página = arrastrar a través del libro; apagarlo = mantener en la mano sobre el botón. Prefiere estos sobre genéricos "clic para continuar"; mantén los toques simples para el diálogo y para tiempos que son puro ritmo.
  • Lleva el dibujo del usuario, nunca un accesorio inventado. Recorta la figura/objeto a lo largo de su contorno (polígono trazado sobre el zoom cuadriculado, borde suave), añade un borde blanco fino como un recorte de papel, levántalo con una sombra pequeña e inclínalo mientras se arrastra, deja el papel desnudo donde estaba, encaja si se suelta mal. Verifica el recorte contra el tablero: no incluyas escaleras, muebles ni la mano de otro personaje por error.
  • Los efectos añadidos sobre un tablero (una pantalla encendiéndose, ondas de radio, un visor) deben seguir la geometría del dibujo — recorta un resplandor de pantalla al cuadrilátero en perspectiva de la pantalla, no a un rectángulo — y deben señalarse al usuario como adiciones.
  • Las pistas dicen dónde y cómo: "Mantén presionado el pez y garabatea hacia adelante y atrás", no "interactúa". Más grande que el texto del cuerpo, debajo de la imagen.
  • Guías sobre la imagen, silenciosas por defecto (piensa en What Remains of Edith Finch): una pequeña señal en el punto de toque que ya dice la acción — un pulso para toque, un anillo que se llena para mantener, cheurones fluyendo en la dirección de arrastre, un arco giratorio para rodear (en estilo cómic: marcas de tinta "mira aquí"). Una mano demuestra el gesto dos veces cuando comienza el paso, luego retrocede; regresa solo después de ~3 s de duda. Oculta todo mientras el dedo está presionado. Nunca cubras la imagen con caminos punteados largos.

6. Transiciones

  • Coincide con el tono: suave por defecto (disoluciones donde el nuevo panel se asienta desde ligeramente más grande, tinta de entrada/salida, un resplandor suave para un TV encendiéndose o un fuego atrapando). Mantén un corte duro (fotograma negativo, líneas de velocidad, vibración) para el único impacto de la escena. Todos los cortes duros = rígido.
  • Un empuje continuo hacia el siguiente espacio es un solo movimiento largo: lo que sea que esté entre medio (una pared) toma su color y textura del panel de destino y se funde en él; sin canalones en medio de un movimiento.
  • Nunca muestres los bordes negros de una imagen rotada o ampliada: sujeta la cámara.

7. Sonido

  • Sonido grabado: recorta a la acción (una puerta abriéndose sincronizada con la manija dibujada), nivela todo, ambientes en bucle con fundidos.
  • Sonido sintetizado (WebAudio, sin archivos): pasos, papel, puertas, perros mecánicos, alarmas, latidos, murmullo de TV… Aleatoriza cada golpe (tiempo, tono, envolvente) y da forma a las envolventes de manera desigual para que nada suene repetido por máquina; evita clics y pitidos secos en escenas silenciosas.
  • Usa puentes de sonido para dar significado (una lavadora que lentamente se convierte en el mar del sueño; un sonido que continúa sobre el título). Pregunta antes de añadir sonidos que el storyboard no implique.

8. Texto

  • Diálogo: globos de discurso (cómic) o subtítulos (película), cola apuntando a la cabeza del hablante, mantenidos dentro del panel, ajustados midiendo, nunca comenzando una línea con signo de puntuación de cierre. Rellena el cuerpo y la cola de cada globo por separado para que ningún trazo cruce el texto.
  • Slugs como cuadros de título en la esquina; mantenlos fuera del dibujo importante (salta el título en un tablero donde cubriría al sujeto).
  • Las citas que añadas (ej. lo que recitan los personajes) deben ser de dominio público y señaladas al usuario.

9. Rendimiento

  • Limita el lienzo a ~1600 px de ancho (DPR = max(1, min(devicePixelRatio, 2, 1600 / cssWidth))).
  • Pre-renderiza superposiciones estáticas (textura de papel, viñeta) una vez por tamaño y colócalas en cada fotograma; nunca reconstruyas degradados o patrones por fotograma.
  • Para disoluciones, mantén el fotograma anterior a la mitad del tamaño, no una copia completa cada fotograma.
  • Carga perezosamente la historia en la página anfitriona (póster + botón "Entrar en la historia"); cada página de escena carga solo sus propias imágenes.

10. Prueba como espectador

  • Una ejecución de navegador sin cabeza (ej. Playwright) con gestos reales de ratón (clics, mantener, arrastres medidos desde toScreen) a través de toda la historia, en cada idioma, fallando en cualquier error de página. Expón un __go(scene, state) solo para pruebas para saltar a un tiempo.
  • Capturas de pantalla de cada fotograma clave y de la mitad de cada transición/coincidencia; míralas.
  • Verifica la sintaxis del script después de ediciones (node --check). No pongas comentarios // en medio de una declaración de una línea (silenciosamente comenta el resto de la línea y la página se queda en blanco).
  • Mide la velocidad de fotogramas antes/después de cambios pesados. Di claramente que el sonido y la sensación se verificaron mediante medición y capturas de pantalla, no jugándolo.

11. Entrega

  • Una página alojada compartible para revisión; para el sitio web del usuario, un zip de su paquete del sitio con la historia en su propia carpeta (ej. story/<project>/), un bloque de incrustación de carga perezosa, y nada más cambiado. Si el usuario ha adaptado la historia dentro de su sitio, siempre edita esa copia (fusión a tres bandas de tus cambios sobre ella), nunca la sobrescribas con la original.
  • Varias escenas: una página por escena compartiendo una carpeta de recursos, encadenadas (final de escena → siguiente escena, idioma mantenido; la última regresa a la primera). La portada de cada escena necesita un clic para desbloquear el audio después de la navegación.
  • Nunca despliegues nada en nombre del usuario; entrega el zip.
  • Un archivo abierto por sí solo se verá negro: la página necesita su carpeta de recursos a/ junto a él. Dilo al entregar los archivos.

Skills relacionados