Skill de direção cinematográfica · Claude Code

Suas imagens + narração viram filme — sem IA de vídeo

Um diretor de verdade: vê cada imagem, decide câmera, corte, transição, música e efeitos — e renderiza determinístico via pixflow.

Frame do filme O Pequeno Príncipe: a raposa e o príncipe no capim dourado
O que é

Direção, não geração

A imagem que sai é a sua — o que o Diretor adiciona é cinema: movimento de câmera, ritmo de montagem, profundidade e som. Nada de frames inventados por IA de vídeo.

👁️ Vê cada imagem

Analisa com visão: foto ou desenho, conteúdo, emoção e o ponto de interesse exato onde a câmera deve mirar. Imagens ricas viram 2–4 shots.

🎥 Gramática cinematográfica

18 movimentos de câmera + framing from/to, transições por intenção (corte, whip, dip, crossfade), curva de 3 atos e fim suspenso — regras validadas em A/B.

🔊 Som de cinema

Narração governa o timing; música com ducking automático sob a voz, vento, whooshes e shimmers completam a mixagem num master único.

Como funciona

O fluxo do Diretor

Sete passos, sempre nesta ordem — a decupagem é mostrada para aprovação antes do render.

👁️ VER as imagens 👂 OUVIR a narração 🎬 DECIDIR câmera e cortes 📋 DECUPAGEM (aprovação) 🎚️ TRILHA 🎞️ RENDER (pixflow) ✅ VERIFICAR
Pré-requisitos

O que precisa estar no ar

Tudo local e código aberto. O motor de render é o pixflow v2.3+ (Depth-Anything-V2 + Three.js + Remotion + FFmpeg).

Motor pixflow

Clonar e conferir as dependências do motor de render.

# checar deps do motor
cd ~/projetos/pixflow/skill
node cli/pixflow-motion.mjs check-deps

Node + FFmpeg

Node ≥18 para os scripts e CLI; ffmpeg/ffprobe para áudio e verificação.

node --version   # ≥18
ffmpeg -version

A skill instalada

Symlink no diretório de skills do Claude Code.

ln -s ~/projetos/diretor-animacao/skill/diretor-animacao \
  ~/.claude/skills/diretor-animacao
Guia de uso · passo a passo

Da pasta de imagens ao MP4

O caminho feliz: você entrega o material e aprova a decupagem; a skill dirige e renderiza.

1

Prepare o material

Uma pasta com as imagens (fotos e/ou ilustrações, ideal ≥1920px) e a narração — WAVs por trecho, um WAV único, ou só o texto (a skill gera TTS local).

meu-projeto/
├── img/  s1.png s2.png …      # as imagens, na ordem da história
└── audio/ s1.wav s2.wav …     # narração por trecho (ou narracao.txt)
2

Peça o filme no Claude Code

Aponte a pasta e use um gatilho da skill. Pode pedir música e efeitos junto.

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

Aprove a decupagem

A skill mostra a tabela cena · imagem · beat · movimento · transição · duração antes de renderizar. Ajuste o que quiser (ou diga "direto" para pular a aprovação).

# exemplo de linha da decupagem
c1 · s1 · abertura · pull-out dramático · cut · 6.1s
4

Trilha de fonte única

A narração governa as durações; o montar-trilha compensa os overlaps de transição (nunca calcule starts na mão).

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

Render determinístico

O spec YAML (pixflow.movie/v1) é validado e renderizado pelo motor — mesmo spec, mesmo filme, sempre.

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

Verificação antes da entrega

Brilho frame a frame nas fronteiras (anti-pisca) e inspeção visual de frames-chave — o filme só é entregue conferido.

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

O Pequeno Príncipe — 21 imagens, 2min11

Primeiro filme real da skill: 21 aquarelas + 22 trechos de narração viraram 26 shots com música CC0 (ducking sob a voz), vento de deserto, whooshes e shimmer de estrelas. Decupagem completa e lições →

Abertura: pull-out dramático revela o príncipe no deserto estrelado
Abertura — único movimento dramático do filme: pull-out revela o deserto. O final reusa esta imagem e fecha o círculo.
Jardim de rosas: pull-out revela as centenas de rosas iguais
O jardim de rosas — pull-out revela as centenas de rosas iguais à dele, no caminho do vale contemplativo.
Roadmap

Fases do projeto

Construído por pilotos A/B — cada regra da gramática foi validada com filme renderizado de verdade.

F0–F1 ✓
Motor pixflow v2.3Translação real da moldura, 18 movimentos + framing from/to, anti-fantasma, transições whip/zoom_blur, respiração.
F2 ✓
A skill Diretor + primeiro filme realGramática de direção completa, multi-shot, montar-trilha, música/SFX com ducking — O Pequeno Príncipe entregue.
F3
Upgrade de transiçõesWhip verdadeiro (as duas cenas varrem), push, match-on-motion, flash de luz, dip entre atos.
F4
Eventos de luz e partículasLight-leaks, fog, partículas, hold/speed-ramp, upscale automático para imagens pequenas.