Communitygithub.com

storyboard-director

Construye storyboards de producción donde cada tiempo registra texto, posición, imágenes, movimiento, sonido, sincronización y su vínculo con el guion.

¿Qué es storyboard-director?

Esta habilidad transforma un guion en storyboards de producción listos para animación, con especificaciones detalladas por cada tiempo (beat): texto (VO y en pantalla), imagen/activo, posición (coordenadas normalizadas 0..1), movimiento y cámara, sonido (VO, música, ambiente, SFX), transiciones y continuidad. Utiliza IDs estables (S01-B01), intervalos semiabiertos [startFrame, endFrame) a 60 FPS, y valida que el total de duraciones coincida con la composición. Soporta la creación de storyboards para plataformas como Claude Code, Cursor o Codex, asegurando que cada elemento esté listo para ser codificado por un motor de animación (por ejemplo, frame-time-engineering). Incluye una plantilla obligatoria, lista de verificación QA, y modos de fallo comunes para evitar ambigüedades que rompan la implementación. Es útil para equipos que producen videos cortos verticales (1080×1920) con control preciso sobre cada fotograma.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/achmdfzn/motionforge-atelier/tree/HEAD/.claude/skills/storyboard-director

Preguntar en tu IA favorita

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

Documentación

DIRECTOR DE STORYBOARD

Obligatorio

Un storyboard no es solo una lista de imágenes. Cada escena y tiempo debe declarar: texto/narración, imágenes, posición/diseño, movimiento, sonido y tiempo. Usa la plantilla docs/templates/STORYBOARD_TEMPLATE.md.

Flujo de trabajo

  1. Fija el brief, el formato vertical 1080×1920, 60 FPS, duración, audiencia, guía de estilo y mensaje principal.
  2. Divide el guion en frases/tiempos atómicos; asígnales IDs estables (S01-B01, etc.). No combines frases distintas sin una razón.
  3. Por cada tiempo, escribe el texto exacto de VO, el texto exacto en pantalla, lo que es visible, el sujeto/activo y la acción.
  4. Define posiciones con coordenadas normalizadas 0..1 (x, y, w, h), ancla, alineación, capa/z-order, área segura y dirección de lectura. Incluye tamaños/posiciones en píxeles cuando sea necesario.
  5. Define encuadre, cámara, transiciones, movimiento de entrada/salida, duración, fotograma de inicio/fin y solapamiento.
  6. Graba el audio: clip de VO, música, ambiente, SFX, fotograma de inicio, duración, ganancia relativa, fundido y pausas/silencio.
  7. Empareja cada frase de VO con una o más imágenes/tomas que aclaren su significado. Evita imágenes literales repetitivas; usa metáfora cuando funcione mejor.
  8. Valida continuidad, legibilidad en móvil, área segura, sincronización y que la duración total coincida.

Salida obligatoria por tiempo

  • ID, escena, fotograma inicio/fin, duración en fotogramas y segundos.
  • ID de frase de VO + texto.
  • Texto en pantalla + posición.
  • Visual/activo + composición y posición.
  • Movimiento/cámara + easing.
  • Indicación de audio: tipo, archivo/placeholder, inicio/fin, nivel relativo, fundido.
  • Transición de entrada/salida y notas de continuidad.

Reglas

  • Todo el texto visible debe escribirse textualmente, no "agregar un título".
  • Todas las posiciones deben ser explícitas, no "aproximadamente en el medio".
  • Todo el sonido debe registrarse, incluyendo la decisión de no tener sonido/silencio.
  • No inventes activos que aún no existan; márcalos como PLACEHOLDER y enumera los requisitos del activo.
  • Duración del tiempo a 60 FPS: durationInFrames = endFrame - startFrame con límite final exclusivo.
  • Un logotipo de cierre + CTA es obligatorio y debe ser específico del video, no genérico.

Convenciones de ID y tiempo

  • ID del tiempo: S<escena>-B<tiempo> con dos dígitos (S01-B01). Los IDs no cambian cuando un tiempo se mueve; un tiempo insertado obtiene un nuevo ID (S02-B03) en lugar de renumerar todo.
  • Intervalo semiabierto [startFrame, endFrame): el fotograma endFrame ya pertenece al siguiente tiempo.
  • Convierte de segundos solo una vez, en un solo lugar: frame = round(seconds × fps). Después, cada número en el storyboard es un fotograma entero.
  • Los tiempos consecutivos deben ser contiguos: el endFrame del tiempo N = el startFrame del tiempo N+1. El solapamiento solo está permitido para ventanas de transición registradas en la columna Transición.
  • Total: el endFrame del último tiempo = durationInFrames de la composición.

Formato de salida

  • Encabezado: ID del proyecto, lienzo, FPS, duración (segundos + fotogramas), rutas a la guía de estilo y al plan de audio.
  • Tabla de tiempos siguiendo docs/templates/STORYBOARD_TEMPLATE.md.
  • Notas por tiempo para tiempos complejos (movimiento multi-etapa, personajes, 3D).
  • Mapa frase-a-toma cuando hay VO, o una sola línea "no aplica — sin VO".
  • Hoja de indicaciones de audio, incluyendo silencio intencional.
  • Especificación de la tarjeta de cierre personalizada.
  • Lista de activos PLACEHOLDER con requisitos y estado de licencia.

Lista de verificación QA

  • Cada tiempo tiene un ID, fotograma inicio/fin, texto textual (o "—"), visual, posición normalizada, movimiento, sonido y transición.
  • Los tiempos son contiguos desde el fotograma 0; la suma de duraciones = durationInFrames.
  • El texto importante está dentro del área segura y se lee en una pantalla de teléfono (tamaño, contraste, tiempo en pantalla).
  • El texto permanece en pantalla el tiempo suficiente para ser leído; las frases largas se dividen o se les da más tiempo.
  • Cada frase de VO tiene una toma emparejada; cada toma tiene un propósito editorial.
  • El silencio se escribe explícitamente, no se deja en blanco.
  • El movimiento se describe en función del fotograma (desde/hasta, rango de fotogramas, easing), listo para ser traducido por frame-time-engineering.
  • La tarjeta de cierre continúa el motivo del video y su CTA es textual.
  • Cada activo que aún no existe está marcado como PLACEHOLDER.

Mini ejemplo

Un tiempo de gancho de texto de 2 segundos:

ID de tiempoFotogramasVOTexto en pantallaVisualPosiciónMovimientoSonidoTransición
S01-B010–120—¿Por qué tu video se siente genérico?Fondo oscuro lisox .08, y .40, w .84; alineado a la izquierda; z 2Cada palabra entra cada 10 fotogramas, deslizamiento hacia arriba 24 px, duración 14 fotogramas, ease-outSilencio 0–30, SFX-001 whoosh en 30corte

Movimiento listo para codificar: la palabra i comienza en el fotograma i × 10; opacity 0→1 y translateY 24→0 durante [i×10, i×10+14].

Modos de fallo

  • "El texto aparece en el medio" → no se puede codificar; escribe x/y/w/h, ancla y alineación.
  • Tiempos fuera por un fotograma (0–119 luego 120–240) → no se usó la convención exclusiva; cambia todo a semiabierto.
  • El texto cambió en el código pero no en el storyboard → el storyboard es la fuente de verdad para el texto; actualiza el storyboard primero.
  • La duración total no coincide con la composición → recalcula desde la tabla; no lo parchees en el código.
  • Imágenes demasiado literales por frase → usa una demostración, diagrama o metáfora; registra el motivo.
  • La tarjeta de cierre es un logotipo + "Síguenos" → no es personalizada; construye un puente visual desde el motivo del video.

Individual skills in this repo

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

Skills relacionados