Communitygithub.com

film-storyboard

Escribe la historia de un vídeo de producto como beats (lo que ve el espectador, el texto en pantalla, la voz, el sonido, el motivo del beat y dónde se prueba cada afirmación) y envíala al propietario como un storyboard de una página con fotogramas para revisión, con 2–4 direcciones cuando la historia esté abierta. Etapa 2 de product-film, y el formato de revisión reutilizado para la voz en off. Úsalo al planificar la historia, el guion gráfico o el script de un vídeo de lanzamiento/promoción, o cuando el propietario diga 'dame un storyboard', 'dame direcciones', 'revisaré y decidiré'.

¿Qué es film-storyboard?

El skill film-storyboard automatiza la creación de storyboards para vídeos de producto, permitiendo a los agentes de IA estructurar la narrativa visual en 'beats' (latidos) antes de la producción. Es útil porque detecta errores temprano —cambiar una frase cuesta un minuto, mientras que modificar un fotograma renderizado cuesta una hora—, lo que ahorra tiempo y recursos en el desarrollo de vídeos promocionales o de lanzamiento. Soporta plataformas como Claude Code, Cursor y Codex, y se basa en un archivo JSON (`storyboard.json`) que define cada beat con campos como imagen, texto en pantalla, voz en off, sonido, motivo y prueba de cada afirmación. El skill genera una página HTML de revisión de una sola página, con múltiples direcciones narrativas (2–4) cuando la historia está abierta, y asegura que cada beat cumpla con criterios de calidad como especificidad, autenticidad y legibilidad, según lecciones de borradores previos. Tras la aprobación, el archivo JSON se mantiene como fuente única de verdad para sincronizar tiempos y frases entre el vídeo y la voz en off.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/aqeelshamz/product-film-skills/tree/HEAD/film-storyboard

Preguntar en tu IA favorita

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

Documentación

Storyboard de vídeo de producto

El storyboard es donde deberían ocurrir la mayoría de las correcciones del propietario, porque cambiar una frase cuesta un minuto y cambiar un fotograma renderizado cuesta una hora. Envíalo antes de construir, y envíalo de nuevo (con fotogramas reales) antes de grabar una voz.

Qué hace que una historia de vídeo de producto sea buena

Verifica cada beat contra estos criterios. Cada uno proviene de un borrador rechazado (consulta product-film/references/lessons.md).

  1. El dolor del espectador, en su día a día. Nombra el hábito o la molestia como lo diría el espectador. Prueba la línea: después de escucharla, ¿qué pensaría un desconocido que vendemos? "Los mismos números cada día" hizo pensar en software de análisis, por lo que falló.
  2. Los roles no pueden malinterpretarse. Muestra herramientas reales por nombre y logotipo. Revisa cada par de líneas adyacentes: "Pregúntale a la IA que ya pagas. Se llama Nimbet." hace que el producto suene como la IA. Asocia el nombre a lo que el producto hace.
  3. Específico, no abstracto. "Tu IA" como etiqueta no fue claro; la ventana real de Claude Desktop fue clara. Un panel real de Stripe supera a una caja etiquetada como "Ingresos".
  4. El rango necesita espacio. Si la promesa es "lo QUE TÚ necesites", muestra 8+ tipos de personas (tarjeta a pantalla completa cada una), luego un muro de muchos artículos que mezclen trabajo, vida y diversión (juegos, mascotas, pegatinas). Menos de ~6 "se siente estancado". Esto necesita 45–65 s; 20 s es demasiado corto.
  5. Solo real. Cada elemento, capacidad y afirmación funciona en el producto hoy. Llena el campo claim con dónde está probado (un archivo, un documento, una prueba). Si la historia necesita algo que el producto no puede hacer, plantéalo al propietario: constrúyelo o elimínalo.
  6. Comprende cada plano antes de escribir sobre él. Escribe el why para cada beat. Si no puedes decir para qué sirve un plano, pregúntale al propietario. (Una línea sobre mascotas se escribió sobre un plano que en realidad mostraba los widgets personalizados de las personas).
  7. Cada línea legible. Texto en pantalla: ~0,3 s por palabra + 1 s, nunca menos de 1,5 s completamente visible.
  8. Termina con la acción, con el nombre y la URL, y la línea de uso nominativo si apareció alguna marca.

Pasos

  1. Lee el brief aprobado, reference/NOTES.md, el producto y sitio en vivo, y el archivo de lecciones.
  2. Redacta beats en storyboard.json (formato en el encabezado del script):
    { "title": "…", "subtitle": "borrador 1 · 16:9 · 60 s", "directions": ["A · …", "B · …"],
      "beats": [{ "t": "0.0–4.0", "still": "review/sketches/01.png", "picture": "…", "onscreen": "…",
                  "vo": {"A · …": "…", "B · …": "…"}, "sfx": "…", "why": "…", "claim": "…" }] }
    
    Antes de que exista el vídeo, still puede ser un boceto rápido o un fotograma de la referencia con una nota; después, siempre un fotograma REAL renderizado (node scripts/render.mjs --at …).
  3. Direcciones. Cuando el ángulo esté abierto, escribe 2–4 direcciones que difieran en idea, no en redacción (ej. "Consejos que el espectador puede usar", "La molestia diaria", "Lo que tu IA ya sabe de ti"). Para cada una: idea de una línea, el riesgo y a quién se adapta. Pon tu elección primero.
  4. Construye la página:
    python3 ~/.claude/skills/film-storyboard/scripts/storyboard.py storyboard.json review/storyboard.html
    
    Se abre con la voz en off de cada dirección como un párrafo (la lectura con ojos cerrados), luego cada beat con su fotograma.
  5. Autoverificación antes de enviar: lee solo el párrafo de transcripción. ¿Tiene sentido con los ojos cerrados? ¿Alguna línea que podría malinterpretarse? ¿Alguna lista de "tu X, tu Y", tríada o palabra repetida? ¿Alguna afirmación sin prueba?
  6. Puerta de revisión. Envía la página (SendUserFile, display render) y pregunta: qué dirección y qué beats cambiar. Añade las preguntas de la etapa 2 de product-film/references/question-bank.md (apertura, cómo se muestran los roles, formato de persona, personajes, realismo de la interfaz de usuario). Espera un sí claro. Confirma storyboard.json.

Después de la aprobación

Mantén storyboard.json como fuente de verdad: tanto el tiempo de los planos en el vídeo como la colocación de frases en la voz en off provienen de él. Cuando el propietario cambie un beat más tarde, cámbialo aquí primero y regenera la página.

Individual skills in this repo

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

film-build

Build a product film in code as a deterministic seek(t) web page (real product UI, real OS chrome, kinetic text, typed prompts, a cursor, morphs and camera moves), review it as stills and drafts, render it at 60 fps with motion blur, and adapt it to 9:16 without changing 16:9. Ships a project kit (init.sh, film engine, render/sync/probe/sheet/regression tools). Stage 3 and 6 of product-film. Use when building, fixing or rendering the picture of a launch/promo film, or making its vertical version.

film-sound

Add sound to a finished product-film picture with real recorded sound effects (CC0 packs such as Kenney's) placed only on real on-screen events, decide with the owner whether there's a music bed, mix to -14 LUFS and mux into the renders without re-rendering. Stage 4 of product-film. Use when a film's picture is approved and needs sound effects or music, or when the owner says the sounds feel fake, synthetic or "AI slop".

film-voiceover

Write, review, test and record the voiceover for a product film after its picture is approved, as a script on a storyboard of the film's real frames, with directions to choose from, an eyes-closed coherence check, a pronunciation test for the product name, TTS recording per section (Fish Audio), phrase placement on the film's timeline, mixing and muxing. Stage 5 of product-film. Use when a launch/promo film needs narration, or the owner says the voiceover sounds like AI, doesn't match the frames, or mispronounces the name.

product-film

Make a product launch / promo / explainer film that sells and does not look or sound AI-made, through review gates the owner signs off one at a time. Study a reference video for its grammar (never copy it), then storyboard, build the film in code, add sound, write and record the voiceover, and deliver 16:9 and 9:16. Use when someone wants a launch video, promo, product film, explainer, ad, "a video like this one" for their product, or says the last video looked like "AI slop" or "vibe coded". Entry point for the film-* skills (film-reference-study, film-storyboard, film-build, film-sound, film-voiceover).

Skills relacionados