bestagentkits / motion-video-skill

# Motion Video
An agent skill that produces a beat-synced 1920×1080 30 fps motion-graphic video:
the scene cuts land on the music's beats, the reveals land on the spoken words,
and the audio is broadcast-clean.
 [code] 
MIT licensed. Works with Claude Code, Codex, Cursor, OpenCode, Gemini CLI, Pi and
any other agent that reads Agent Skills.
## Demo
The comic-multiverse edition of the Dewee v3.34 release video, produced by this
skill from a single prompt:
**→ Watch the 151 s demo on X**
The same release also has a 144 s glass-keynote edition. Neither working project
is bundled with this repository, because the generated voice-over, music and SFX
are large and provider-licensed.
## What it does
Each run follows one fixed pipeline, and every step writes the file the next step
reads, so the order matters:
1. Pin the outcome: topic and sources, style, duration, voice language, ending.
2. Scaffold `assets/videos/ /` from the bundled templates.
3. Generate the voice-over, sound effects and music through the `multix` CLI.
4. Align the voice-over to the script, so every word has a real timestamp.
5. Fit the beat grid, then splice music bars so the drops fall where the script
 needs them.
6. Build the timeline and the audio mix, then measure the voice/music balance.
7. Author `index.html` against the composition contract and the chosen style.
8. Lint, check, snapshot and render with HyperFrames, remux the untouched mix,
 and encode a smaller social version.
A run is finished only when the measurable checks pass: `hyperframes lint` and
`check` clean, every music segment within ±2 ms of its target beat, music about
4–6 dB under speech, 1920×1080 at 30 fps, and EBU R128 around −14 LUFS with a
true peak no higher than −1 dBFS.
## Two styles
| Style | Style reference | Demo | Feel |
|---|---|---|---|
| Comic multiverse | `references/style-comic-spiderverse.md` | 151 s edition | loud, playful, hand-made |
| Glass keynote | `references/style-glass-keynote.md` | 144 s edition | premium, calm, clear |
A restyle is a new project directory, so the first edition always stays intact.
## Install
### Any agent, with `npx skills`
The fastest route, and the one that works across agents:
 [code] 
Useful flags: `-g` installs to your user directory instead of the project,
`-a ` targets specific agents such as `claude-code` or `codex`, `--copy`
copies instead of symlinking, and `-y` skips the prompts.
### Claude Code plugin marketplace
 [code] 
The same thing from a shell:
 [code] 
Invoke the skill as `/motion-video:motion-video`, or just describe the video you
want and let Claude route to it.
### ChatGPT and Codex plugins
The repository ships a portable Agent Plugins
manifest at the root and a repo marketplace catalog, which is the layout ChatGPT
and Codex expect for a skills-only plugin:
 [code] 
In the ChatGPT desktop app, open the Plugins Directory, select the marketplace,
and Install. For a personal marketplace instead of a repo one, add an entry to
`~/.agents/plugins/mar