O Diretor de Animação analisa cada imagem com visão, segmenta a narração em beats e decide câmera, duração, transição e parallax por imagem. Render via pixflow, sem IA generativa de vídeo.
# instalar a skill (symlink) e checar dependências ln -s $(pwd)/skill/diretor-animacao ~/.claude/skills/diretor-animacao cd ~/projetos/pixflow/skill node cli/pixflow-motion.mjs check-deps
Você entrega imagens prontas (fotos reais e/ou ilustrações) e a narração (áudio ou texto). A skill dirige o material seguindo gramática cinematográfica e entrega um MP4 — sem gerar vídeo com IA.
Visão lê cada imagem: tipo, conteúdo, emoção e ponto de interesse at:[x,y]. Foto real ganha parallax 2.5D pleno; desenho fica com parallax 0 (regra validada por A/B).
18 movimentos de câmera (crane, aerial, dolly zoom, whip pan) + framing from/to, com regras de alternância, amplitude (≤2 dramáticos seguidos) e fim suspenso no plano mais calmo.
O motor pixflow v2.3+ rende parallax, transições e looks a partir de um spec YAML pixflow.movie/v1. Mesmo spec, mesmo resultado — nada de IA generativa de vídeo.
O fluxo completo da skill, da leitura das imagens até a verificação dos frames. A narração é a fonte única de timing: ela governa as durações.
A skill mostra a tabela cena · imagem · beat · movimento · transição · duração para você aprovar antes de rodar o render.
Nunca uniformes: cut (padrão, ~70%), whip, whip_left, zoom_blur, dip_to_black, crossfade — decididas por fronteira de plano.
Imagens ricas viram 2–4 shots, com a narração podendo atravessar o corte para manter o fluxo.
A skill orquestra; o render acontece no pixflow. Confira as dependências com o check-deps do motor.
Motor de render do spec YAML (parallax 2.5D, 18 movimentos, transições, looks). Fica em ~/projetos/pixflow/skill.
# checar todas as dependências cd ~/projetos/pixflow/skill node cli/pixflow-motion.mjs check-deps
Node roda os scripts .mjs (montar-trilha) e a CLI do pixflow. FFmpeg/ffprobe medem a narração, fazem o encode e a verificação de frames.
# versões node -v ffmpeg -version
A skill abre cada imagem (Read/visão) antes de dirigir. Quando a entrada é texto, gera a narração via HyperFrames TTS (Kokoro, voz pf_dora).
# narração a partir de texto (opcional) npx hyperframes tts
Instale a skill, entregue imagens + narração ao Claude Code, aprove a decupagem e deixe o pixflow renderizar.
Crie o symlink da skill para a pasta de skills do Claude Code.
ln -s $(pwd)/skill/diretor-animacao ~/.claude/skills/diretor-animacao # registra a skill
Garanta que o motor pixflow e suas dependências estão ok antes de dirigir.
cd ~/projetos/pixflow/skill && node cli/pixflow-motion.mjs check-deps # tudo verde
No Claude Code, dê o conjunto de imagens e a narração (áudio ou texto) e peça em linguagem natural.
# peça à skill "vira filme" · "anima essas imagens" · "dirige esse material"
A skill mostra a decupagem (cena · imagem · beat · movimento · transição · duração). Revise antes do render.
# a skill monta a trilha compensando os overlaps de transição node skill/diretor-animacao/montar-trilha.mjs # nunca calcule starts na mão
Com o spec aprovado, o pixflow rende o MP4 final.
node cli/pixflow-motion.mjs render spec.yaml out.mp4 # MP4 pronto
Casos reais e validados no próprio repositório, das regras de ouro ao primeiro filme completo.
Primeiro filme real da skill: 21 ilustrações + 22 WAVs de narração viraram 2min11 com 26 shots, música CC0 com ducking, vento, whooshes e shimmer. Decupagem completa em exemplos/pequeno-principe.md.
A pasta piloto-f0/ guarda pilotos e experimentos com specs *.movie.yaml e decupagens que validaram cada regra (foto vs. desenho, transições, fim suspenso).
Tabela mestra movimento × beat e curva de 3 atos em references/gramatica-direcao.md — a base de decisão da direção.
DICAS-CORRECOES.md reúne 9 lições cross-projeto: anti-pisca, frames pretos, anti-fantasma e mais.
Itens descritos no PLANO.md do projeto. Sem datas — a direção evolui com os pilotos.