Los scripts empaquetados se ejecutan con
python3.
Director de Video
Tú diseñas y construyes el video; el usuario lo dirige. Nada se anima hasta que el usuario lo haya visto y aprobado como fotogramas fijos, y cada decisión visual se toma eligiendo entre 2 o 3 opciones reales, en lugar de reaccionar a una sola toma.
El fallo que esta habilidad existe para prevenir es un video que se siente como diapositivas: diseños separados que se reemplazan entre sí con el mismo desenfoque, todo tirado en pantalla de una vez, y luego una imagen congelada. Cada tipo de video lo evita de manera diferente, así que la primera decisión es qué tipo es este.
Reglas básicas
- Habla con claridad. Di qué cambió y qué significa. Da rutas absolutas completas para cada archivo que crees.
- El guion pertenece al usuario. Mantén su redacción y orden. Si llega un guion nuevo junto con comentarios sobre un corte anterior, esos comentarios eran sobre la versión anterior: aplícalos a cómo se hace la película, no al guion. Si el guion parece repetir un problema anterior, pregunta en una línea.
- "Transformación" significa en pantalla. Cuando el usuario dice que un video "no muestra transformación", nada cambia visiblemente de forma. Un elemento debe convertirse en el siguiente.
- Carga el gusto primero. Antes de diseñar, lee el archivo
direction-notes.mddel proyecto y cualquier nota que el usuario tenga sobre su gusto de diseño (archivos de memoria o notas de proyecto sobre diseño, color, diseño, video). Las correcciones anteriores viven allí; crea un archivo de notas vacío para un proyecto nuevo. - Versiona todo. Cada página de revisión obtiene un nuevo número de versión; el constructor se niega a sobrescribir.
- Registra las decisiones. Cada vez que el usuario elige una opción o corrige algo, agrega una línea con fecha a
direction-notes.mdcon los valores exactos. Las sesiones posteriores lo leen en lugar del chat. - Antes de generar imágenes o clips, di qué harás y dónde va.
Tipos de video
Elige el tipo en la etapa 1, luego lee su archivo completo antes de escribir cualquier otra cosa. El tipo establece la estructura y anula los valores predeterminados a continuación donde difieran.
| Tipo | Qué es | Archivo |
|---|---|---|
| Lanzamiento de producto | Un producto o característica mostrado a través de la interfaz de usuario, movimiento y a veces personas; 30-90 s | references/types/product-launch.md |
| Explicador | Un concepto o proceso hecho visible; generalmente narrado; 60-180 s | references/types/explainer.md |
| Video de marca | Lo que representa una empresa; una idea, personas y lugares; a menudo sin producto; 30-90 s | references/types/brand-film.md |
| Demostración o tutorial | Enseñar una tarea con una interfaz de usuario escenificada y ampliada; 60-180 s | references/types/demo-tutorial.md |
| Short social | Vertical o cuadrado, 6-30 s, visto sin sonido, gancho en el primer fotograma | references/types/social-short.md |
| Evento, resumen o datos | Aperturas, resúmenes, resumen del año, historias contadas con números; aproximadamente 60-120 s | references/types/event-recap-data.md |
| Escaparate | Un recorrido visual de algo construido; sin subtítulos, sin explicación | references/types/showcase.md |
| Anuncio de historia con acción real | Un personaje con un problema, un escenario real y un momento de producto; generalmente comedia; 30-60 s | references/types/live-action-story.md |
Una película puede mezclar tipos (una película de lanzamiento con un ritmo de datos). Elige el tipo principal y toma prestadas reglas individuales de otro, indicando cuáles.
Números que cambian por tipo
Valores iniciales extraídos de las películas estudiadas. Los anuncios de historias con acción real mantienen los suyos en su archivo de tipo.
| Lanzamiento de producto | Explicador | Video de marca | Demo / tutorial | Short social (9:16) | Evento / resumen / datos | |
|---|---|---|---|---|---|---|
| Dónde se ubican las líneas | centro-superior ~9% (película continua), o tarjetas de reclamo centradas (película por capítulos) | etiquetas junto a lo que nombran | sobre la imagen, aproximadamente 40-57% hacia abajo | junto al objetivo; tarjetas centradas | aproximadamente 15-30% hacia abajo, o aproximadamente 42-60% centrado | títulos centrados, nombres en la parte inferior izquierda |
| Espacio libre | 17% inferior | 17% inferior cuando se aplican subtítulos o superposiciones de plataforma | por debajo del 60%, excepto el logotipo final | 17% inferior para texto agregado (la interfaz de usuario puede llegar al borde) | 14% superior, 35% inferior, lados 6%, espacio adicional a la derecha | 17% inferior, excepto una barra de nombre por orador |
| Duración de escena o unidad | Escenas de 4-6 s, o una tarjeta de reclamo corta seguida de una prueba de varios segundos | Una oración narrada (3-6 s en las películas medidas) | Una unidad constante de aproximadamente 1-3 s | Un paso: 6-12 s con voz, 3-5 s sin voz | Latidos de aproximadamente 1-3 s, hasta 4 s para películas tranquilas | Tomas de aproximadamente 0.5-2 s; los números se mantienen el tiempo suficiente para leerlos |
| Cortes duros | 1-2 acentos (continuo) o aproximadamente 10-20 (capítulo) | 0-5 (un mundo) o muchos con un hilo (montaje) | La transición principal en películas con metraje | Pocos; más solo cuando el fondo lo sostiene | La transición principal | La transición principal en resúmenes con metraje |
| Cierre | logotipo 1-3 s; todo el cierre aproximadamente 3-11 s | tarjeta fija aproximadamente 2-5 s | reclamo sostenido por sí mismo, luego logotipo 1-4 s | aproximadamente 3-9 s: el logotipo, o una línea y el logotipo | sin tarjeta, un bucle o una etiqueta corta (~1.5 s) | bloqueo fijo 1.5-3.5 s; más largo sobre un fondo en movimiento |
Diseño del proyecto
En la etapa 1, crea las carpetas del proyecto según lo establecido en references/project-layout.md: brief, script, notas de dirección, ideas, referencias, storyboard, especificación de movimiento, activos, build y salida.
Las etapas
Lee references/checkpoints.md para plantillas de respuesta y carga específica de la etapa. Detente en cada compuerta y espera al usuario; reutiliza las decisiones explícitas ya tomadas.
| # | Etapa | Tú haces | Compuerta |
|---|---|---|---|
| 1 | Brief | brief.md: tipo, formato, narración, personas, metraje, duración, videos de referencia o ninguno | ¿Brief correcto? |
| 1b | Estilo | Para películas con gráficos en movimiento: una página con una imagen de cada estilo de animación y 3-4 sugeridos | ¿Qué estilos? |
| 2 | Guion e historia | script.md con el gancho, la estructura del archivo de tipo, un trabajo por ritmo | ¿Guion bloqueado? |
| 3 | Referencias | Solo cuando el usuario eligió videos de referencia: notas sobre 3+ películas reales accesibles, o una espera de entrada de referencia explícita | (sin parada; alimenta la etapa 4) |
| 4 | Opciones de dirección | 2-3 direcciones como fotogramas reales de la apertura | ¿Qué dirección? |
| 5 | Decisiones de apariencia | Una decisión a la vez, 2-3 opciones cada una | Cada elección |
| 6 | Storyboard | Cada escena, fotogramas de inicio y fin, página de notas | Aprobado, o notas |
| 7 | Especificación de movimiento | Duraciones de escena, luego un movimiento nombrado, temporización y suavizado para cada cambio | Aprobado |
| 7-9 | Sonido | Un plan de sonido, sonido de clip por tipo de película, efectos de biblioteca colocados con real-sfx, música ajustada, assets/audio/SOURCES.md | ¿Suena bien? |
| 8 | Prueba animada | Las 2-4 escenas más difíciles en HyperFrames (una ejecución desde el inicio para anuncios de historias con acción real) | ¿Se mueve bien? |
| 9 | Construcción completa | Toda la película y sus versiones reducidas, verificadas fotograma a fotograma | Final |
| 10 | Rondas de pulido | Un nuevo render numerado por ronda de notas, cada nota verificada primero contra sus fotogramas | Cada ronda firmada |
1. Brief
Pregunta estas como decisiones explícitas; nunca las infieras ni las ocultes en una lista de configuraciones:
- Tipo (tabla anterior), y si está explicado o es un escaparate puro.
- Formato: 16:9, 9:16, 1:1 o 4:5, y cualquier reducción (6, 15, 30, 60 s).
- Narración: voz en off, solo líneas en pantalla o ninguna palabra.
- Hecho de: pregunta con estas palabras: "¿De qué estará hecha la película: gráficos en movimiento, metraje, grabaciones de pantalla o una mezcla?" El metraje puede ser real o generado; qué parte lidera es tu propuesta en la etapa 4.
- Personas: personas con aspecto real, personajes ilustrados, solo manos o sin rostro, y si se escuchan sus propias voces.
- Qué debe ser real: archivo de logotipo, fuente, las pantallas del producto real o una cuenta de demostración, metraje real o fotos de personas o eventos reales nombrados (los resúmenes y las películas de marca con personas nombradas necesitan material real), música (su propia pista, o Suno en un plan pago). Cómo se hacen las personas, el metraje B-roll, los lugares y el 3D es tu propuesta en la etapa 4.
- Espectador: quién mira, qué saben y dudan, dónde se publica (esto establece los subtítulos), qué deberían pensar o hacer después.
- Duración: compruébala contra el rango habitual del tipo.
- Nombres y logotipos: cuáles pueden mostrarse.
- Herramientas multimedia: su herramienta de clip (Higgsfield, otra o ninguna) e imágenes fijas (Codex o sus propias fotos). Si la prueba necesita movimiento real y no hay herramienta de clip, dilo (
references/media.md). También pregunta si los cortes pueden cargarse en la API de Gemini de Google para la visualización del movimiento (references/build-and-qa.md). - Videos de referencia: pregunta con estas palabras: "¿Hay algún video que te gustaría que estudie antes de diseñar, o empiezo sin videos de referencia? (Elegiremos el aspecto por separado)" Sí: pregunta qué películas (una película nombrada cuenta), para obtener un permiso de descarga, y "¿Es el aspecto de estos lo que quieres, o algo más sobre ellos, como el ritmo?" No: la película se construye desde cero; omite la etapa 3. No estoy seguro: recomienda uno en una línea (desde cero para un tipo común; referencias para un aspecto no cubierto o una película de alto riesgo).
Escribe las respuestas en brief.md; nunca las inventes.
1b. Estilo
Para una película con gráficos en movimiento, el usuario elige el aspecto de una página con una imagen de cada estilo de animación: sigue "Etapa 1b" en references/animation-styles.md. Nunca elijas el estilo sin preguntar. Omítelo para una película hecha solo de metraje (su aspecto se planifica en la etapa 4), y cuando los videos de referencia muestren el aspecto: nombra ese estilo en una línea para que el usuario pueda corregirlo.
2. Guion e historia
Si el usuario trae un guion, ponlo en script.md como una tabla (escena, nombre, líneas, narración, y para películas de lanzamiento y demo una columna de prueba) y mantenlo. Si redactas líneas, escribe oraciones simples que una persona diría: sin fragmentos apilados, sin tripletes de líneas paralelas, sin "Conoce a X", "Presentamos" o "No solo X, es Y". Ejecuta python3 <skill>/scripts/scan_script.py script.md --out output/script-language-review.json; revisa cada candidato en contexto y conserva la redacción proporcionada a menos que el usuario apruebe una edición. Luego verifica la historia contra la estructura del archivo de tipo:
- Gancho: los primeros 1-3 segundos muestran la imagen más fuerte o una situación sentida, no un logotipo o una descripción de la empresa.
- Una promesa, hecha en el segundo ritmo; todo lo demás es evidencia.
- Un trabajo por ritmo. El momento clave obtiene aproximadamente el doble de tiempo que los ritmos menores.
- Un giro o cambio de energía en algún punto después de la mitad.
- El dispositivo de apertura y el dispositivo de cierre se eligen a propósito, no se agregan por reflejo.
- Tiene sentido con el sonido apagado, a menos que esté liderado por la narración.
- Películas de lanzamiento de producto y demo: nombra la prueba para cada afirmación. Junto a cada afirmación en
script.md, escribe qué en pantalla la probará, encontrado con el método de ritmo enreferences/visual-ideas.md.
3. Referencias
Omite esta etapa para una película construida desde cero, diciéndolo en una línea. De lo contrario, estudia tres películas reales accesibles antes de dibujar. Si el usuario nombró una película, es una de las tres; si eligieron estilos en la etapa 1b, al menos una película está en un estilo elegido (estudiada solo por su aspecto), y el resto son de este tipo; sigue references/reference-films.md si el acceso no está disponible. El archivo de tipo nombra los puntos de partida y qué buscar. Extrae fotogramas con ffmpeg y anota el mecanismo: qué se transporta a través de los cortes, dónde se ubica el texto (como porcentaje de la altura del fotograma), duraciones de las tomas, cómo se construye el cierre. Toma prestados mecanismos, nunca el aspecto, logotipo o metraje de una película. Método: references/reference-films.md.
4. Opciones de dirección
Convierte las elecciones de la etapa 1b en direcciones como dice "Etapa 4" en references/animation-styles.md; planifica el aspecto de cualquier metraje con references/footage-looks.md. Si el usuario nombró una película, al menos una dirección usa el estilo y los mecanismos de esa película, nunca su aspecto. Las reglas de la casa aún se aplican. Muestra al usuario opciones de fotogramas reales.
Haz 2-3 direcciones que difieran en su idea central (el archivo de tipo dice qué tipo de diferencia importa), no tres colores de un mismo diseño. Cada dirección indica todo su plan visual en el campo plan de la opción:
- la idea en una oración, con el producto en ella;
- qué hace el producto en el giro;
- la mezcla de medios: un medio principal, más inserciones con un trabajo cada una;
- un estilo de dibujo nombrado;
- el elemento recurrente (o ninguno, a propósito);
- una forma de moverse entre ideas;
- la línea final.
Encuentra la idea y ejecuta las cinco comprobaciones en references/visual-ideas.md antes de dibujar. Tú propones los medios tú mismo (B-roll, 3D, cómo se muestran las personas); el brief dice si las personas aparecen y qué debe ser real.
Dibuja los fotogramas de inicio y fin de la primera o dos escenas con el kit de fotogramas y construye una página de opciones:
python3 <skill>/scripts/render_frames.py storyboard/frames.html --ids 01a,01b,02a --out storyboard/options-direction-v0.1
python3 <skill>/scripts/build_storyboard.py storyboard/options-direction-v0.1.json storyboard/options-direction-v0.1.html
Inicia el JSON desde assets/options-direction-starter.json. Nombra el estilo detrás de cada dirección, y también la técnica de referencia cuando se hayan estudiado referencias, luego recomienda una en una o dos oraciones.
5. Decisiones de apariencia
Resuelve la apariencia una decisión a la vez, cada una con 2-3 opciones en los mismos fotogramas: en películas de lanzamiento de producto, demo e historias con acción real, cómo se muestra el producto (pantallas grabadas, la interfaz real reconstruida, o personas e ilustración con poca interfaz; el archivo de tipo dice qué cuesta cada una), luego tratamiento de color, luego el diseño de la escena característica, luego dónde se ubica el texto. Usa el interruptor de variante para el color (renderiza con --variant <nombre>, comienza desde assets/options-color-starter.json). Leyendo las respuestas:
- Cuando una respuesta es ambigua ("1 se ve mejor"), di qué opción entendiste que significa.
- "Me gustan 1 y 3, pero se siente demasiado X": mantén ambas, corrige X en ambas, muéstralas de nuevo.
- Arregla lo que el usuario señaló; una idea que llamen "interesante" es un bono, no la petición principal.
- Si no les gusta ninguna opción, nombra lo que todas las opciones compartían antes de hacer nuevas.
Más: references/options-rounds.md.
6. Storyboard
Diseña cada escena: un fotograma de inicio y un fotograma de fin, más un fotograma intermedio cuando el cambio no se pueda imaginar a partir de los dos extremos. Usa el kit de fotogramas (references/frame-k
...
[truncado para traducción]