vox-director

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 Silicon Valley history · 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 ``` That flow is **B-roll** — a topic in, everything generated. Two more input modalities reuse the same engine: - **A-roll — you already have a talking-head video.** It is ASR-segmented into beats and re-styled into the collage look, keeping the real face, lip-sync and gestures frame-for-frame (`gemini-omni-flash/video-edit`, auto-retrying on `seedance-2.0/reference-to-video`). - **C-roll — you have one still photo** (a selfie, a product shot). The subject is cut out as a photographic sticker — never redrawn — and each beat's poster is generated around it (`nano-banana-2/edit`). The narration can be cloned into the subject's own voice. 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` | | Re-style a talking-head (A-roll) | `google/gemini-omni-flash/video-edit` | | Anchor a photo in the collage (C-roll) | `google/nano-banana-2/edit` | | Narration | `xai/tts-v1` | | Narration in a real person's voice | `bytedance/seed-audio-1.0` (voice cloning) | | 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//final.mp4`. ## Requirements - A **coding agent** — Claude Code, Codex, or similar - **Atlas Cloud** API key - **ffmpeg** + **ffprobe** (`brew install ffmpeg`) - **Python 3** with **Pillow** (`pip install pillow`) — for caption/watermark overlays ## What's in the box ``` … ``` ## Credits Built by **[@alisaqqt](https://x.com/alisaqqt)** — follow for more agent-skill experiments. Inspired by the collage-ad workflows of **[Stav Zilber](https://x.com/StavZilber)**, **[rom1trs](https://x.com/rom1trs)** and **[Higgsfield](https://x.com/higgsfield_ai)**, and by **[Vox](https://www.vox.com)**'s explainer visual language. Built end to end on **[Atlas Cloud](https://www.atlascloud.ai/?utm_source=github&utm_campaign=vox_director)** — one prompt, one film. ## License [MIT](LICENSE) © 2026 Alisa Qian