Storyboard para Series Cortas Verticales
Convierte guiones episódicos finalizados y validados automáticamente en storyboards de dos niveles (segmento → plano) listos para filmación y conciliación, manteniendo simultáneamente entradas mínimas de activos visuales y una tabla de continuidad entre episodios.
Cuándo Usar / No Usar
- Usar esta skill: Para desglosar
drama/{serie}/episodes/ep{NNN}.mden un storyboard; crear entradas mínimas de activos o variantes para personajes, locaciones y utilería que aparecen en este episodio; mantener el estado de continuidad entre episodios; y sincronizar storyboards existentes después de revisiones finalizadas del guion. - Escribir o modificar guiones episódicos (incluyendo diálogos, completar líneas de mapeo, finalizar): Delegar a
fiction-short-drama. Esta skill nunca modifica el texto del guion o los diálogos; si el guion no está finalizado, faltan líneas de mapeo, hay bloqueos en la verificación automática o hay acciones imposibles de filmar, se devuelve al paso anterior. Sifiction-short-dramano está instalado, listar el estado no finalizado, las líneas de mapeo faltantes o los errores específicos con números de línea, y pedir al autor que edite manualmente antes de continuar. - Completar la apariencia completa de los activos y palabras clave, escribir ranuras para imágenes de referencia, escribir prompts de imagen/video, confirmar antes de generación paga: Delegar a
fiction-visual-prompts. Esta skill nunca escribepalabras clave, no escribe prompts o parámetros de modelo dentro del storyboard, y no llama a ninguna API de generación. - Determinar la fase del proyecto: Delegar a
fiction-workflow; si no está instalado, preguntar directamente al autor por la serie y el número de episodio objetivo.
Si falta la skill descendente fiction-visual-prompts, entregar el storyboard, la biblioteca de activos y la tabla de continuidad que han pasado la verificación, anotando claramente "prompt-check no ejecutado (esta skill no lo ejecuta)", y proporcionar una lista de tareas manuales para el paso siguiente: completar la apariencia completa de los activos y las palabras clave, escribir ranuras para imágenes de referencia y prompts de imagen/video por episodio en drama/{serie}/prompts/, y después de verificar por número de segmento y plano, que el autor decida si generar.
Antes de Empezar
Primero, leer en la raíz del libro AGENTS.md (especialmente "Convenciones de este libro"), .fiction/config.json, bible/sources.md (registro de puntos de entrada de escritura principal, ver SB §5). Luego, leer en el orden mínimo requerido por la tarea (SB §4.1):
- Crear storyboard: El guion del episodio
drama/{serie}/episodes/ep{NNN}.md→ salida destoryboard-check.mjs --brief→drama/{serie}/visual/assets.md→drama/{serie}/visual/continuity.md; según sea necesario, leer el último segmento del storyboard del episodio anterior y las entradas debible/characters.mdpara los personajes que aparecen; para series originales (series.mdtieneFuente: Original), leer también## Cuenta de Suspenseendrama/{serie}/series.md. - Crear/modificar activos visuales:
drama/{serie}/series.md→bible/characters.md(personajes principales y los que aparecen en este episodio) →drama/{serie}/visual/assets.md→ locaciones y utilería que aparecen en el guion ya escrito; cuando haya presagios, objetos o estándares de época, leer según sea necesariobible/inventory.md,bible/foreshadows.md,bible/timeline.md,bible/world-rules.md.
Antes de escribir o modificar cualquier archivo legible por máquina, abrir la sección de formato correspondiente en la tabla de referencia al final del documento, escribir según el texto original, no de memoria.
La cadena visual de la serie corta se resuelve según la prioridad ascendente (SB §3): características estables de characters.md > visual/assets.md > storyboard > prompts; guion > storyboard > prompts. Si se encuentra un error en un paso superior, corregirlo primero en ese paso, no crear una nueva descripción en el storyboard.
Si falta el esqueleto del proyecto, sugerir usar primero fiction-init; si fiction-init no está instalado, pedir al autor que complete manualmente AGENTS.md (con ## Convenciones de este libro), .fiction/config.json, bible/sources.md, bible/characters.md y los archivos necesarios en drama/{serie}/ según SB §2, SB §5 y SB §8. Si solo falta .fiction/config.json, los scripts se ejecutarán con valores predeterminados según el contrato (SB §8), e informar al autor.
Convenciones de ruta: las rutas que comienzan con bible/, drama/{serie}/ son relativas a la raíz del libro; en el texto, las abreviaturas visual/..., storyboards/..., episodes/... son relativas a drama/{serie}/. Todos los scripts se ejecutan desde la raíz del libro; las rutas con espacios deben ir entre comillas.
Proceso de Siete Pasos
1. Verificación Previa al Trabajo: Confirmar Finalización y Mapeo, luego Ejecutar Verificación del Guion y Resumen
Antes de comenzar el desglose (incluyendo la sincronización después de revisiones posteriores del guion), verificar tres barreras de entrada una por una:
- Guion finalizado: Abrir
drama/{serie}/episodes/ep{NNN}.md(SB §9.3), confirmar que el metadato sea- Estado: finalizado(finalizado por el autor). - Líneas de mapeo completas: Abrir
drama/{serie}/adaptation-map.md(SB §9.2), confirmar que exista una línea para el episodio objetivo y que las columnas de personajes y presagios estén completas para este episodio (aunque la falta de líneas solo genera una sugerenciamap-missing, hará que el resumen omita los personajes mapeados y sus secretos en este episodio). - Verificación automática del guion totalmente verde: Ejecutar (ver
drama-check.mjs --helppara uso):
node <directorio de esta skill>/scripts/drama-check.mjs <serie> --ep <N>
Debe tener código de salida 0, y cero block tanto a nivel de serie como en el episodio objetivo (código de salida 2 es un error de parámetros, configuración o lectura, no cuenta como aprobación); al mismo tiempo, verificar que fiction-short-drama haya reportado que el último lint --series para esta serie tuvo código de salida 0. Si alguna condición no se cumple, detenerse y devolver a fiction-short-drama; si falta el informe de lint, pedirle que lo ejecute y lo reporte (si no está instalado, enumerar las lagunas y los números de línea de error para que el autor los corrija manualmente). Si existen sugerencias como unshootable, dialogue-run, continuar si se pueden resolver dentro del storyboard; si realmente no se pueden filmar, pedir al autor que primero modifique el guion.
Una vez que se superan las barreras de entrada, ejecutar el resumen del storyboard (ver storyboard-check.mjs --help para uso):
node <directorio de esta skill>/scripts/storyboard-check.mjs <serie> --ep <N> --brief
Leer todas las cinco secciones una por una: ## Fuente, ## Verdades que no se deben dibujar en este episodio (provenientes de cualquier línea de adaptation-map.md o cualquier Presagio a revelar de un activo que no se haya recogido antes), ## Secretos de personajes (provenientes de la columna Personajes del mapeo de este episodio y de los Personajes principales de series.md que tengan Verdad del autor), ## Activos aún no disponibles, ## Estado de continuidad. Si series.md tiene Fuente: Original, el resumen no escaneará los suspenses originales, hay que leer manualmente ## Cuenta de Suspense de drama/{serie}/series.md e incluirlo en la lista anti-spoiler.
2. Crear Activos Visuales Mínimos y Registrar Cambios Netos de Continuidad
Según SB §9.4 y SB §6.1, actualizar drama/{serie}/visual/assets.md (para la primera creación, consultar la Plantilla de activos visuales):
- Principio de entrada mínima: Crear
### {clave del activo}y una línea visible- Apariencia:solo para los personajes, locaciones y utilería que deben aparecer en este episodio (para locaciones se puede agregarPunto de anclaje, para utilería que tenga una entrada correspondiente enbible/inventory.md, agregar- Objeto: Ixxx, para entradas que involucren secretos, agregar- Presagio a revelar:o- Episodio de revelación:). No escribirpalabras clave, la refinación de la apariencia completa y las ranuras para imágenes de referencia se dejan parafiction-visual-prompts. En la primera creación, solo escribirRelación de aspectosi es diferente devisual.aspect_ratioen la configuración, y confirmar con el autor elEstilo visualgeneral de la serie. - Nombres canónicos y variantes: Usar el nombre canónico de
bible/characters.mden## Personajes; no crear entradas para extras sin archivo; no repetir el mismo nombre en diferentes grupos; los cambios de apariencia o estado usannombre@variante(dentro del mismo grupo, debe existir primero la entrada de la entidad base). No mezclar los tres niveles; ver Guía de escritura de activos visuales para detalles. - Actualizar el resumen: Si en este paso se agrega o modifica cualquier
Presagio a revelar/Episodio de revelación, se debe volver a ejecutar inmediatamentenode <directorio de esta skill>/scripts/storyboard-check.mjs <serie> --ep <N> --briefpara sincronizar las nuevas verdades de presagios y activos restringidos en la lista de verificación de este episodio.
Si este episodio tiene cambios de estado que continuarán en episodios posteriores (cambio de vestuario, heridas/manchas persistentes, transferencia/destrucción/salida de utilería, cambio persistente de locación), escribir directamente los cambios netos de este episodio en drama/{serie}/visual/continuity.md según SB §9.5 (para la primera creación de la tabla, consultar la Plantilla de tabla de continuidad entre episodios), para que la verificación automática del paso 6 la valide de una vez. Si hay una discrepancia entre continuity.md y bible/inventory.md en el resumen, a menos que ya tenga la aprobación del autor y esté registrado como adaptación en adaptation-map.md, todas las demás diferencias deben presentarse al autor para que decida, nunca reescribir bible/inventory.md de la novela; ver Guía de continuidad entre episodios para detalles.
3. Primero Segmentar, Luego Cortar en Planos
Abrir SB §9.6 y SB §6.1, escribir drama/{serie}/storyboards/ep{NNN}.md según la Plantilla de storyboard, inicialmente con - Estado: borrador.
- Primero segmentar (
## SEG01|Escena 1): Un segmento = una generación de video, nunca cruzar escenas. Normalmente, dividir en segmentos de 9–15 segundos según las unidades narrativas (las tomas cortas individuales pueden ser más cortas de 9 segundos), la duración total no debe excederstoryboard.segment.max_seconds(por defecto 15 segundos, ver SB §8). Campos obligatorios:Ubicación; según sea necesario:Posicionamiento,Sonido ambiental,Música de fondo. - Cortar en planos dentro del segmento (
### SH001|3s): Los planos individuales se cortan alrededor de 3 segundos, dentro del rangostoryboard.shot.seconds(por defecto 2–5 segundos), la duración no puede ser 0. Campos obligatorios:Tamaño de plano(conjunto cerrado de 6 elementos) yImagen; según sea necesario:Movimiento de cámara(conjunto cerrado de 8 elementos, por defectoFijo),Transición(conjunto cerrado de 4 elementos, por defectoCorte),Personajes,Utilería,Base,Sonido,Notas. - Reclamo textual de diálogos y acciones:
- Diálogos: Copiar textualmente cada línea de diálogo de la escena en el bloque del plano en el orden del guion (incluyendo puntuación y
(OS)/(VO)aplicables), no cambiar palabras, no eliminar palabras. Si una línea de diálogo único, convertida a segundos segúndrama.chars_per_minute(por defecto 250 puntos de código/minuto, sin redondear), no cabe en un solo plano, dividirla en líneas de diálogo legales en planos adyacentes, que al unirlas deben coincidir palabra por palabra con la línea original. - Acciones y líneas de cámara: Extraer textualmente fragmentos de las líneas de acción
△y las líneas de cámara【…】en- Base:(al menos 4 puntos de código por segmento, múltiples fragmentos separados por;), y asegurarse de queImagenrealmente represente la acción.
- Diálogos: Copiar textualmente cada línea de diálogo de la escena en el bloque del plano en el orden del guion (incluyendo puntuación y
- Lenguaje de cámara y composición vertical: El primer plano de todo el episodio debe tener un sujeto en movimiento; alternar tamaños de plano cercanos y lejanos, alternar duraciones largas y cortas; en diálogos, usar planos y contraplanos con planos de reacción, insertar primeros planos cortos en acciones clave; cortar en medio de una acción (movimiento con movimiento); dentro de un segmento, máximo 1–2 movimientos de cámara no fijos, por defecto
Fijo; en 9:16 vertical, evitar planos amplios vacíos, usar el frente, medio y fondo para crear profundidad, usar el movimiento de los personajes para mostrar el entorno; escribir la posición de la cámara, el ángulo y la distancia focal enImagen. Ver Gramática de segmentación y corte y Composición vertical y escritura de imagen para detalles. - Mantener la numeración estable: Para insertar planos, usar nuevos números o sufijos de letras (ej.
SH003a), no cambiar números antiguos para extender la secuencia, no reutilizar números eliminados.
4. Escribir Imagen Claramente Según el Principio de un Solo Instante
Organizar Imagen de cada plano como "Inicio → Acción → Fin", para que cuando fiction-visual-prompts escriba el prompt del primer fotograma, se fije solo en el instante inicial, sin adelantar el proceso o el resultado. Solo cuando la composición final de un plano o la postura de relevo deba fijarse, anotar en Notas una sugerencia para que el paso siguiente agregue un prompt del fotograma final. Ver Límites de un solo instante y primer/último fotograma para la escritura.
5. Verificación Anti-Spoiler Plano por Plano
Contra la lista más reciente de --brief (y ## Cuenta de Suspense de series.md para series originales), verificar plano por plano, incluyendo los campos a nivel de segmento Posicionamiento, Sonido ambiental, Música de fondo y los campos a nivel de plano Imagen, Sonido, Notas:
- No hacer referencia directa a
Activos aún no disponibles(esto activa el bloqueosb-spoiler), ni cambiar la redacción en el texto de la imagen para filtrarVerdades que no se deben dibujar en este episodio,Secretos de personajeso laCuenta de Suspenseoriginal; los presagios marcados como "revelados en este episodio" también deben ocultarse antes del plano de revelación. - Cuando sea necesario que algo aparezca en el plano pero no se pueda mostrar su naturaleza, usar siluetas de espaldas, objetos en primer plano que bloqueen, contraluz con fuentes de luz existentes o encuadres parciales; cuando la entidad esté restringida, crear una variante de ocultación con
Episodio de revelación: 1y pasar afiction-visual-promptsla advertencia de no colocar imágenes de referencia de la entidad base y de borrar los campos heredados (SB §9.9). Si no está seguro del alcance, detenerse y preguntar al autor. Ver Verificación anti-spoiler plano por plano para detalles.
6. Ejecutar Verificación Automática, Verificar Cobertura, Finalizar y Sincronizar con Revisiones del Guion
Después de escribir el storyboard y los cambios netos de continuidad de este episodio, ejecutar desde la raíz del libro (usar --json para facilitar la verificación de cobertura y el resumen de duración, ver storyboard-check.mjs --help para uso):
node <directorio de esta skill>/scripts/storyboard-check.mjs <serie> --ep <N>
node <directorio de esta skill>/scripts/storyboard-check.mjs <serie> --ep <N> --json
- Confirmar que la verificación completa se ha ejecutado realmente: No solo se requiere código de salida 0 y cero
block, sino también verificar en la salida queassets.existsseatrue(sinva-missing, de lo contrario, la verificación de activos, anti-spoiler y continuidad se omitirán) y que el episodio objetivoNaparezca enepisodes[](confirmando que el storyboard del episodio objetivo ha sido realmente validado). El código de salida 2 no cuenta como aprobación. - Manejar cada
suggestindividualmente: Decidir si modificar o mantener, y anotar la razón. CualquierNotasno vacía hará que la verificaciónsb-peopleysb-continuityde ese plano se omita; solo escribirNotassi hay una razón real, y revisar manualmente plano por plano el número de personas que aparecen y la continuidad (Guía de continuidad entre episodios). [Modelo] - Finalización y reversión en caso de fallo: Solo después de eliminar todos los
block, verificar que no falte el reclamo de escenas y diálogos, obtener la confirmación del autor sobre los elementos dudosos y la finalización, cambiarEstadoafinalizadoy ejecutarstoryboard-check.mjsuna última vez. En estadofinalizado,sb-dialogue-missingysb-scene-uncoveredse convierten enblock; si al volver a ejecutar aparece cualquierblocko código de salida distinto de cero, revertir inmediatamenteEstadoaborradoromodificado, corregir y volver a verificar, nunca entregar con errores. - Proceso de sincronización durante revisiones posteriores del guion:
- Después de que el guion revisado se finalice nuevamente y se actualicen las líneas de mapeo, volver a verificar todas las barreras de entrada del paso 1.
- Ejecutar
node <directorio de esta skill>/scripts/storyboard-check.mjs <serie> --ep <N>para localizar los diálogos yBasedesactualizados, primero corregir el storyboard manteniendo la numeración sin cambios estable. - Si los cambios en el guion afectan el estado entre episodios, primero revisar la línea original de este episodio en
drama/{serie}/visual/continuity.md(SB §9.5), luego ejecutarnode <directorio de esta skill>/scripts/storyboard-check.mjs <serie> --ep <N>-<último episodio>en los episodios posteriores afectados y corregir sincrónicamente. - Una vez que todo haya pasado la verificación, entregar la lista de cambios
SEG/SHde este episodio y los episodios posteriores afectados afiction-visual-promptspara sincronizar los prompts (SB §4.2), el orden no se puede invertir.
7. Informar y Entregar
Informar al autor en el formato a continuación, e indicar claramente si se entrega a fiction-visual-prompts.
Lista de Verificación de Entrega
-
drama-check.mjs <serie> --ep Ncódigo de salida 0, ceroblocka nivel de serie y en el episodio objetivo, la línea del episodio enadaptation-map.mdestá completa (sinmap-missing).[Script] - Se ha recibido el informe de
fiction-short-dramacon código de salida 0 para el últimolint --seriesde esta serie.[Modelo] - El guion del episodio objetivo ha sido finalizado por el autor (
Estado: finalizado).[Autor] - Esta skill no ha modificado ningún diálogo, acción o trama del guion; si se necesitaba modificar el guion, se ha devuelto al paso anterior.
[Modelo] - Antes de comenzar, se ejecutó
storyboard-check.mjs --ep N --briefy se leyeron las cinco secciones completas; después de modificar los campos de revelación, se actualizó el resumen; para series originales, se verificó manualmenteseries.md## Cuenta de Suspense.[Modelo] -
visual/assets.mdtiene entradas mínimas para los personajes (nombre canónico), locaciones, utilería y variantes necesarias que aparecen en este episodio, sin escribirpalabras clave.[Modelo] -
storyboard-check.mjs <serie> --ep Ncódigo de salida 0, ceroblock, y la salida confirmaassets.exists: true, el episodio objetivo está enepisodes[]; después de la finalización, se volvió a ejecutar y pasó.[Script] - Todas las
suggestse han manejado individualmente; los planos conNotasse han revisado manualmente para el número de personas que aparecen y la continuidad; los cambios netos entre episodios de este episodio se han escrito envisual/continuity.md, sin reescribirinventory.mdoforeshadows.mdde la novela.[Modelo] - El primer plano tiene un sujeto en movimiento; hay variación en los tamaños de plano y las duraciones; cada segmento tiene ≤2 movimientos de cámara no fijos; las líneas de acción del guion se han traducido realmente en actuación en
Imagen(no solo colocarBase);Imagenestá escrita como un solo instante "Inicio → Acción → Fin"; la profundidad vertical en 9:16 es clara.[Modelo] - Se ha verificado plano por plano, incluyendo los campos a nivel de segmento, contra la lista de imágenes prohibidas, sin filtrar información cambiando la redacción.
[Modelo] - La línea visual general, el método de filmación de las escenas clave, las dudas sobre anti-spoiler, las diferencias de objetos entre episodios y la finalización del storyboard han sido aprobados por el autor.
[Autor]
Productos e Informe
Productos o actualizaciones: drama/{serie}/storyboards/ep{NNN}.md, drama/{serie}/visual/assets.md, actualizar drama/{serie}/visual/continuity.md según sea necesario. Informar en cinco puntos:
- Escala y duración del storyboard: Tomar de
storyboard-check.mjs --ep N --jsonenepisodes[]el número de episodio, ruta,status,segments,shots,secondsyrange(sirangeesnull, reportar "Sin duración objetivo establecida"; si está fuera del rango, es una sugerencia, explicar la razón del ajuste o mantenimiento). - Resultados de la verificación automática: Códigos de salida y número de
blockdedrama-checkystoryboard-check(ambos deben ser 0), confirmarassets.exists: truey que el episodio objetivo ha sido verificado; listar lassuggestno resueltas y la razón de cada una. - Cambios en activos y continuidad: Las nuevas entradas mínimas y variantes creadas en
visual/assets.mden esta ronda (incluyendo elementos heredados de variantes de ocultación que requieran atención en el paso siguiente); las líneas agregadas o modificadas envisual/continuity.md. - Alcance de la sincronización de revisión (solo durante revisión): Lista de números de
SEG/SHmodificados en este episodio y episodios posteriores afectados, para quefiction-visual-promptslos sincronice. - Pendientes de confirmación del autor: Dudas sobre anti-spoiler, diferencias de objetos entre episodios, método de filmación de escenas clave, o puntos que requieran devolver el guion para modificación; si no hay, escribir "Ninguno".
Documentos de Referencia
| Cuando encuentres... | Lee esto |
|---|---|
| Consultar rutas de directorio, resolución de conflictos en la cadena visual, orden de lectura mínimo requerido y escritura por eventos | SB §1–§5: Estructura del proyecto y reglas de lectura/escritura |
| Verificar formato de guiones episódicos, encabezados de escena, líneas de diálogo y tabla de mapeo | SB §6.1, §9–§9.3: Guión de serie corta |
| Escribir activos visuales, tabla de continuidad entre episodios, campos de storyboard, vocabulario cerrado y reglas anti-spoiler | SB §6.1, §9.4–§9.6, §9.9: Activos visuales y storyboard |
| Consultar valores predeterminados de configuración como relación de aspecto, duración de segmentos/planos, límite de personas, velocidad de diálogo | SB §8: Configuración del proyecto |
| Segmentación y corte, división de diálogos entre planos, conteo de movimientos de cámara no fijos, ejemplo del episodio 3 | Gramática de segmentación y corte |
Composición vertical 9:16, profundidad de frente/medio/fondo, escribir posición/ángulo/distancia focal en Imagen | Composición vertical y escritura de imagen |
| Escribir "Inicio → Acción → Fin", distinguir el instante único del primer fotograma y cuándo marcar el fotograma final | Límites de un solo instante y primer/último fotograma |
| Escribir los tres niveles de activos, orientación relativa y puntos de anclaje de locaciones, selección de utilería y reglas de letras | Guía de escritura de activos visuales |
Usar --brief y la cuenta de suspense original para verificación anti-spoiler plano por plano, cuatro métodos de ocultación, variantes de ocultación | Verificación anti-spoiler plano por plano |
Escribir cambios netos entre episodios, resolución de variantes, exención de flashbacks, manejo de diferencias con inventory.md | Guía de continuidad entre episodios |
| Crear un nuevo esqueleto de storyboard, biblioteca de activos o tabla de continuidad entre episodios | Plantilla de storyboard, Plantilla de activos visuales, Plantilla de tabla de continuidad entre episodios |