Anil-matcha/vox-ai-motion-graphics-generator
muapi-director
VerifiedTurn ONE topic, talking-head video, or photo into a finished Vox-style paper-collage explainer / ad video on the MuAPI platform (api.muapi.ai) + local ffmpeg — script, collage keyframes, motion, voice-over, music, captions, all automated. Three input modalities: a topic (B-roll), a talking-head video (A-roll mode), or a single photo of a person/product anchored into the collage (C-roll mode).
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 2.7 KB |
| assets/demo.mp4 | binary | 6.3 MB |
| assets/youtube-thumbnail.jpg | binary | 100.1 KB |
| examples/sample-beats.json | config | 2.4 KB |
| references/beat-layer.md | markdown | 3.3 KB |
| references/prompt-guide.md | markdown | 3.0 KB |
| references/voices.md | markdown | 1.4 KB |
| scripts/aroll_assemble.py | script | 2.6 KB |
| scripts/aroll_clips.py | script | 4.5 KB |
| scripts/asr_beats.py | script | 4.9 KB |
| scripts/assemble.py | script | 6.4 KB |
| scripts/audio.py | script | 3.7 KB |
| scripts/clips.py | script | 5.8 KB |
| scripts/croll_keyframes.py | script | 5.1 KB |
| scripts/keyframes.py | script | 3.1 KB |
| scripts/muapi_client.py | script | 9.0 KB |
| scripts/provider.py | script | 5.5 KB |
| scripts/style_bakeoff.py | script | 2.4 KB |
| scripts/styles.py | script | 11.5 KB |
| scripts/text_overlay.py | script | 4.6 KB |
references/beat-layer.md
View on GitHub# Beat & Shot Layer Library — Narrative Arc & Shot Specifications
This reference covers the story skeletons (narrative arcs) and per-shot specifications (shot size, camera moves, and internal elements) used to structure Muapi Director projects.
---
## 1. Narrative Arc Library
Choose an arc that fits the genre and tone of your video. The agent will draft a beat structure based on this arc:
| Arc Name | Best Used For | Structure Sequence |
| -------------- | ---------------------------------------------- | --------------------------------------------------------- |
| `hook_payoff` | General concepts, educational videos (Default) | Hook → Context → Build → Payoff → Wrap-up |
| `pas` | Product advertisements, sales pitches | Problem → Agitate → Solve → Proof → Call-to-Action (CTA) |
| `bab` | Before/After comparisons | Before State → After State → Bridge → Call-to-Action |
| `how_it_works` | Process, engineering, or tutorial videos | Hook → Overview → Step-by-Step Details → Benefit → CTA |
| `timeline` | History, biographies, and journeys | Beginning → Key Event 1 → Key Event 2 → Climax → Takeaway |
| `man_in_hole` | Comebacks, transformations, case studies | Baseline → Fall/Crisis → Deepening → Ascent → Resolution |
---
## 2. Hook, Pacing, and Cadence
- **Hook in ≤ 3 seconds:** The first shot must immediately grip the user. It should showcase a bold headline and highlight a surprising statistic, mistake, or direct question.
- **Cadence (Cut every ~4–6s):** To prevent visual stagnation, split each narrative beat into 2 distinct shots (a wide establishing shot followed by a close detail cut-in).
- **Beat Counts:**
- **30-second video:** 6–8 shots (3–4 beats)
- **60-second video:** 10–12 shots (5–6 beats)
---
## 3. Shot Composition & Flat-Safe Camera Moves
Since we are animating flat paper collage keyframes, camera movements must be uniform to keep text and graphics from warping or distorting.
### Shot Size
`EST_WIDE` (establish system/scene) · `WIDE` (subject in environment) · `MEDIUM` (centered subject) · `CLOSE` (fills frame with one item/person) · `DETAIL` (focus on a single word, texture, or symbol).
### Valid Camera Moves
- **`static`**: Locked-off camera. Great for letting text or complex statements sink in.
- **`push_in`**: Uniform zoom-in (classic Ken Burns effect). Enhances tension and focus.
- **`pull_out`**: Uniform zoom-out. Excellent for revealing background context.
- **`pan`**: Horizontal translation. Best for scanning a timeline or list.
- **`tilt`**: Vertical translation. Ideal for vertical layouts.
- **`parallax`**: Front, middle, and background layers moving at slightly different speeds to create a 2.5D depth effect.
---
## 4. Rich Element Motion (The Energy Engine)
While the camera move shifts the overall frame, **element motion** controls what animates _inside_ the collage itself. Animate multiple elements per shot to bring the scene to life:
- Example: _"A paper aeroplane swoops across the frame, a cut-out hand bobs up and down, and halftone dots scale up."_
- Let the AI craft rich, scene-specific motions to maintain high visual interest.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| add-product-e2e-evalpaperclipai/paperclipAdd or extend a Paperclip full-stack runner E2E workflow, fixture, matcher, or report evidence path for local or Daytona execution. | Stars: 115k | Updated | Claude CodeCodex | Verified | Install |
| add-runner-evalpaperclipai/paperclipAdd or extend a Paperclip Runner protocol evaluation definition, roster, assertion, or report fixture with provenance and narrow validation. | Stars: 115k | Updated | Claude CodeCodex | Verified | Install |
| diagnose-why-work-stoppedpaperclipai/paperclipCompatibility entry point for failed, stalled, looping, or over-recovered Paperclip work. Use fix-failed-paperclip-run for the full diagnosis, regression, repair, real verification, and green-PR workflow; honor an explicitly requested diagnosis-only scope. | Stars: 115k | Updated | Claude CodeCodex | Verified | Install |
| fix-failed-paperclip-runpaperclipai/paperclipDiagnose and fix failed, stuck, slow, or incorrectly blocked Paperclip tasks and runs. Use with a task/run URL or failure report to trace the root cause, prove a regression red then green, check second-order effects, verify the real workflow, and deliver a PR with passing checks. | Stars: 115k | Updated | Claude CodeCodex | Verified | Install |