storyboard

¿Qué hace storyboard?

Un storyboard es el plan de rodaje y el plan de edición para un video. Está listo cuando el usuario puede leerlo de arriba a abajo, filmar cada sesión y entregar cada toma a la edición (o a Claude) con una imagen clara de lo que aparece en pantalla, lo que dice el texto y cuál es el sonido.

Mantenlo ligero. Tomas y sesiones, nada más. Sin diagrama de arco, sin transiciones por toma, sin kit de marca, sin lista de verificación. Si el usuario quiere más, lo pedirá.

Primera ejecución: configuración guiada

Ejecuta la configuración cuando ~/.claude/storyboard-profile/profile.md aún no exista, justo después de instalar la habilidad, o cuando el usuario pida configurarla o reaprender su estilo. Guíalo paso a paso: di para qué sirve el paso en una frase, hazlo y espera donde dice que preguntes. Mantén cada mensaje corto; la mayoría de las personas que hacen esto son creadores, no desarrolladores.

1. Bienvenida. Un mensaje corto: qué hace la habilidad (guion de entrada, un fotograma por cada línea de salida, luego Claude construye los gráficos a partir de eso) y que la configuración toma unos cinco minutos. Luego di que lo primero que necesitas es ver sus videos.

2. Verifica las herramientas. Busca Python 3, Google Chrome (o Chromium / Edge) y ffmpeg. yt-dlp es un plus para enlaces. Para lo que falte, da el comando de instalación para su sistema (por ejemplo brew install ffmpeg en Mac, winget install ffmpeg en Windows) y ofrécete a ejecutarlo. No continúes hasta que Chrome y ffmpeg funcionen.

3. Pregunta por ellos. Un mensaje, respondido en una línea cada uno: su usuario y plataformas, de qué trata su contenido, cuánto duran normalmente sus videos y cómo los terminan (una palabra clave de comentario, seguir, enlace en la biografía).

4. Pide sus videos. Este es el paso importante, así que explica por qué: sus storyboards deben parecerse a sus videos, no a una plantilla. Pide de 3 a 5 videos publicados que mejor muestren su estilo, idealmente incluyendo uno con grabaciones de pantalla o gráficos si los hacen. Pueden arrastrar los archivos al chat (eso pega la ruta) o pegar enlaces. Descarga los enlaces con yt-dlp si está instalado; si un enlace no se descarga, pide el archivo. Pon todo en ~/.claude/storyboard-profile/source/.

5. Estudia los videos. Para cada uno:

   • Fotogramas: ffmpeg -i v1.mp4 -vf "fps=1,scale=360:-2" -q:v 4 source/v1_%03d.jpg, luego míralos.
   • Cortes: ffmpeg -i v1.mp4 -vf "select='gt(scene,0.1)',showinfo" -f null - 2>&1 | grep -o "pts_time:[0-9.]*" da los tiempos de corte, así obtienes la duración media de los planos. Los cortes rápidos en una cabeza parlante apenas cambian la imagen y no se detectan, así que verifica el recuento con los fotogramas de 1 fps.
   • Palabras: si whisper (u otro transcriptor) está instalado, transcríbelo. Si no, lee los subtítulos quemados de los fotogramas, o pídeles que peguen el guion.

   Escribe lo que realmente ves, no suposiciones: la mezcla de tipos de plano (cuánto es cara vs pantalla vs b-roll), duración media del plano, encuadre (plano medio o cercano, dónde se sientan, el fondo), cómo enganchan los primeros dos segundos, el texto en pantalla (grosor de fuente, mayúsculas/minúsculas, colores, estilo de resaltado, dónde se sitúa), el estilo de los subtítulos, los colores principales, gráficos o superposiciones que se repiten, hábitos de sonido y cómo aterriza la llamada a la acción.

6. Elige su foto de cara. Elige un fotograma limpio de ellos hablando a cámara sin subtítulos quemados, recórtalo a 9:16 (ffmpeg -ss <t> -i v1.mp4 -frames:v 1 -vf "crop=ih*9/16:ih,scale=540:960" face.jpg) y guárdalo como ~/.claude/storyboard-profile/face.jpg. De ahora en adelante, cada plano de cara lo usa.

7. Escribe el perfil. Guarda ~/.claude/storyboard-profile/profile.md con secciones para Creador (paso 3), Planos (mezcla de tipos, duración media, encuadre), Gancho, Texto en pantalla, Subtítulos, Colores, Sonido, CTA y Gráficos recurrentes. Luego escribe ~/.claude/storyboard-profile/theme.css, sobrescribiendo las variables del kit con su aspecto:

   :root { --ink: #111; --accent: #ff5a1f; --on-accent: #fff; --bg: #f4f1ea;
           --grid: rgba(0,0,0,.05); --font: "Montserrat", sans-serif; }
   

   Usa una fuente que tengan instalada; si la suya no está, elige la más cercana que sí lo esté.

8. Muéstralo y confirma. Construye un fotograma de muestra (su estilo de titular sobre su foto de cara), renderízalo, muéstralo con un resumen de tres líneas del perfil y pregunta qué falta. Ajústalo hasta que digan que se parece a su contenido.

9. Entrega. Diles que la configuración está lista y qué hacer a continuación: "Pega un guion y di 'storyboard esto'." Pueden volver a ejecutar la configuración en cualquier momento si su estilo cambia.

Si prefieren saltarse la configuración, crea el storyboard con el aspecto predeterminado del kit y ofrece la configuración nuevamente al final.

El formato

Cada toma tiene:

campo	qué contiene
type	face (hablando a cámara), split (pantalla arriba, cara en un cuadro redondeado abajo), screen (grabación de pantalla), graphic (construido en la edición), b-roll (metraje del mundo real)
vo	las palabras exactas del guion que se dicen en esta toma
on_screen_text	texto quemado en el fotograma, normalmente en blanco
edit_note	una o dos líneas: qué hay en pantalla, qué se mueve, el encuadre
sfx	un sonido, normalmente en blanco
thesis	true en exactamente una toma
status	real (el fotograma ES el metraje), stand-in (muestra la intención), to-capture (aún nada)

El tiempo proviene de la VO a 3.4 palabras por segundo. Nunca lo establezcas manualmente.

Las sesiones agrupan las tomas por dónde se filman: label, detail (qué preparar) y shots (números de toma).

Pasos

1. Lee el perfil y obtén el guion. Lee ~/.claude/storyboard-profile/profile.md y síguelo: sus duraciones de plano, su mezcla de tipos de plano, su estilo de texto, su CTA. Cuando entre en conflicto con los valores predeterminados a continuación, el perfil gana. ¿Aún no hay perfil? Ofrece la configuración primero. Pide el guion si no está en la conversación o en un archivo, y anota la duración objetivo (la duración habitual del perfil si no lo dicen). No edites el guion. Si una línea suena mal, dilo y deja que el usuario la corrija.

2. Divide el guion en tomas, palabra por palabra. Unidas de nuevo, los campos vo deben ser exactamente el guion. No reformules, recortes ni añadas una línea.

   • Corta donde cambie la imagen, no al final de las frases. Una coma es un buen punto de corte.
   • Apunta a 2 a 6 segundos por toma (7 a 20 palabras). Pasados unos 8 segundos, divídela, a menos que una imagen continua realmente transmita la línea.
   • La toma 1 tiene la cara del hablante (una toma face o split). Una cara en el primer segundo retiene a la gente.
   • Marca exactamente una toma thesis: la línea que dice de qué trata el video.
   • Última toma: la cara del hablante diciendo la llamada a la acción. Si hay una palabra clave de comentario, se dice y vive en los subtítulos, no como una píldora grande en pantalla.
   • Varía el tipo. No tres tomas face seguidas. Usa face para afirmaciones, comentarios al margen y la CTA; usa screen para cualquier cosa que se muestre.

3. Rellena los campos con moderación.

   • on_screen_text: el titular de la toma 1, números de lista (01 SCRIPT) y como máximo un remate. En blanco en el resto; los subtítulos llevan el resto.
   • edit_note: qué hay en pantalla, qué se mueve y el encuadre (plano medio o cercano). Pon aquí también las indicaciones de privacidad: difumina correos electrónicos, recorta rutas de archivo que muestren un nombre de usuario.
   • sfx: dos o tres en todo el video, solo donde algo aterriza (un ping al abrir, un golpe cuando algo se vuelve público).

4. Agrupa las tomas en sesiones por dónde se filman, no por orden de toma.

   • Cara: una sesión por cada toma de cara más la mitad de cara de cada toma split.
   • Pantallas: una sesión por cada aplicación o sesión de herramienta, usando el mismo proyecto real durante todo el proceso.
   • Fuera del escritorio: solo si una toma de b-roll lo necesita.
   • detail: qué preparar (qué proyecto abrir, qué tener en ejecución, qué limpiar de la pantalla primero).

5. Escribe storyboard.json en una carpeta storyboard/<video-slug>/ en el directorio de trabajo del usuario (pregunta si hay un lugar mejor):

   {
     "title": "AI edits my videos",
     "target_seconds": 50,
     "shots": [
       {"type": "face", "vo": "My last couple of videos were all edited by Claude.",
        "on_screen_text": "CLAUDE EDITS MY VIDEOS", "edit_note": "Mid shot, headline holds 4s.",
        "sfx": "", "thesis": false, "status": "to-capture"}
     ],
     "sittings": [
       {"label": "Face", "detail": "Same shirt and light for every face line.", "shots": [1]}
     ]
   }
   

6. Construye un fotograma para cada toma (siguiente sección) como frames/f01.html, frames/f02.html, y así sucesivamente. El número es la posición de la toma.

7. Renderiza:

   python3 <carpeta de esta habilidad>/kit/render.py storyboard/<video-slug>
   

   Renderiza frames/out/fNN.png a 540x960 con Chrome sin cabeza, un frames/out/contact-sheet.jpg y board.html: cada fotograma junto a su VO, texto, nota de edición, sonido y tiempo, más las sesiones. Imprime el tiempo de duración y los segundos de cara vs pantalla.

8. Revisa la hoja de contactos, luego corrige y vuelve a renderizar: texto sobre una cara, superposiciones, texto en las zonas seguras, cualquier cosa privada.

9. Informa brevemente: número de tomas, duración vs longitud objetivo, segundos de cara vs pantalla y qué queda por capturar. Abre board.html para el usuario.

Fotogramas

Usa la fuente más real que puedas obtener, en este orden:

1. Material real. Una captura de pantalla del sitio o aplicación real que aparece en la toma (Chrome sin cabeza o Playwright, 1440 de ancho para escritorio, 390 para móvil), o un fotograma del propio metraje del usuario (ffmpeg -ss <tiempo> -i clip.mp4 -frames:v 1 still.jpg). Pon las imágenes en la carpeta frames/ y refiérelas por nombre de archivo.

2. Fotogramas construidos. Escribe el fotograma como un fragmento HTML usando las clases en kit/frame-kit.css. {{face}} en un fragmento se convierte en frames/face.jpg si existe, si no en la foto de cara de la configuración, si no en una silueta neutra. El theme.css de la configuración reestiliza automáticamente cada fotograma con sus colores y fuente.

   clase	úsala para
   .f	el contenedor del fotograma, siempre el elemento exterior
   .hl	titular en la parte superior, <em> en una palabra clave
   .lbl con .n + .t	una etiqueta de lista numerada (01 SCRIPT)
   .face	cara a fotograma completo (un <img src="{{face}}">)
   .facebox	el cuadro de cara en una toma split
   .term	una terminal de Claude Code (.p prompt, .tool llamada a herramienta, .ok, .dim)
   .chat + .bub + .vid	un mensaje de chat de agente, opcionalmente con un video
   .shot	una tarjeta de captura de pantalla (<div class="shot"><img src="..."></div>)
   .tbl	una tabla de datos (.h encabezado, .r filas, .r.new una fila nueva)
   .big	un gran remate
   .room	un marcador de posición de b-roll con un pie de foto

   Establece la posición vertical con un style="top:..px" en línea. Ejemplo de fragmento:

   <div class="f">
     <div class="lbl"><span class="n">01</span><span class="t">SCRIPT</span></div>
     <div class="term" style="top:200px">
       <div class="bar"><i></i><i></i><i></i></div>
       <div class="p">write me a 45 second script about ...</div>
       <div class="ok">  ✓ script.md</div>
     </div>
     <div class="facebox"><img src="{{face}}"></div>
   </div>
   

3. Simúlalo con datos reales cuando la pantalla esté detrás de un inicio de sesión al que no puedas acceder. No inicies sesión en nombre del usuario. Construye la pantalla a partir de números reales y márcala como provisional.

Reglas de los fotogramas:

• Zonas seguras: mantén el texto fuera del 20% inferior y del 12% derecho (el carril de me gusta y comentarios), y mantén el 8% superior despejado. Las posiciones del kit ya respetan estas.
• Su estilo de titular: sigue las notas de texto en pantalla del perfil (mayúsculas/minúsculas, peso, cómo resaltan una palabra). El valor predeterminado es mayúsculas pesadas con una palabra clave en <em>. Sobre un fotograma de cara completa, el kit vuelve el tipo blanco con una sombra suave.
• Privacidad: sin rutas de archivo con nombre de usuario, correos electrónicos, claves API o contenido de .env en ningún fotograma. Usa IDs falsos en las tablas.

Usarlo para construir el video

Una vez que el storyboard está aprobado, es el prompt. Construye los gráficos una toma a la vez: "Construye la toma 4 del storyboard como un gráfico en movimiento 9:16: coincide con el fotograma, el texto en pantalla y la nota de edición." La primera versión nunca es correcta; ponlo en la edición, compáralo con el fotograma y ve y vuelve hasta que coincida.