Skip to main content
plugin CX Codex

pro-motion — Claude Code plugin: motion graphics written as code

pro-motion plans the soundtrack as a marketing asset first, then writes the film as canvas code and muxes an MP4 cut to the beat.

MIT ★ 1,596 updated 2026-10-29

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install pro-motion@awesome-codex-plugins
Open on GitHub

What pro-motion does

Pro Motion opens with the brief: product, audience, markets, ratios, film type. Then it fills a campaign.md worksheet with six stunt ideas drawn from 12 unconventional-marketing levers, an audio plan with a sonic logo and hooks, and a single Suno or Udio prompt. audio_post.py handles SFX on exact beats, stutters, loops and loudness.

analyze_music.py reports tempo, the beat grid, onsets and a spectrogram with the grid drawn on top. Reference material arrives as 24-frame contact sheets pulled with yt-dlp. From there the agent picks one of three clearly different style frames, writes shotmap.md, builds film.js on motion-lib.js with 40+ deterministic canvas effects in the AE and Blender spirit, and renders through render-fast.js: parallel headless tabs, JPEG frames, one ffmpeg mux. Feedback goes by timestamp, then a re-render.

Node 18+, Python 3 with numpy scipy matplotlib and Chrome/Chromium have to be in place before the first render; a non-standard browser path goes into CHROME=/path. Subject cutouts need macOS 14+, so elsewhere that step drops out of the pipeline.

What it helps with

  • cut a launch film to an existing track
  • compare three style directions before anything animates
  • pull a 24-frame contact sheet from a reference video
  • score a sonic logo and write one Suno prompt
  • re-render a single shot by timestamp

Example prompts for the agent

  • Make a 20-second vertical launch film for my photo app cut to ~/Downloads/track.mp3, with English, Japanese and Korean cuts.
  • Redesign the transitions between 8 and 10 seconds, it reads as a slideshow.
  • Show me three style frames in different techniques before you animate anything.

How to install pro-motion

Plugin marketplace

/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install pro-motion@awesome-codex-plugins

Step by step, with commands for each platform: Claude Code plugins: marketplaces, installing, and building your own

Questions about pro-motion

How do I install pro-motion in Claude Code?

Run /plugin marketplace add hashgraph-online/awesome-codex-plugins, then /plugin install pro-motion@awesome-codex-plugins.

What does pro-motion do?

It plans the audio for a film, writes the motion graphics as a deterministic render(t) on a canvas and renders an MP4 cut to the music.

Does it work outside Claude?

Yes. The skill follows the Agent Skills standard, so Codex and any other agent that reads SKILL.md can run it.

Source text

pro-motion · MIT
# Pro Motion · audio-first motion-graphics films with Claude Code

English | [简体中文](https://github.com/jack-reson8/pro-motion/blob/main/README.zh-CN.md) | [日本語](https://github.com/jack-reson8/pro-motion/blob/main/README.ja.md) | [한국어](https://github.com/jack-reson8/pro-motion/blob/main/README.ko.md) | [Tiếng Việt](https://github.com/jack-reson8/pro-motion/blob/main/README.vi.md) | [हिन्दी](https://github.com/jack-reson8/pro-motion/blob/main/README.hi.md)

**Give Claude a product (and a track, or let it plan one). Get a launch film, brand film or TVC that is designed, not templated — rendered in code, cut to the beat, in minutes.**

<table><tr>
<td align="center"><img src="https://raw.githubusercontent.com/jack-reson8/pro-motion/main/docs/showcase-launch.gif" width="260"><br><sub><b>Launch film</b> · product UI, effects that perform, 5 language cuts</sub></td>
<td align="center"><img src="https://raw.githubusercontent.com/jack-reson8/pro-motion/main/docs/showcase-brand.gif" width="260"><br><sub><b>Brand film</b> · stylized animation, objects as instruments</sub></td>
<td align="center"><img src="https://raw.githubusercontent.com/jack-reson8/pro-motion/main/docs/demo.gif" width="260"><br><sub><b>Starter template</b> · 8 s demo you get on install</sub></td>
</tr></table>

<sub>Films made with this skill for <b>Tutti</b>, a photo-play app. Full-length versions are attached to the <a href="https://github.com/jack-reson8/pro-motion/releases">latest release</a>.</sub>

Most "AI video" today is either a template (3D phone + App Store badge) or a generated clip you can't direct. Pro Motion takes a third path: **the music is planned as a marketing asset first, then Claude writes the film as code** — a deterministic `render(t)` on a canvas — so every hit lands on the music to the 16th note, every transition is designed, and any shot can be changed by timestamp and re-rendered in seconds.

It is the method distilled from a real project that went through ~10 rounds of "this looks like a PowerPoint", "the material is ugly", "the text floats on top", "I said stylized, not pop art" — until the cuts were accepted. **The method made the difference, so the method is what this skill encodes.**

## What it does

| Step | What Claude does |
|---|---|
| 1 · Brief | Fixes product, audience, markets, music, ratios, film type — decides defaults instead of interrogating |
| 1b · Campaign + audio | A `campaign.md` worksheet: six stunt ideas from 12 unconventional-marketing levers (the medium malfunctions, neighbour billboards, the restriction becomes the joke, absurd mascot, personal replies at scale, UGC army, FOOH…), scored and picked. Then the campaign brain (truth · tension · mechanic · channel), an audio plan with a sonic logo and hooks, one precise Suno/Udio prompt, then `audio_post.py` for exact-beat SFX, stutters, loops and loudness |
| 2 · Music | `analyze_music.py` → tempo, beat grid, onsets, low/high hits, a spectrogram with the grid drawn on. The spectrogram is the edit |
| 3 · Research | Finds official uploads, pulls 24-frame **contact sheets** with yt-dlp (no browser), writes a **technique sheet** per reference |
| 4 · Direction | **Three clearly different style frames** from named techniques — you pick before anything is animated |
| 5 · Story | One **protagonist** that transforms through every scene; every feature performs itself on a music event; every transition designed; text is animation; the ending grows into the logo |
| 6 · Build | `motion-lib.js`: easing & springs, squash & stretch, a beat camera driven by onsets, 12-fps doodle line boil, pen-written text, metaballs, halftone, stripes, 3D card ring, sticker outlines, subject cutouts (macOS Vision), multi-language switch — plus 40+ deterministic canvas equivalents of AE / Blender / anime devices: curl-noise particles, particles that assemble into a logo, Saber glow, shine, whip pan, iris, ink bleed, shatter, zoom-through, paper tear, morph, manga panels, infinite zoom, RGB split, glitch, dither, ASCII, riso, cut paper, toon shading, hatching, watercolour, slit-scan, echo, speed ramp. `fx-demo.html` shows each for one second |
| 7 · Render | `render-fast.js`: parallel headless tabs → JPEG frames → one ffmpeg mux. ~30 s for 20 s @ 60 fps. Contact-sheet check, audio-length check |
| 8 · Iterate | Feedback by timestamp; taste feedback goes back to research and direction, not to patching |

<p align="center"><img src="https://raw.githubusercontent.com/jack-reson8/pro-motion/main/docs/spectrogram-example.png" width="720" alt="Music analysis: spectrogram, envelope and beat grid"></p>

## Install

**As a Claude Code plugin (recommended)**

In a session: `/plugin install pro-motion --marketplace jack-reson8/pro-motion` — or from the shell:

```bash
claude plugin marketplace add jack-reson8/pro-motion
claude plugin install pro-motion@pro-motion
```

**As a plain skill**

```bash
git clone https://github.com/jack-reson8/pro-motion
cp -R pro-motion/plugins/pro-motion/skills/pro-motion ~/.claude/skills/
```

Requirements: Node 18+, Python 3 with `numpy scipy matplotlib`, Chrome/Chromium (auto-detected, or `CHROME=/path`). Subject cutouts need macOS 14+. Everything else is installed per project by `scripts/setup.sh`.

**Codex** (CLI or the ChatGPT desktop app):

```bash
codex plugin marketplace add jack-reson8/pro-motion
codex plugin add pro-motion@pro-motion
```

Or copy `plugins/pro-motion/skills/pro-motion` into `~/.codex/skills/`. The skill follows the open [Agent Skills](https://agentskills.io) standard, so it works in Claude Code, Codex and any agent that reads SKILL.md.

**Other agents** (Cursor, Gemini CLI, GitHub Copilot and other agents supported by the skills CLI):

```bash
npx skills add jack-reson8/pro-motion
```

## Use it

Just ask, with a track:

> Make a 20-second launch video for my photo app, cut to `~/Downloads/track.mp3`. Vertical, English master plus Japanese and Korean cuts.

> 用这首歌给我的品牌做一支强烈风格化的品牌片,先给我三个风格方向的风格帧。

> The 8–10 s section feels like a slideshow — redesign the transitions there.

Claude follows the skill: analyses the music, researches with contact sheets, shows style frames, writes `shotmap.md`, builds `film.js`, renders `out/*.mp4`, checks a frame sheet, and opens the result.

## What's inside

```
plugins/pro-motion/skills/pro-motion/
├── SKILL.md                    # the method (read by Claude)
├── scripts/
│   ├── setup.sh                # one-command project setup
│   ├── analyze_music.py        # tempo, grid, onsets, spectrogram
│   ├── audio_post.py           # exact-beat SFX, stutter, loop, loudness
│   ├── render-fast.js          # parallel render, stills mode, audio mux
│   ├── contact_sheet.sh        # frames at given seconds → one image
│   ├── ref_frames.sh           # reference video → 24-frame sheet (yt-dlp)
│   ├── cutout.swift            # subject mask (macOS Vision)
│   └── faces.swift             # face boxes (macOS Vision)
├── assets/template/            # campaign.md · audio-plan.md · film.html · film.js (runnable demo) · motion-lib.js · fx-demo.html · OFL fonts
└── references/
    ├── unconventional-marketing.md  # 12 stunt levers → steps → cases → how to apply
    ├── campaign-cases.md       # launch mechanics that travelled
    ├── audio-first.md          # campaign brain, audio plan, generator prompts
    ├── vfx-techniques.md       # transitions, rhythm, AE / Blender / stylised looks: source · params · lib call
    ├── sourcing.md             # how to find and read references
    ├── research-notes.md       # worked technique sheets
    ├── aesthetic-checklist.md  # story · motion · type · material · languages · delivery
    └── lessons.md              # bugs and taste mistakes already paid for
```

## Principles (the short version)

1. **The music is the edit.** Read the spectrogram; land every move on a mapped event.
2. **Look at real frames, never design from memory.**
3. **Pick a direction from style frames,** not the first association or the easiest thing to code.
4. **One protagonist, effects that perform, transitions that are designed** — or it reads as PowerPoint.
5. **Text is animation.** No lower-thirds, chips, or boxes.
6. **Ugly material makes an ugly film.** Real, current, licence-safe material — or blank space.
7. **Render in seconds, check one contact sheet, deliver.** Iterate by timestamp.

## Licence

Code and docs: MIT (see `LICENSE`). Bundled fonts: SIL Open Font License 1.1 (Patrick Hand, Yomogi, Gaegu, ZCOOL KuaiLe) — see `assets/template/assets/fonts/LICENSES.md`. References you download with `ref_frames.sh` are for private study only; don't redistribute them.

Contributions welcome — new motion primitives, transitions, technique sheets and lessons especially. See `CONTRIBUTING.md`.

© jack-reson8 · MIT · hashgraph-online/awesome-codex-plugins

Similar plugins

All plugins for Design →

From the same set391

The whole set →
qrstuff-mcp-server This plugin connects Claude Code to QRStuff for creating and customizing QR codes, managing projects, and checking scan analytics. Private account features use QRStuff OAuth 2.1. CX Codex ★ 1,596repo stars qatom Links your agent to the Qatom marketplace: buy calls on other people's MCP tools with payment per call, or list your own API and charge for each one. CX Codex ★ 1,596repo stars pronounce Pronounces developer jargon like kubectl, nginx, or JWT using a sourced dictionary with IPA. Useful for standups, tech talks, and voice responses. CX Codex ★ 1,596repo stars prompt-to-asset The prompt-to-asset plugin for Claude Code and Codex routes image-generation prompts to more than 30 models through one MCP interface, including DALL-E, Stable Diffusion, Flux, and Midjourney. CX Codex ★ 1,596repo stars pricewin pricewin compares real-time hotel and flight prices across Booking.com, Agoda, Trip.com, and Traveloka directly inside your coding agent. CX Codex ★ 1,596repo stars posteverywhere posteverywhere is a Claude Code plugin that plans and publishes social posts through an MCP server. It also builds a content calendar and reports post performance. CX Codex ★ 1,596repo stars post Builds a share-image set for a Xiaohongshu or X post: cover, real screenshots, UI mocks, a number page. Use it when template gradients would sink the launch. CX Codex ★ 1,596repo stars plori Connects your assistant to persistent plori cloud agents over remote MCP with bundled skill instructions and OAuth sign-in. CX Codex ★ 1,596repo stars

Project sponsors

Companies that keep this analytics open