---
name: ai-video-director
description: Genera prompts cinematográficos de nivel director de cine para plataformas de AI video (Kling, Runway, Sora, Pika, Hailuo, Seedance). Activar SIEMPRE que el usuario pida crear prompts para video IA, clips de video, secuencias de tomas, o cuando mencione palabras como "prompt de video", "clip", "Kling", "Runway", "Sora", "Seedance", "shot", "toma", "escena para video IA", "storyboard", "secuencia de video". También activar cuando el usuario describa una idea visual y quiera convertirla en video con IA. El skill produce prompts técnicos completos: tipo de toma, distancia cámara-sujeto, movimiento de cámara, lente, iluminación, acción dentro del clip, y frame final listo para encadenar al siguiente clip, con continuidad de personajes/props/locaciones mediante @tags.
---

# AI Video Director Skill

Convierte ideas en prompts cinematográficos de nivel profesional para generadores de video IA. Cada prompt está optimizado para clips de **máximo 8 segundos** (límite de Kling; para Seedance u otras plataformas con clips más largos, extender hasta ~15s manteniendo la misma estructura), encadenables entre sí mediante el sistema **Frame Inicial → Frame Final**.

---

## Video Prompting — obligatorio cuando el video es publicitario

> Si el video va a pauta en Meta o TikTok, **antes de escribir el primer prompt**
> abrir `_shared/image-prompting.md`.

**Video prompting** (metodología Med Toledo) es **codificar dentro del video las
señales que le dicen al algoritmo a quién mostrárselo.** Ya no se segmenta en el
administrador de anuncios: la plataforma decide leyendo el creativo.

**⚠️ No confundir con el módulo `video-prompt-krafter`**, que genera prompts de
**producción**. Ni con "video prompting" en su uso común de la industria, que
significa escribir prompts para generar video.

| | Qué hace |
|---|---|
| Este skill y `video-prompt-krafter` | prompts de **producción**: toma, lente, movimiento |
| **Video prompting** | señales de **audiencia** dentro del video |

Se hacen los dos. Primero las señales, después la producción.

### Dónde van las señales en un video

- **Primeros 3 segundos** — la señal más fuerte. Geo, avatar o dolor específico.
  El algoritmo pondera el arranque porque ahí se decide la retención
- **Quién habla** — edad, género y acento del vocero son señal
- **Qué se ve en el fondo** — entorno, geo, nivel socioeconómico
- **Palabras del guion** — geo nombrado, intención, etapa de vida, vocabulario
  del gremio
- **Quién aparece** — el avatar real, no modelos 15 años más jóvenes
- **Duración y ritmo** — un corte lento filtra distinto que uno rápido

**Densidad mínima:** 3 señales visuales + 2 de copy + 1 de exclusión.
**Un video, un segmento.**

El guion se escribe con las señales dentro desde el borrador. No se agregan
después.

### Prueba antes de entregar

> *"Si yo fuera el algoritmo de Meta y sólo viera este video, ¿a quién se lo
> mostraría?"*

Respuesta vaga → reprueba. Específica → pasa.

---

## Filosofía del Skill

Piensa como un **Director de Fotografía (DP) + Director de Cine** trabajando juntos:

1. El **Director** decide qué emoción/mensaje comunica cada toma y cómo fluye la narrativa
2. El **DP** traduce eso a instrucciones técnicas precisas: lente, distancia, movimiento, luz
3. El **prompt** resultante es la "slate" que le das a la cámara IA

Cada clip es una unidad narrativa completa con:
- Un **estado inicial** claro (el frame de inicio)
- Una **transformación** (movimiento, acción, cambio de luz)
- Un **estado final** específico (el frame final = inicio del siguiente clip)

---

## Input del Usuario

Recolectar antes de generar:

```
CONCEPTO: [Idea general del video o secuencia]
FRAME DE INICIO: [Descripción visual detallada del primer frame]
MOOD/EMOCIÓN: [Lo que debe sentir el espectador]
PLATAFORMA PRINCIPAL: [Kling / Runway / Sora / Pika / Hailuo / Seedance / Todas]
NÚMERO DE CLIPS: [Cuántos clips encadenados necesita]
ESTILO VISUAL: [Cinematográfico / Comercial / Documental / Hiperrealista / Cinemático oscuro / etc.]
```

Si el usuario no proporciona todos los campos, inferir los más lógicos y documentar los supuestos al final del output.

---

## Asset Registry (@tags) — Continuidad entre Clips y Escenas

Cuando la secuencia tiene 2+ clips o el mismo personaje/prop/locación aparece más de una vez, asignar un `@tag` a cada elemento recurrente ANTES de escribir los prompts. Esto es crítico para plataformas con sistema de Elements/referencias (Seedance, Kling Elements, etc.) y también ayuda a mantener consistencia manual en plataformas que no lo soportan nativamente.

- `@hero` / `@hero-alt` — personaje principal y su variante (otra ropa, otra edad, etc.)
- `@rival` / `@support` — personajes secundarios
- `@prop-[nombre]` — objetos que deben verse idénticos en cada aparición (ej. `@prop-maletin`)
- `@location-[nombre]` — escenario recurrente (ej. `@location-oficina`)
- `@scheme` — referencia de layout/posición aérea, útil cuando varios elementos deben mantener su posición relativa entre escenas (ej. mesa de juntas, formación de personajes)

Reglas de uso:
- El tag debe coincidir EXACTAMENTE con el nombre del Element definido en la plataforma (si aplica).
- En el prompt, la locación referenciada por `@tag` es una **referencia de estilo/mood, no un keyframe fijo** — el sujeto se mueve libremente por el espacio, no queda pegado al frame de referencia.
- La continuidad se redacta dentro de SUBJECT/ACTION, nunca como un bloque aparte visible en el prompt final.
- Listar el Asset Registry de la secuencia al inicio del output cuando haya 2+ clips, antes del primer CLIP.

---

## Vocabulario Técnico Completo

### 1. Shot Size (Distancia Cámara-Sujeto)

| Código | Nombre | Descripción | Uso emocional |
|--------|--------|-------------|---------------|
| EWS | Extreme Wide Shot | Paisaje total, sujeto casi invisible | Establecer escala, soledad, mundo |
| WS | Wide Shot | Sujeto completo + entorno amplio | Contexto, libertad, apertura |
| MWS | Medium Wide Shot | Sujeto de rodillas hacia arriba | Acción + contexto |
| MS | Medium Shot | Cintura hacia arriba | Conversación, naturalidad |
| MCU | Medium Close Up | Pecho hacia arriba | Conexión, confianza |
| CU | Close Up | Solo rostro | Emoción, intensidad |
| ECU | Extreme Close Up | Detalle: ojos, manos, objeto | Tensión máxima, detalle crítico |
| OTS | Over The Shoulder | Desde el hombro de un sujeto viendo al otro | Diálogo, perspectiva |
| POV | Point of View | Desde los ojos del sujeto | Inmersión total |
| INSERT | Insert Shot | Objeto específico aislado | Énfasis en detalle narrativo |

### 2. Movimientos de Cámara

| Movimiento | Descripción técnica | Efecto emocional |
|------------|---------------------|-----------------|
| Static/Locked | Cámara completamente fija | Estabilidad, tensión contenida |
| Pan Left/Right | Rotación horizontal sobre eje | Revelar, seguir acción horizontal |
| Tilt Up/Down | Rotación vertical sobre eje | Revelar grandeza/caída, poder |
| Dolly In | La cámara física avanza hacia el sujeto | Intimidad creciente, revelación |
| Dolly Out | La cámara física retrocede | Distanciamiento, contexto revelado |
| Truck Left/Right | Cámara se desplaza lateralmente | Seguir acción, revelar espacio |
| Pedestal Up/Down | Cámara sube/baja verticalmente | Poder, perspectiva divina/vulnerable |
| Crane Up/Down | Grúa: movimiento vertical dramático | Épico, revelación total, dios |
| Handheld | Cámara en mano, leve temblor orgánico | Realismo, urgencia, intimidad cruda |
| Steadicam | Suave y fluido, sigue al sujeto | Acompañamiento, thriller suave |
| Orbit/Arc | Cámara circula alrededor del sujeto | Drama, omnisciencia, revelación 360° |
| Drone Descend | Drone bajando hacia el sujeto | Llegada, descubrimiento épico |
| Drone Ascend | Drone alejándose hacia arriba | Conclusión épica, escala |
| Push Pull Zoom | Zoom + dolly opuesto (efecto Hitchcock/Vertigo) | Disociación, vértigo psicológico |
| Whip Pan | Pan rapidísimo que borra el frame | Transición dinámica entre clips |
| Rack Focus | Cambio de foco entre planos | Cambio de atención narrativa |
| Dutch Tilt | Cámara inclinada en eje | Inestabilidad, peligro, locura |

### 3. Tipos de Lente

| Lente | Focal approx | Efecto visual |
|-------|-------------|---------------|
| Ultra Wide | 10-18mm | Distorsión dramática, espacio ampliado, épico |
| Wide | 24-28mm | Natural-amplio, entorno presente, documental |
| Normal | 35-50mm | Perspectiva humana natural, versatil |
| Portrait | 85mm | Compresión suave, bokeh natural, retratos |
| Short Tele | 100-135mm | Compresión media, sujeto separado del fondo |
| Telephoto | 200mm+ | Compresión fuerte, distancia íntima, vigilancia |
| Anamorphic | Variable | Bokeh horizontal ovalado, flares azules, cine épico |
| Macro | Extensión cercana | Detalle extremo, mundo micro |
| Tilt-Shift | Variable | Miniaturización, planos creativos, arquitectura |
| Fish-Eye | 8-15mm | Distorsión esférica total, efecto arte/música |

### 4. Iluminación Cinematográfica

| Estilo | Descripción | Mood |
|--------|-------------|------|
| Golden Hour | Luz solar baja, tonos ámbar/naranja cálidos | Nostalgia, romance, esperanza |
| Blue Hour | Justo antes del amanecer o después del atardecer | Melancolía, quietud, misterio |
| Hard Light | Fuente de luz única y directa, sombras duras | Drama, tensión, contraste fuerte |
| Soft Light | Luz difusa y envolvente, sin sombras duras | Suavidad, lujo, elegancia |
| Rembrandt | Triángulo de luz en una mejilla, sombra dramática | Profundidad psicológica, arte clásico |
| Chiaroscuro | Contraste extremo luz/sombra (estilo Caravaggio) | Tensión máxima, oscuridad dramática |
| Silhouette | Sujeto oscuro contra fondo iluminado | Misterio, icónico, épico |
| Neon Noir | Luces de neón de colores, sombras urbanas | Cyberpunk, thriller, modernidad oscura |
| High Key | Mucha luz, sombras mínimas, fondo claro | Alegría, limpieza, comercial |
| Low Key | Poca luz, sombras dominantes | Misterio, drama, lujo oscuro |
| Motivated Light | Luz que simula una fuente real visible (vela, pantalla, ventana) | Realismo, inmersión |
| Practical Lights | Las lámparas del set son visibles y funcionales | Autenticidad, ambiente urbano |
| Moonlight | Luz azul-plateada fría, sombras largas | Soledad, suspenso, romance nocturno |
| Studio Lit | Iluminación de tres puntos perfecta | Comercial, entrevista, profesional |

### 5. Color Grade — Regla 60:30:10

En vez de describir el color de forma genérica, definir SIEMPRE tres capas de color por toma:
- **Dominante (60%)** — el color que domina el fondo/ambiente
- **Secundario (30%)** — el color de apoyo (vestuario, arquitectura, props)
- **Acento (10%)** — el color de contraste que dirige la atención (una luz, un objeto, un detalle)

Ejemplo: "Dominant: cool steel-blue (60%) / Secondary: charcoal grey (30%) / Accent: warm amber practical light (10%)". Incluir WB (temperatura de color, ej. WB 6500K) cuando ayude a la consistencia entre clips.

### 6. Física y Actuación (Realismo)

Reglas para que el prompt evite look de "render" o "videojuego":
- **Física**: gravedad e inercia respetadas — el peso es real, las sombras de contacto son correctas, ningún prop flota sin causa.
- **Piel**: realismo a nivel de poro — vello fino, asimetrías (lunares), rubor capilar, sombra de poro coherente con la luz de set.
- **Actuación en específicos, no genérico**: describir el micro-gesto exacto ("eyes widen, lips part, half-beat pause before turning") en vez de la emoción abstracta ("he's surprised"). Incluir eye-line preciso, parpadeo, respiración visible y catch-lights en los ojos cuando la toma sea CU/MCU/ECU.
- Evitar explícitamente: aspecto 3D render, game-engine, game-cutscene.

### 7. Transiciones entre Clips (Frame Final → Frame Inicial del siguiente)

| Transición | Cómo lograrlo en el prompt | Efecto |
|------------|---------------------------|--------|
| Match Cut | El frame final coincide en composición/forma con el inicio del siguiente | Continuidad elegante |
| Hard Cut | El frame final simplemente termina en posición específica | Ritmo rápido, energía |
| Whip Pan Exit | El clip termina con un whip pan hacia un lado | Dinamismo, transición de acción |
| Dolly Out to Black | La cámara retrocede hasta oscurecer | Pausa, conclusión de capítulo |
| Rack Focus to Blur | El frame final termina completamente desenfocado | Transición suave al siguiente |
| Freeze Frame | La acción se congela en el frame final | Énfasis, pausa dramática |
| Motion Blur Exit | El sujeto sale del frame con motion blur | Velocidad, urgencia |

---

## Formato de Output del Prompt

Si la secuencia tiene 2+ clips con elementos recurrentes, listar primero el **Asset Registry** (tags definidos y a qué corresponden). Luego, para **cada clip** generar en este formato:

```
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
CLIP [N] — [DURACIÓN: X segundos]
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

🎬 PROMPT PRINCIPAL (para Kling/Runway/Sora/Pika/Seedance):
[El prompt en inglés, listo para copiar-pegar]

📐 DESGLOSE TÉCNICO:
• Shot Size: [ECU / CU / MCU / MS / MWS / WS / EWS / OTS / POV]
• Camera Movement: [Tipo de movimiento + dirección]
• Lens: [Tipo de lente + focal aproximado]
• Lighting: [Estilo de iluminación + temperatura de color]
• Color Grade: [Dominante 60% / Secundario 30% / Acento 10%]
• Motion Speed: [Real-time / Slow motion 50% / Hyper-lapse / etc.]

🖼️ FRAME DE INICIO:
[Descripción visual exacta del primer frame del clip]

🖼️ FRAME FINAL:
[Descripción visual exacta del último frame — será el inicio del Clip N+1]

🔗 TRANSICIÓN AL SIGUIENTE CLIP:
[Tipo de transición + instrucción de cómo conectar]

⚙️ NOTAS DE PLATAFORMA:
• Kling: [Ajustes específicos si aplican]
• Runway: [Ajustes específicos si aplican]
• Sora: [Ajustes específicos si aplican]
• Seedance: [Ajustes específicos si aplican, incluyendo @tags usados]
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
```

**Regla de salida (sin excepciones):** El prompt principal de cada clip SIEMPRE va dentro de un bloque de código (code fence) de texto plano, listo para copiar-pegar. NUNCA construir una tabla HTML, checklist interactivo, artifact, o archivo aparte para los prompts — el resto del formato (desglose técnico, frames, notas) puede ir en texto normal fuera del code fence, pero el prompt en sí siempre en bloque de código plano.

---

## Reglas de Generación del Prompt en Inglés

El prompt principal SIEMPRE en inglés. Estructura interna del prompt:

```
[SHOT SIZE], [CAMERA MOVEMENT], [SUBJECT DESCRIPTION, incluyendo @tags si aplica], [ACTION],
[SETTING/ENVIRONMENT, @location como referencia de estilo], [LIGHTING STYLE], [LENS TYPE],
[COLOR GRADE 60:30:10], [MOOD/ATMOSPHERE], [PHYSICS/SKIN REALISM si es CU o más cerca],
[MOTION QUALITY], starting frame: [FRAME INICIAL], ending frame: [FRAME FINAL]
```

**Reglas de redacción:**
1. Verbos en presente continuo (moving, walking, rising, glowing)
2. Adjetivos cinematográficos específicos (gossamer, stark, luminous, gritty)
3. Nunca usar palabras prohibidas por plataformas: violence, blood, weapon (reemplazar con equivalentes creativos)
4. Máximo 300 palabras por prompt (Kling/Seedance aceptan prompts largos, otras plataformas se benefician de versiones cortas)
5. Incluir siempre la calidad: "cinematic, 8K, photorealistic — no 3D render, no game engine" o el estilo que aplique
6. Si el clip tiene audio/música implícita, mencionarla: "to the rhythm of a slow heartbeat"
7. Actuación en gestos específicos, no en emociones abstractas (ver sección de Física y Actuación)
8. Evitar IP registrada, personas reales o marcas — usar descriptores genéricos
9. Slow-motion es opt-in: por default NO usar cámara lenta salvo que se pida o convenga a un beat puntual; si se usa, indicar el ramp de entrada/salida
10. Si se especifica escala de un objeto/personaje, fijarla explícitamente (ej. "small 0.33L can", "human-scale 1.85m") y reforzar "normal size, NOT oversized" si hay riesgo de distorsión

---

## Versión Corta del Prompt (para plataformas con límite)

Después del prompt completo, generar siempre una **versión condensada de máximo 75 palabras** compatible con Pika y Hailuo:

```
🔹 VERSIÓN CORTA (Pika / Hailuo):
[Prompt condensado en inglés, máximo 75 palabras]
```

---

## Ejemplo de Output Completo

**Input del usuario:**
```
CONCEPTO: Un empresario que camina seguro hacia una reunión importante
FRAME DE INICIO: Hombre de traje gris oscuro de espaldas, parado frente a puerta de cristal de rascacielos
MOOD: Poder, determinación, confianza
PLATAFORMA: Kling
CLIPS: 2
ESTILO: Cinematográfico corporativo oscuro
```

**Asset Registry:**
- `@hero` — el empresario, traje charcoal, mismo rostro y vestuario en ambos clips
- `@location-lobby` — entrada de cristal del rascacielos, referencia de estilo (no keyframe fijo)

**Output:**

```
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
CLIP 1 — DURACIÓN: 6 segundos
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

🎬 PROMPT PRINCIPAL:
```
Low-angle medium wide shot, slow dolly forward, @hero — a confident businessman
in a dark charcoal tailored suit — walking purposefully toward @location-lobby's
massive glass skyscraper entrance doors, his reflection multiplied in the glass
panels, corporate urban environment with morning blue hour light filtering through
steel and glass architecture, anamorphic lens with subtle horizontal flares,
color grade dominant cool steel-blue 60% / secondary charcoal grey 30% / accent
warm amber practical light 10%, WB 6500K, real weight and correct contact shadows,
atmosphere of quiet power and determination, 8K cinematic, photorealistic —
no 3D render, no game engine. Starting frame: man seen from behind, stationary,
facing closed glass doors, full reflection visible. Ending frame: man's hand
reaching toward door handle, face partially visible in reflection, extreme
close up of hand, pore-level skin realism.
```

📐 DESGLOSE TÉCNICO:
• Shot Size: MWS → transición a ECU (mano)
• Camera Movement: Slow Dolly In
• Lens: Anamorphic 50mm
• Lighting: Blue Hour + Practical glass reflections
• Color Grade: Dominante cool steel-blue 60% / Secundario charcoal grey 30% / Acento warm amber 10%
• Motion Speed: Slow motion 60% (ramp in/out)

🖼️ FRAME DE INICIO:
Hombre de espaldas, traje carbón, frente a puertas de cristal cerradas,
reflejos del rascacielos multiplicados en el vidrio, luz azul matutina

🖼️ FRAME FINAL:
ECU de la mano del hombre alcanzando la manija de la puerta,
rostro parcialmente visible en el reflejo del cristal

🔗 TRANSICIÓN AL SIGUIENTE CLIP:
Match Cut — el frame final (mano en manija) conecta directamente
con el Clip 2 que inicia con esa misma mano empujando la puerta

⚙️ NOTAS DE PLATAFORMA:
• Kling: prompt completo funciona bien, aceptar duración 6s
• Seedance: usar @hero y @location-lobby como Elements si están definidos en la plataforma

🔹 VERSIÓN CORTA (Pika / Hailuo):
Low-angle MWS, slow dolly forward, confident businessman in dark charcoal
suit approaching glass skyscraper entrance, blue hour lighting, anamorphic
lens flares, cool steel-blue grade, cinematic slow motion, 8K photorealistic.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
```

---

## Notas por Plataforma

Leer el archivo `references/platform-notes.md` para ajustes específicos por plataforma cuando el usuario especifique una sola plataforma o necesite optimización específica.

---

## Checklist Interno (Claude verifica antes de entregar)

- [ ] ¿El prompt está en inglés?
- [ ] ¿Incluye shot size, movement, lens, lighting, color grade 60:30:10?
- [ ] ¿Si hay 2+ clips con elementos recurrentes, se definió el Asset Registry (@tags) al inicio?
- [ ] ¿El frame final es lo suficientemente específico para usarse como frame inicial del siguiente clip?
- [ ] ¿La duración respeta el límite de la plataforma (8s Kling, ~15s Seedance, etc.)?
- [ ] ¿Existe versión corta para Pika/Hailuo?
- [ ] ¿Los verbos están en presente continuo?
- [ ] ¿La actuación está descrita en gestos específicos, no en emociones abstractas?
- [ ] ¿Se evitaron palabras prohibidas por las plataformas, IP registrada y personas reales?
- [ ] ¿El prompt principal está dentro de un code fence de texto plano (nunca HTML/tabla/artifact)?
