English · 简体中文
# 🎬 Vox Director **Turn one topic into a finished Vox-style paper-collage explainer / ad video — script, collage keyframes, motion, voice-over, music and captions, all automated.** An **agent skill** that runs end to end on the [Atlas Cloud](https://www.atlascloud.ai/?utm_source=github&utm_campaign=vox_director) API + local `ffmpeg`, usable by any coding agent (Claude Code, Codex, etc.). You give it a one-line topic; it gives you an `mp4`.    |
|
|
| Football history · 60s | Mexican street food · 60s | A brief history of money · 60s |
▶ more films — click any thumbnail to play
--- ## What it is The look is the modern editorial **paper-collage** popularized by Vox explainers: hand-cut paper cut-outs, torn edges, tape, halftone dots, newspaper clippings, bold flat color per beat, big cut-out headlines — brought to life with motion, a narrator, music and captions. ## How it works One topic flows through one script per stage, all driven by a single `beats.json` per project: ``` topic │ ├─ 1. beat map pick a narrative arc → write beats.json ◀── GATE 1: you approve the beat map ├─ 2. style bake-off render the same beat in 3–4 themes ◀── GATE 2: you pick the look by eye ├─ 3. keyframes one collage poster per beat (nano-banana-2) ├─ 4. motion animate each poster (gemini-omni-flash i2v) ├─ 5. voice + music one narrator (xai/tts) + BGM (minimax/music) ├─ 6. assemble ffmpeg: concat, duck music under VO, burn captions + watermark └─ final.mp4 ``` Two ideas make or break the result, and the skill is built around both: 1. **The look is born in the image step.** Each beat is a finished collage *poster*. All the collage DNA (torn paper, cut-outs, halftone, headline text) lives in that image — if the poster isn't a rich collage, nothing downstream saves it. 2. **The motion is added after.** By default an AI video model animates the whole poster (the "living poster" path). For dramatic *piece-by-piece* assembly, an optional local keyframe engine cuts the poster into parts and drives them frame-by-frame (no content filters, pixel-exact — great for real people). Two human decision gates keep you in control (approve the beat map; pick the style); everything else is automated. ## Models (verified on Atlas Cloud) | Job | Model | |---|---| | Keyframe / collage poster | `google/nano-banana-2/text-to-image` | | Animate (non-real content) | `google/gemini-omni-flash/image-to-video` | | Animate (**real people / brands**) | `kwaivgi/kling-video-o3-pro/image-to-video` | | Narration | `xai/tts-v1` | | Music | `minimax/music-2.6` | | Cut out an element (advanced path) | `youchuan/v8.1/remove-background` | Model IDs drift — the skill fetches the live list from `GET https://api.atlascloud.ai/api/v1/models` before running. ## Install This is an **agent skill** — it works with any coding agent that can read a workflow and run scripts (Claude Code, Codex, …). Claude Code auto-discovers it as a skill; other agents read [`AGENTS.md`](AGENTS.md) → [`SKILL.md`](SKILL.md). **Option A — from this repo:** ```bash git clone https://github.com/Alisa0808/vox-director.git ~/.claude/skills/vox-director ``` **Option B — from the packaged skill:** download [`vox-director.skill`](vox-director.skill) and install it via your Claude skills UI. Then set your Atlas Cloud API key (get one at [atlascloud.ai/console/api-keys](https://www.atlascloud.ai/console/api-keys?utm_source=github&utm_campaign=vox_director)): ```bash export ATLASCLOUD_API_KEY="sk-..." ``` ## Quick start Just ask your coding agent, with the skill installed: > *"Make me a Vox-style collage video introducing Mexican street food — English, 16:9, 15 seconds."* The agent will draft a beat map for your approval, run a style bake-off for you to pick from, then generate keyframes → motion → voice → music and assemble `out/