PTENES
Cinematic direction skill · Claude Code

Your images + narration become film — no AI video

A real director: sees every image, decides on camera, cuts, transitions, music, and effects — and renders deterministically via pixflow.

Start the guide View on GitHub
Frame from the film The Little Prince: the fox and the prince in golden grass
What it is

Direction, not generation

The images are yours — what the Director adds is cinema: camera movement, editing rhythm, depth, and sound. No frames invented by video AI.

👁️ See every image

Analyzes with vision: photo or drawing, content, emotion, and the exact point of interest the camera should target. Rich images become 2–4 shots.

🎥 Cinematic grammar

18 camera moves + from/to framing, transitions by intent (cut, whip, dip, crossfade), a 3-act arc, and a cliffhanger ending — rules validated in A/B.

🔊 Cinematic sound

Narration controls the timing; music with automatic ducking under the voice, wind, whooshes, and shimmers complete the mix in a single master.

How it works

The Director’s workflow

Seven steps, always in this order — the shot breakdown is shown for approval before rendering.

👁️ SEE the images→ 👂 LISTEN to the narration→ 🎬 DECIDE on camera and cuts→ 📋 SHOT BREAKDOWN (approval)→ 🎚️ SOUNDTRACK→ 🎞️ RENDER (pixflow)→ ✅ VERIFY
Prerequisites

What needs to be live

All local and open source. The render engine is pixflow v2.3+ (Depth-Anything-V2 + Three.js + Remotion + FFmpeg).

pixflow engine

Clone and check the render engine dependencies.

# check engine deps
cd ~/projetos/pixflow/skill
node cli/pixflow-motion.mjs check-deps

Node + FFmpeg

Node ≥18 for the scripts and CLI; ffmpeg/ffprobe for audio and verification.

node --version   # ≥18
ffmpeg -version

The installed skill

Symlink in the Claude Code skills directory.

ln -s ~/projetos/diretor-animacao/skill/diretor-animacao \
  ~/.claude/skills/diretor-animacao
User guide · step by step

From image folder to MP4

The happy path: you provide the materials and approve the shot list; the skill directs and renders.

1

Prepare the materials

A folder with images (photos and/or illustrations, ideally ≥1920px) and narration — WAVs per clip, a single WAV, or just the text (the skill generates local TTS).

meu-projeto/
├── img/  s1.png s2.png …      # the images, in story order
└── audio/ s1.wav s2.wav …     # narration by segment (or narracao.txt)
2

Request the film in Claude Code

Point to the folder and use a skill trigger. You can request music and effects too.

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

Approve the shot list

The skill shows the scene · image · beat · movement · transition · duration table before rendering. Adjust anything you want (or say "direct" to skip approval).

# sample shot list row
c1 · s1 · abertura · pull-out dramático · cut · 6.1s
4

Single-source soundtrack

The narration controls durations; the soundtrack assembly compensates for transition overlaps (never calculate starts by hand).

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

Deterministic rendering

The YAML spec (pixflow.movie/v1) is validated and rendered by the engine — same spec, same film, every time.

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

Verification before delivery

Frame-by-frame brightness checks at boundaries (anti-flicker) and visual inspection of key frames — the film is only delivered after it’s checked.

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

The Little Prince — 21 images, 2min11

The skill’s first real film: 21 watercolors + 22 narration clips became 26 shots with CC0 music (ducking under the voice), desert wind, whooshes, and star shimmer. Full shot list and lessons →

Opening: dramatic pull-out reveals the prince in the starry desert
Opening — the film’s only dramatic move: a pull-out reveals the desert. The ending reuses this image and closes the circle.
Rose garden: pull-out reveals hundreds of identical roses
The rose garden — a pull-out reveals hundreds of roses just like his, along the contemplative valley path.
Roadmap

Project phases

Built through A/B pilots — every grammar rule was validated with an actually rendered film.

F0–F1 ✓
pixflow engine v2.3Real frame movement, 18 movements + framing from/to, anti-ghosting, whip/zoom_blur transitions, breathing room.
F2 ✓
The Director skill + first real filmComplete directing grammar, multi-shot, soundtrack assembly, music/SFX with ducking — The Little Prince delivered.
F3
Transition upgradesTrue whip (both scenes sweep), push, match-on-motion, light flash, dip between acts.
F4
Light and particle effectsLight leaks, fog, particles, hold/speed-ramp, automatic upscaling for small images.