motion-playbook
Code-drawn films that render frame-exact on the GPU and pass measured QA: a Claude Code and Codex plugin (briefs in numbers, renderAt contract, motion QA, X-ready export)
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/mindburnlabs--motion-playbook)HTML
<a href="/listings/mindburnlabs--motion-playbook"><img src="/api/listings/mindburnlabs--motion-playbook/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
The same folder is a Claude Code plugin, a Codex plugin and a set of standard Agent Skills.
**Claude Code**
claude plugin marketplace add mindburnlabs/motion-playbook claude plugin install motion-playbook@motion-playbook
To try it without installing: `git clone https://github.com/mindburnlabs/motion-playbook && claude --plugin-dir motion-playbook/plugins/motion-playbook`.
**Codex**
codex plugin marketplace add mindburnlabs/motion-playbook # reads .agents/plugins/marketplace.json codex plugin add motion-playbook@motion-playbook
Skills appear as `motion-playbook:film`, `:brief`, `:qa`, `:export`, `:blender-asset` and `:studio`. To confirm they reached the model, run `codex debug prompt-input "hi" | grep -o 'motion-playbook:[a-z-]*'`.
Codex does not put plugin `bin/` folders on PATH; the skills tell the model to `export PATH="<plugin root>/bin:$PATH"`. Codex has no plugin agents, so the studio skill spawns subagents from `agents/*.md`.
**OpenCode, Cursor, Pi and other Agent Skills hosts**
git clone https://github.com/mindburnlabs/motion-playbook ~/plugins/motion-playbook ~/plugins/motion-playbook/plugins/motion-playbook/bin/motion-install-skills opencode # or: agents | cursor | claude | <dir>
This copies each skill as `motion-film`, `motion-qa` and so on, with paths rewritten to this checkout. Re-run it after `git pull`; `--remove` uninstalls. Generic skill installers (`npx skills add`, `gh skill install`) copy only the skill folder and leave out the shared `references/`, `scripts/` and `bin/`, so use this installer or a plugin marketplace instead.
**Check the machine:** `motion-doctor` checks Node, the ffmpeg filters, Chrome on the GPU, Blender and uv.
**Requirements:** Node 20+, ffmpeg with libx264, and Google Chrome or Chromium (Playwright's cache works too). Blender 5.x and uv are optional.
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
.claude-plugin/marketplace.json · Manifest · 13 lines
- {
- "name": "motion-playbook",
- "owner": { "name": "motion-playbook" },
- "metadata": { "description": "Code-drawn film and motion tooling for Claude Code." },
- "plugins": [
- {
- "name": "motion-playbook",
- "source": "./plugins/motion-playbook",
- "description": "One prompt, one film: briefs in numbers, renderAt(t) films rendered frame-exact on the GPU, motion QA that measures motion, sound on the score, X-ready export.",
- "category": "creative"
- }
- ]
- }
README.md · README · 129 lines
- # motion-playbook
- A Claude Code plugin for making films and seamless loops with code: three.js, canvas or DOM pages that render frame-exact on the GPU and are checked by measuring their motion, not by looking at stills.
- It packages "The Fable 5.2 Motion Playbook: One Prompt, One Film" (9 lessons from 40 finished films) as working tools, and adds what the article leaves out: a zero-dependency renderer, page-level and file-level QA, a closed-form motion kit, sound driven by the score, X-ready mastering, scripted Blender assets and an agent-team workflow.
- The method in six steps:
- - Write the clock first.
- - Replace every adjective with a number.
- - Measure the hero.
- - Fix on stills.
- - Measure motion.
- - Press play.
- ## Install
- The same folder is a Claude Code plugin, a Codex plugin and a set of standard Agent Skills.
- **Claude Code**
- ```bash
- claude plugin marketplace add mindburnlabs/motion-playbook
- claude plugin install motion-playbook@motion-playbook
- ```
- To try it without installing: `git clone https://github.com/mindburnlabs/motion-playbook && claude --plugin-dir motion-playbook/plugins/motion-playbook`.
- **Codex**
- ```bash
- codex plugin marketplace add mindburnlabs/motion-playbook # reads .agents/plugins/marketplace.json
- codex plugin add motion-playbook@motion-playbook
- ```
- Skills appear as `motion-playbook:film`, `:brief`, `:qa`, `:export`, `:blender-asset` and `:studio`. To confirm they reached the model, run `codex debug prompt-input "hi" | grep -o 'motion-playbook:[a-z-]*'`.
- Codex does not put plugin `bin/` folders on PATH; the skills tell the model to `export PATH="<plugin root>/bin:$PATH"`. Codex has no plugin agents, so the studio skill spawns subagents from `agents/*.md`.
- **OpenCode, Cursor, Pi and other Agent Skills hosts**
- ```bash
- git clone https://github.com/mindburnlabs/motion-playbook ~/plugins/motion-playbook
- ~/plugins/motion-playbook/plugins/motion-playbook/bin/motion-install-skills opencode # or: agents | cursor | claude | <dir>
- ```
- This copies each skill as `motion-film`, `motion-qa` and so on, with paths rewritten to this checkout. Re-run it after `git pull`; `--remove` uninstalls. Generic skill installers (`npx skills add`, `gh skill install`) copy only the skill folder and leave out the shared `references/`, `scripts/` and `bin/`, so use this installer or a plugin marketplace instead.
- **Check the machine:** `motion-doctor` checks Node, the ffmpeg filters, Chrome on the GPU, Blender and uv.
- **Requirements:** Node 20+, ffmpeg with libx264, and Google Chrome or Chromium (Playwright's cache works too). Blender 5.x and uv are optional.
- ## What's inside
- **Skills.** Each is model-invoked and also available as a `/` command.
- | Skill | Use |
- |---|---|
- | `motion-playbook:film` | One prompt to a finished, checked MP4: brief, score, contract, stills, draft, render, QA, export |
- | `motion-playbook:brief` | Turns adjectives into a numeric director brief (subject, time grid, hex, lenses, damping ratios, bans, QA, done) |
- | `motion-playbook:qa` | Measures a film or MP4 and reports every check with its number |
- | `motion-playbook:export` | X MP4 with -14 LUFS / -2 dBTP measured after AAC, a GIF within X's limits, or a ProRes master |
- | `motion-playbook:blender-asset` | Costumes and props built by Blender script, with numeric intersection checks and phone-size turnarounds |
- | `motion-playbook:studio` | Long films with departments (score, layout, animation, look) and a reviewer that did not build anything |
- **Agents.** `motion-reviewer` (read-only; tries to break the film), `motion-score`, `motion-layout`, `motion-animator` and `motion-look`.
- **Commands on PATH** (from `bin/`):
- | Command | Does |
- |---|---|
- | `motion-new <dir>` | Scaffolds a working 8 s loop (three.js r187) that already passes every check |
- | `motion-timing` | Builds the score: beat grids, linear tempo ramps, events, shots, sound 1 frame after picture; `from-audio` tracks beats with librosa |
- | `motion-lint` | Determinism lint: clocks, Math.random, carried state, CSS animation, unpinned CDNs, contract |
- | `motion-inspect` | Page QA: GPU, stills, contact sheets, seek (cold = sequential = jump), seam, hero width per shot, hero and text in frame |
- | `motion-render` | Frames 0..N-1 to MP4 on the GPU; linear-light motion blur clamped at cuts; `--capture canvas` (about 5x faster); in-page soundtrack |
- | `motion-qa` | File QA: freezedetect, motion graph (`motion.svg`), planned moves, seam, black frames, format, BT.709 tags, faststart, loudness |
- | `motion-export` | `x`, `gif` and `master` presets |
- | `motion-blender` | Runs the bundled Blender scripts headless: `turnaround`, `costume`, `template` |
- | `motion-install-skills` | Installs the skills into OpenCode, Cursor or any Agent Skills folder |
- | `motion-doctor` | Checks the environment |
- **Hook.** After Claude writes a film file, `motion-lint` adds determinism warnings to the conversation. It never blocks.
- **motionkit** (`templates/film/motionkit.js`, inlined into every film):
- - closed-form damped springs (any ζ) and the impact squash;
- - ballistic hops and full hop sequences that carry across the loop seam;
- - CSS cubic-bezier easing;
- - tempo ramps;
- - the score timeline;
- - seeded hash noise and periodic loop noise;
- - lens and depth helpers, exact silhouette measurement;
- - an OfflineAudioContext synth (kick, marimba, piano, bass, noise, reverb) with bit-identical pairwise mixing and folded loop tails.
- ## Quick start
- ```bash
- motion-new crate-hop && cd crate-hop
- motion-lint film.html && motion-inspect film.html # about 5 s: stills, contact sheets, all page checks
- motion-render film.html --draft && motion-qa renders/film_draft.mp4 --timing film.html
- motion-render film.html --subframes 16 --capture canvas # final, motion blur + sound
- motion-export renders/film.mp4 && motion-qa renders/film_x.mp4 --timing film.html --delivery
- ```
- Or just ask Claude for a film, for example: "make an 8-second loop of a hamster typing on a giant typewriter, 120 BPM, for X". The `film` skill runs this loop for you.
- ## Verified on
- The template film, rendered and exported by the tools: [docs/crate-hop.mp4](docs/crate-hop.mp4) (8 s loop, 60 fps, with sound). Its contact sheet from `motion-inspect` is [docs/crate-hop-contact.jpg](docs/crate-hop-contact.jpg).
- macOS (Apple M4 Max, Metal), Chrome 157, ffmpeg 9.0.2, Node 22, three.js r187, Blender 5.3. On the template film:
- - every page check and every video check passes;
- - the final render at 8 sub-frames with sound takes 34 s;
- - the X export comes out at -14.2 LUFS and -2.8 dBTP after AAC;
- - the GIF is 1088×612 at 25 fps, 13.6 MB.
- ## Credits and sources
- - The method and every prompt in `references/examples.md`: "The Fable 5.2 Motion Playbook: One Prompt, One Film" by @flxrnc (X).
- - Field reports:
- - Jonathan Edwards, "Fable 5.2: A guide to the best model in the world".
- - Ethan Mollick, `emollick/ai-portals`.
- - Simon Willison's pelican test.
- - Anthropic's Fable 5.2 prompting guide and the Claude Code docs.
- - Specs checked against primary sources: docs.x.com media best practices, the FFmpeg filter docs and source, the Web Audio spec, the three.js r187 source and the Blender 5.3 RNA. See each reference file for details.
- MIT licence.
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.