PTENES
Skill de dirección cinematográfica · Claude Code

Tus imágenes + narración se convierten en película — sin IA de video

Un director de verdad: ve cada imagen, decide la cámara, los cortes, la transición, la música y los efectos, y renderiza de forma determinista mediante pixflow.

Fotograma de la película El principito: el zorro y el príncipe en la hierba dorada
Qué es

Dirección, no generación

La imagen que sale es tuya — lo que añade el Director es cine: movimiento de cámara, ritmo de montaje, profundidad y sonido. Nada de fotogramas inventados por IA de video.

👁️ Ve cada imagen

Analiza con visión: foto o dibujo, contenido, emoción y el punto de interés exacto hacia donde debe apuntar la cámara. Las imágenes ricas se convierten en 2–4 shots.

🎥 Gramática cinematográfica

18 movimientos de cámara + encuadre from/to, transiciones según la intención (corte, whip, dip, crossfade), curva de 3 actos y final en suspenso — reglas validadas en A/B.

🔊 Sonido de cine

La narración determina el timing; la música con ducking automático bajo la voz, el viento, los whooshes y los shimmers completan la mezcla en un único master.

Cómo funciona

El flujo del Director

Siete pasos, siempre en este orden: el desglose se muestra para su aprobación antes del render.

👁️ VER las imágenes→ 👂 ESCUCHAR la narración→ 🎬 DECIDIR cámara y cortes→ 📋 DESGLOSE (aprobación)→ 🎚️ PISTA→ 🎞️ RENDER (pixflow)→ ✅ VERIFICAR
Requisitos previos

Qué debe estar en el aire

Todo local y de código abierto. El motor de render es pixflow v2.3+ (Depth-Anything-V2 + Three.js + Remotion + FFmpeg).

Motor pixflow

Clona y comprueba las dependencias del motor de render.

# comprobar las dependencias del motor
cd ~/projetos/pixflow/skill
node cli/pixflow-motion.mjs check-deps

Node + FFmpeg

Node ≥18 para los scripts y la CLI; ffmpeg/ffprobe para audio y verificación.

node --version   # ≥18
ffmpeg -version

La skill instalada

Symlink en el directorio de skills de Claude Code.

ln -s ~/projetos/diretor-animacao/skill/diretor-animacao \
  ~/.claude/skills/diretor-animacao
Guía de uso · paso a paso

De la carpeta de imágenes al MP4

El camino feliz: entregas el material y apruebas la planificación de tomas; la skill dirige y renderiza.

1

Prepara el material

Una carpeta con las imágenes (fotos y/o ilustraciones, idealmente ≥1920px) y la narración: WAVs por fragmento, un único WAV o solo el texto (la skill genera TTS local).

meu-projeto/
├── img/  s1.png s2.png …      # las imágenes, en el orden de la historia
└── audio/ s1.wav s2.wav …     # narración por segmento (o narracao.txt)
2

Pide la película en Claude Code

Indica la carpeta y usa un disparador de la skill. Puedes pedir música y efectos también.

"~/meu-projeto — vira filme, impactante, com música e efeitos de som"
3

Aprueba la planificación de tomas

La skill muestra la tabla escena · imagen · beat · movimiento · transición · duración antes de renderizar. Ajusta lo que quieras (o di "directo" para omitir la aprobación).

# ejemplo de una línea de la planificación de tomas
c1 · s1 · abertura · pull-out dramático · cut · 6.1s
4

Pista de fuente única

La narración determina las duraciones; el montar-trilha compensa los solapamientos de transición (nunca calcules los starts a mano).

node scripts/montar-trilha.mjs decupagem.json narracao.wav
5

Render determinista

El spec YAML (pixflow.movie/v1) es validado y renderizado por el motor: el mismo spec, la misma película, siempre.

node cli/pixflow-motion.mjs validate filme.movie.yaml
node cli/pixflow-motion.mjs render filme.movie.yaml filme.mp4
6

Verificación antes de la entrega

Brillo fotograma a fotograma en los límites (anti-parpadeo) e inspección visual de fotogramas clave — la película solo se entrega después de revisarla.

ffmpeg -ss 6.0 -i filme.mp4 -frames:v 12 \
  -vf "signalstats,metadata=mode=print:key=lavfi.signalstats.YAVG" -f null -
Ejemplos

El principito — 21 imágenes, 2min11

La primera película real de la skill: 21 acuarelas + 22 fragmentos de narración se convirtieron en 26 shots con música CC0 (ducking bajo la voz), viento del desierto, whooshes y brillo de estrellas. Planificación completa de tomas y aprendizajes →

Apertura: pull-out dramático que revela al príncipe en el desierto estrellado
Apertura — único movimiento dramático de la película: pull-out que revela el desierto. El final reutiliza esta imagen y cierra el círculo.
Jardín de rosas: pull-out que revela los cientos de rosas iguales
El jardín de rosas — pull-out que revela los cientos de rosas iguales a la suya, en el camino del valle contemplativo.
Hoja de ruta

Fases del proyecto

Creado a partir de pilotos A/B — cada regla de la gramática se validó con una película realmente renderizada.

F0–F1 ✓
Motor pixflow v2.3Traslación real del encuadre, 18 movimientos + framing from/to, anti-fantasma, transiciones whip/zoom_blur, respiración.
F2 ✓
La skill Diretor + la primera película realGramática de dirección completa, multi-shot, montar-trilha, música/SFX con ducking — El principito entregado.
F3
Mejora de transicionesWhip verdadero (ambas escenas se desplazan), push, match-on-motion, destello de luz, dip entre actos.
F4
Eventos de luz y partículasLight-leaks, fog, partículas, hold/speed-ramp, upscale automático para imágenes pequeñas.