К основному содержанию
плагин CX Codex

pro-motion — плагин для Claude Code: моушн-графика кодом под бит

Плагин pro-motion для Claude Code и Codex планирует музыку как маркетинговый актив, пишет ролик кодом на canvas и собирает MP4, нарезанный по биту.

MIT ★ 1 596 обновлён 2026-10-29

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install pro-motion@awesome-codex-plugins
Открыть на GitHub

Что делает pro-motion

Плагин ведёт ролик от брифа до готового файла. Сначала фиксирует продукт, аудиторию, рынки и пропорции, потом заполняет campaign.md: шесть идей из 12 приёмов нестандартного маркетинга, аудиоплан с sonic logo и хуками, один промпт для Suno или Udio. audio_post.py добавляет SFX точно по битам, статтеры и громкость.

Музыку разбирает analyze_music.py — темп, сетка битов, онсеты, спектрограмма с нарисованной сеткой. Референсы приходят контактными листами по 24 кадра через yt-dlp, без браузера. Дальше три разных стильфрейма на выбор, shotmap.md, сборка film.js на motion-lib.js с 40+ эффектами в духе AE и Blender, рендер через render-fast.js: параллельные headless-вкладки, JPEG-кадры, один вызов ffmpeg. Правки идут по таймкоду, пересборка занимает секунды.

Заранее нужны Node 18+, Python 3 с numpy scipy matplotlib и Chrome/Chromium — его путь можно задать через CHROME=/path. Вырезание объектов из кадра работает только на macOS 14+, на других системах этот шаг выпадает из пайплайна.

Какие задачи решает

  • собрать лонч-ролик под готовый трек с монтажом по биту
  • выбрать направление из трёх стильфреймов до начала анимации
  • нарезать референс на контактный лист из 24 кадров
  • подогнать SFX и громкость под точные биты в audio_post.py
  • перерендерить один отрезок по таймкоду после правки

Примеры запросов агенту

  • Сделай 20-секундный вертикальный лонч-ролик для моего приложения под ~/Downloads/track.mp3, английская версия плюс японская и корейская.
  • Переделай переходы на отрезке 8–10 секунд, сейчас там слайдшоу.
  • Покажи три стильфрейма в разных техниках, анимацию начнём после выбора.

Как установить pro-motion

Через маркетплейс плагинов

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

По шагам, с командами для каждой платформы: Плагины Claude Code: маркетплейсы, установка и как собрать свой

Вопросы о pro-motion

Как установить pro-motion в Claude Code?

Добавьте маркетплейс командой /plugin marketplace add hashgraph-online/awesome-codex-plugins, затем поставьте плагин: /plugin install pro-motion@awesome-codex-plugins.

Что делает pro-motion?

Планирует аудио под ролик, пишет моушн-графику как детерминированный render(t) на canvas и рендерит MP4, нарезанный по музыке.

Что нужно для работы плагина?

Node 18+, Python 3 с numpy scipy matplotlib и Chrome/Chromium. Вырезание объектов из кадра требует macOS 14+.

Исходный текст

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

Похожие плагины

Все плагины по теме «Дизайн» →
motion-graphics Liamrjohnston Скилл motion-graphics проверяет подлинность ассетов и блокирует генерацию моушн-графики до прохождения проверок через promptible-gate.mjs. Помогает собирать ролики для соцсетей. CX Codex +1 1 900установок motion-broll Barty-Bart Скилл motion-broll создаёт моушн-графику и перебивки для разговорных видео по таймкодам субтитров. Генерирует анимации с морфингом одного элемента в такт речи спикера. CX Codex +1 4 100установок motion-ad danny.md — https://www.danny.md/skills/motion-ad Скилл motion-ad создаёт короткие 15-секундные рекламные видеоролики в MP4 из посадочной страницы с помощью GSAP, Playwright и ffmpeg. CX Codex +1 ★ 141звёзд репо reference-to-motion charlie947 Скилл reference-to-motion для Claude Code разбирает видео и референсы стиля, чтобы собрать промпт для Claude Motion с таймингами сцен под бренд. Создаёт промпты для моушн-роликов по образцу. CX Codex +1 3 000установок milestone-reveal charlie947 Скилл milestone-reveal собирает 12-секундный зацикленный ролик, где тысячи точек слетаются в вашу реальную цифру подписчиков, выручки или клиентов. CX Codex +1 3 300установок tesseract-motion mirage-hq Скилл tesseract-motion для Claude Code собирает локальную моушн-графику в Tesseract. Создаёт редактируемые титры, плашки, схемы и анимированные слои поверх готового видео. CX Codex +1 4 600установок

Из того же набора391

Весь набор →
qrstuff-mcp-server Плагин подключает Claude Code к QRStuff: агент создаёт и настраивает QR-коды, управляет проектами и получает статистику сканирований. Для приватных данных нужна авторизация через QRStuff OAuth 2.1. CX Codex ★ 1 596звёзд репо qatom Плагин подключает агента к маркетплейсу Qatom: чужие MCP-инструменты вызываются с оплатой за вызов, а свой API можно опубликовать и продавать по той же схеме. CX Codex ★ 1 596звёзд репо pronounce Плагин pronounce озвучивает термины и названия технологий вроде kubectl, nginx или JWT по словарю с IPA и источниками. Пригодится разработчикам перед созвонами и докладами. CX Codex ★ 1 596звёзд репо prompt-to-asset Плагин prompt-to-asset для Claude Code и Codex направляет запросы на генерацию изображений к DALL-E, Stable Diffusion, Flux, Midjourney и другим моделям через единый MCP-интерфейс. CX Codex ★ 1 596звёзд репо pricewin Плагин pricewin ищет и сравнивает цены на отели и авиабилеты через Booking.com, Agoda, Trip.com и Traveloka прямо в окне ИИ-агента. CX Codex ★ 1 596звёзд репо posteverywhere Плагин posteverywhere для Claude Code планирует и публикует посты в соцсетях через MCP-сервер. Он также собирает контент-календарь и показывает статистику публикаций. CX Codex ★ 1 596звёзд репо post Плагин post для Claude Code и Codex собирает серию изображений для поста в Xiaohongshu или X: обложку, скриншоты, моки интерфейса и страницу с цифрой. Показывает продукт без шаблонных градиентов. CX Codex ★ 1 596звёзд репо plori Подключает удалённый MCP-сервер plori и скилл для создания облачных ИИ-агентов с постоянным диском и памятью прямо из сессии ассистента. CX Codex ★ 1 596звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой