Communitygithub.com

storyboard-reel

Guía al agente para planificar, construir o editar un 'storyboard reel' cuyo resultado concreto es un logotipo y una pequeña hoja de marca. El procedimiento avanza a través del Storyboard Reel, el formato y las entradas. Úsalo cuando una nueva tarea requiera este oficio.

¿Qué es storyboard-reel?

Esta skill convierte un storyboard dibujado a mano y renders de un personaje low poly en un anuncio vertical 9:16 de aproximadamente 28 segundos con música y efectos de sonido, sin narración ni subtítulos. Está diseñada para agentes de IA que trabajan con herramientas de edición de video y generación de imágenes; su motor está basado en Python y utiliza scripts modulares para manejo de planos, recortes (rembg), medios (ffmpeg) y un servidor de medios. La skill soporta múltiples tipos de plano (logo, dolly, pose, clip, glow, shirt, card, still, scan, etc.) y permite personalizar el aspecto VHS, la música de fondo y los efectos de sonido. El flujo de trabajo guía al agente desde la creación de un nuevo trabajo y la configuración del storyboard hasta la generación de recortes, placas de fondo, hojas de contacto, clips de video, previas, aprobación, renderizado final y subida a CDN (BunnyCDN). Incluye controles de calidad como puertas de revisión (contact sheet, preview) que detienen el proceso hasta que el usuario da el visto bueno, y gestiona costos al diferenciar operaciones gratuitas (placas, recortes, render local) de las que requieren créditos (key frames, clips, música). La skill también proporciona instrucciones detalladas para manejar problemas comunes, como pies recortados en cutouts, armas en clips, o la alineación de personajes, y recomienda crear un tablero de borrador gratuito antes de cualquier llamada paga.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/lokiverde/video-studio/tree/HEAD/skills/storyboard-reel

Preguntar en tu IA favorita

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

Documentación

Storyboard Reel

Convierte un storyboard dibujado a mano, algunos renders de un personaje low poly y el producto en un anuncio 9:16 de aproximadamente 28 segundos con música y efectos de sonido. Sin narración, sin subtítulos sobre la acción.

Motor: python3 scripts/storyboard_reel.py <comando> <trabajo>, ejecutado desde la raíz del repositorio (la carpeta que contiene scripts/). --help lista todos los comandos. La lógica está en scripts/sr_lib.py (tipos de plano, valores predeterminados, temporización, comprobaciones), sr_shots.py (dibujo), sr_matte.py (recortes), sr_media.py (ffmpeg, rembg, servidor de medios). En Windows usa python en lugar de python3.

Punto de partida: skills/storyboard-reel/job_template.json. new lo copia dentro del trabajo. Su ejemplo es un reel de figura y resplandor. Un reel centrado en cámara se construye a partir de planos clip.

El formato

  • 9:16, aproximadamente 28 segundos. La pista de música define la duración.
  • Tipos de plano que dibuja el motor: logo (sobre negro), black, dolly (acercamiento a una figura), pose (mantener), clip (un movimiento de imagen a video), glow (la luz de un accesorio se acumula y explota), white, shirt (camiseta blanca sobre blanco, el diseño aparece gradualmente, título debajo), card (título, maqueta, precio, tallas, colores, sitio), still (imagen clave a pantalla completa) y scan (una búsqueda a través de un visor).
  • Reordena, repite o elimina tipos para seguir el storyboard. Un panel que ningún tipo pueda dibujar necesita una nueva función de dibujo en sr_shots.py más una prueba. Dilo antes de construir alrededor de él.
  • Aspecto VHS: "vhs": 0.5 en job.json (0 desactivado, 1 completo). Se sitúa en la sección del personaje y desaparece gradualmente en el destello blanco, para que la camiseta y la tarjeta vuelvan limpias. Con vhs activado, el entregable principal es final_9x16_vhs.mp4.

Entradas

  • Una carpeta con las páginas del storyboard y tus renders de la figura (uno por pose). Nombra los archivos con logo, mockup o board en el nombre y serán detectados. Añade el logo sobre blanco y una maqueta del producto si los tienes.
  • La URL de la página del producto. new lee el .json de Shopify de la página para el título, precio, tallas y colores.
  • Para la revelación, una foto de la parte trasera sobre un fondo claro y liso. Si no se establece, se usa la primera imagen de la tienda. A menudo es una maqueta recargada, así que cámbiala por una limpia.

Flujo de trabajo

  1. Nuevo trabajo. python3 scripts/storyboard_reel.py new <url-producto> <carpeta-imágenes> [--word <tema>] [--title "<título>"] Copia las imágenes en src/, las imágenes de la tienda en product/, y rellena el texto de la tarjeta. --word termina el nombre de la carpeta del trabajo con una palabra temática.
  2. Editar job.json a partir del storyboard. Asigna cada panel a un plano, establece panel para que coincida con el storyboard, asigna cada render a una figura, y escribe el prompt de la placa. Se completa cuando python3 scripts/storyboard_reel.py check <trabajo> imprime la línea de tiempo sin problemas.
  3. Recortes (reels de figura): cutouts <trabajo>, luego abre work/cut/feet_check.jpg. rembg puede eliminar hueso pálido sobre suelo pálido y conservar la sombra proyectada. Arregla cada pie con cuadros figures.<nombre>.feet en píxeles fuente (add restaura píxeles pálidos, drop elimina sombra oscura del suelo, rebuild rededuce el cuadro). Vuelve a ejecutar hasta que cada pie esté completo.
  4. Placa. plate <trabajo> --n 3 hace candidatos de fondo en el servidor de medios (gratuito). Revisa work/bg/plates.jpg y establece plate.src al que encaje. Mantén "suelo amplio, vacío y plano en primer plano" en el prompt, porque las figuras se colocan en look.feet_y. También puedes establecer plate.src con tu propia imagen.
  5. Hoja de contacto, la primera puerta. stills <trabajo> escribe work/contact_sheet_9x16.jpg. Comprueba que los pies se apoyen en el suelo, que la figura no tape la barra inferior de la interfaz y que el texto de la tarjeta sea correcto. Muestra al usuario la hoja y el coste estimado de los clips. Detente y espera.
  6. Clips, solo después de la luz verde del usuario. kling-frames <trabajo> escribe work/kling/<plano>_start.jpg (más _end.jpg donde el clip tenga un fotograma final) e imprime cada prompt. Sube los fotogramas a tu servicio de imagen a video (OpenArt: sube, cotiza con openart_model_cost, luego genera), bajo una línea AUTH en ~/video-studio/relay/auth.md. Guarda la descarga, luego prep-clip <trabajo> <descarga.mp4> --shot <id>. La duración del clip define la duración de su plano.
  7. Previa, la segunda puerta. preview <trabajo> renderiza el tramo del clip con sonido en work/preview_clip.mp4. Revisa el movimiento fotograma a fotograma, vuelve a ejecutar stills, y luego muestra al usuario la previa y la nueva hoja. Detente y espera.
  8. Copias para publicación. Escribe post en job.json: un caption corto, luego instagram, tiktok, youtube (título y descripción), facebook, hooks, order y una nota cover. El motor añade el bloque de firma fijo de sr_post.py a cada caption. Edita ese bloque para tu marca. Se completa cuando kit <trabajo> no imprime líneas de "copias no listas".
  9. Aprobar y renderizar. Después de la luz verde del usuario: approve <trabajo>, luego render <trabajo>. Esto escribe out/final_9x16_vhs.mp4 (la copia con cinta, más lenta), out/cover.jpg, out/post.txt y out/posts.md. Luego render <trabajo> --clean escribe la versión limpia out/final_9x16.mp4. Cada render también escribe un gemelo _nomusic (efectos de sonido, sin pista musical). Revisa la línea 1080x1920 30/1 <duración>s, audio, luego extrae fotogramas en los cortes. --out <ruta> hace un render lateral que deja out/ y el estado del trabajo intactos.
  10. Subir. upload <trabajo> envía los archivos finales, gemelos, portada y kit de publicación a tu almacenamiento CDN (BunnyCDN, claves en config.env). Se niega si las copias tienen captions vacíos o <placeholders> sobrantes. Una re-subida va a un nuevo nombre (_v2) porque los CDN siguen sirviendo el archivo antiguo en una ruta reutilizada. Dale al usuario las nuevas URLs y pega los captions por plataforma desde posts.md. La publicación es paso del usuario.

La puerta de previa (aplicada en código)

render está bloqueado hasta approve, y approve solo funciona sobre una hoja hecha con el trabajo actual. Cualquier cambio en la imagen invalida la aprobación: planos, figuras, placa, aspecto, recortes, un nuevo clip, o cualquier ruta en la parte visual de job.json. Ediciones de audio y copias no la invalidan. Después de un cambio de imagen, haz una hoja nueva y muéstrala de nuevo. render --no-preview es solo para la renuncia explícita del usuario en ese trabajo concreto.

Movimiento centrado en cámara

Los planos de movimiento son clips de imagen a video centrados en cámara, escritos como tomas de metraje real: un rig de cámara y lente, un movimiento de cámara con "no es un zoom, no es un corte", luego la acción. Empieza con la capa de baja resolución. Los planos fijos con zooms lentos parecen una presentación de diapositivas.

  • Solo fotograma de inicio: la cámara es libre (dolly, arco, avance).
  • Un acercamiento que debe aterrizar en una pose: añade un fotograma final, un recorte de la pose final a aproximadamente 1.12x. El acercamiento entonces aterriza exactamente allí. Un primer plano solo de inicio puede cortar la cabeza.
  • Un clip fijo (clip con rutas de imagen start y end) debe seguir a un fijo cuyo src sea su fotograma de inicio.
  • "in": 1.0 omite el primer segundo de un clip. dur: "clip" toma la duración real del clip, y el plano fill absorbe la diferencia.
  • "gain" oscurece un clip. "lights_out": {"at": 2.8, "flicker": 0.7, "floor": 0.04} hace parpadear la luz y cae a casi negro, hecho en la edición sin coste. Combínalo con un efecto de sonido a juego.
  • Mantén la amenaza fuera de pantalla. Oscuro e invisible da más miedo que una criatura en pantalla.
  • Mantén los disparos fuera de pantalla: corta a negro y deja que el sonido los transmita. Los modelos disparan armas incluso cuando se les dice que no, así que revisa los clips de armas fotograma a fotograma y termina el plano antes de cualquier disparo.
  • Redacción del prompt para el modelo de video:
    • Un movimiento lento y continuo. Nombra lo que permanece quieto (cuerpo, pies, fondo).
    • Di cómo se comportan los accesorios ("el bastón se mantiene erguido y nunca se balancea"). Evita "balancear".
    • Describe lo que debe aparecer. Las negaciones ("sin niebla") a menudo se ignoran, así que muestra menos.
    • Cuando el accesorio se mueve, todo el cuerpo se mueve con él: peso, torso, cabeza. Pies plantados.
    • Un primer plano necesita respiración lenta y una pequeña inclinación durante la mayor parte del clip, luego un movimiento rápido. Sin eso parece congelado.
  • Duración del clip: de 3 a 5 segundos. Los clips más largos le dan al modelo espacio para divagar.

Perillas de edición (gratuitas, dibujadas en la edición)

  • "fade_in" funde un clip desde negro. "flash" añade un destello blanco cortado en él.
  • "handheld" (0 a 1) mueve los planos fijos. Úsalo 0 en clips de cámara, que llevan su propia cámara.
  • scan es una búsqueda a través de un visor, como plano propio, sobre un fijo amplio. Nunca uses un paneo de modelo de video para ello, porque un paneo se desliza como un slider: {"kind": "scan", "dur": 4.4, "src": "<fijo amplio>", "span": 0.236, "scope": {"radius": 0.445, "sway": 16, "steady": 2.4}, "path": [[0.0, 0.13, 0.24], [3.2, 0.645, 0.345]]} Cada punto de ruta es [segundos, x, y] sobre el fijo. La mira persigue la ruta con un muelle, por lo que sobrepasa, corrige y aterriza en el último punto. Dile al modelo de video "sin círculo, sin retícula" si se muestra un clip a través de un visor. La edición dibuja el anillo.
  • "live" en un scan reproduce un clip amplio dentro del fijo desde un segundo dado, para que un sujeto se mueva a velocidad real cuando el lente lo encuentra. Úsalo para eliminar una pausa.
  • Un movimiento mecánico pequeño que el modelo no hará (un gatillo, un interruptor): ajústalo en la edición a partir del fotograma clave. Corta la parte móvil como un polígono, rellena detrás, gírala sobre su junta con un empuje lento. Recorta para que el movimiento llene el teléfono.
  • shirt "from_black": 1.0, "from_white": 0 desvanece la revelación desde negro cuando el storyboard no tiene blanco.

Planos fijos a pantalla completa y fotogramas clave

Úsalos cuando no haya renders de figura, o el storyboard tenga primeros planos y tomas en primera persona.

  • Un plano still toma una imagen src a pantalla completa, con push, anchor [x, y], fade_in, fade_out y flash.
  • Los fotogramas clave vienen de un modelo de edición de imágenes, 9:16. Dale la hoja del personaje y la escena como referencias, primero la hoja. En una configuración probada solo las dos primeras referencias llegaron al modelo, así que mantén las importantes primero.
  • El fotograma final de un clip es una edición de su fotograma inicial ("la misma imagen, solo que..."), para que ambos coincidan. Un cambio pequeño es más rápido como edición local en código que como edición del modelo.
  • Un primer plano coincide con la vista de la hoja: una toma lateral es el perfil real de la hoja.
  • Un cráneo de perfil mantiene proporciones reales (un cráneo redondo sobre una cara corta). Una capucha sigue el cráneo y cubre la parte superior y trasera. Dilo en el prompt.
  • Juzga el tocado por su contorno lateral. Describe el contorno ("corto, redondo, termina en la parte trasera de la cabeza"). Palabras como "alto" o "puntiagudo" hacen que los modelos generen un gorro de mago.
  • Una mano mide aproximadamente lo alto que es el cráneo. Para manos esqueléticas, nombra los huesos de los dedos por separado. "Grueso rechoncho" solo da un puño.
  • Una toma de apertura comienza alta y amplia sobre todo el set, luego baja a la figura. Haz primero el fotograma amplio y toma el fotograma final cercano como un recorte de él. Una edición que dice "la cámara se ha movido" tiende a escalar la figura en su lugar.

Tablero de borrador gratuito primero

Antes de cualquier llamada paga, bosqueja cada panel en el servidor de medios (FLUX, unos 8 segundos cada uno) en work/keys/, luego ejecuta stills. El usuario ve todo el corte gratis. Un boceto no mantiene un personaje, así que dilo cuando lo muestres. Los fotogramas clave pagados reemplazan los bocetos. Con un personaje nuevo, la hoja del personaje es la primera llamada paga. Cada fotograma clave entonces toma esa hoja como su primera referencia.

Mantén una dirección de pantalla por personaje (refleja un boceto si mira hacia el lado equivocado). Los personajes recurrentes se cortan a partir de sus fotogramas clave reales, nunca de un boceto.

Mantén cada personaje recurrente en assets/characters/<nombre>/ con un README: la hoja, las reglas de vestuario, los sets que usan. Lee el README antes de cualquier fotograma clave.

Música y sonido

  • Pista musical: instrumental, de aproximadamente 30 segundos, escrita contra la línea de tiempo que check imprime. Un arco típico: un golpe en el logo, una pista sombría bajo el dolly, una construcción creciente a través del clip y el glow, la caída en el blanco, un golpe final en la tarjeta. Genérala con ElevenLabs music, o usa tu propia pista con licencia. Guárdala en assets/music/<nombre>.mp3 y pon el prompt en audio.prompt.
  • Los efectos de sonido viven en assets/sfx/ (impacto, whoosh, riser). Añade entradas audio.sfx ancladas a un plano. Crea una nueva cuando el accesorio cambie.
  • audio.mute: [<ids de plano>] corta la música bruscamente en esos planos y deja los efectos de sonido sonando. Úsalo para "corte a negro, luego disparos".
  • Las ráfagas de disparos generadas se mezclan en una sola pared de ruido. Genera un disparo limpio y superpone la ráfaga localmente: un estante bajo, un golpe grave descendente bajo cada impacto, pequeños cambios de tono y nivel por impacto, luego un limitador.

Costes

Las placas, recortes y el render local son gratuitos. Los fotogramas clave pagados, clips (OpenArt o similar) y la música y efectos de sonido de ElevenLabs cuestan créditos. Cotiza cada llamada primero, y mantén la línea AUTH en ~/video-studio/relay/auth.md cubriéndolo.

job.json, en resumen

length (el punto de corte de la música), product (url, título, precio, tallas, colores), plate (src, prompt), figures (nombre a src, feet opcional, centre_on), shots (una lista de id, kind, dur, panel y claves específicas del tipo), vhs, handheld, audio (music, prompt, music_gain, fade_out, mute, sfx), post (texto para cada plataforma), y un look opcional. Los valores predeterminados por tipo viven en SHOT_DEFAULTS en sr_lib.py. El texto en pantalla acepta {title}, {details} y {site}.

Errores comunes

  • rembg es necesario para los recortes: pip install rembg. El comando cutouts dice lo que falta y cómo configurarlo.
  • El glow encuentra un orbe magenta por color. Para otro accesorio, establece light.at ([x, y, r], fracciones del cuadro de la figura) y light.rgb. Revisa precio y tallas contra la página en vivo.
  • ffmpeg debe estar en tu PATH. Todo el texto en pantalla se dibuja con Pillow, por lo que ffmpeg no necesita el filtro drawtext.

Individual skills in this repo

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

Skills relacionados