Skip to content
Back to search

motion-playbook

MarketplaceWorks with Claude CodeGitHub

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.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/mindburnlabs--motion-playbook/badge.svg)](/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
  1. {
  2. "name": "motion-playbook",
  3. "owner": { "name": "motion-playbook" },
  4. "metadata": { "description": "Code-drawn film and motion tooling for Claude Code." },
  5. "plugins": [
  6. {
  7. "name": "motion-playbook",
  8. "source": "./plugins/motion-playbook",
  9. "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.",
  10. "category": "creative"
  11. }
  12. ]
  13. }
README.md · README · 129 lines
  1. # motion-playbook
  2. 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.
  3. 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.
  4. The method in six steps:
  5. - Write the clock first.
  6. - Replace every adjective with a number.
  7. - Measure the hero.
  8. - Fix on stills.
  9. - Measure motion.
  10. - Press play.
  11. ## Install
  12. The same folder is a Claude Code plugin, a Codex plugin and a set of standard Agent Skills.
  13. **Claude Code**
  14. ```bash
  15. claude plugin marketplace add mindburnlabs/motion-playbook
  16. claude plugin install motion-playbook@motion-playbook
  17. ```
  18. To try it without installing: `git clone https://github.com/mindburnlabs/motion-playbook && claude --plugin-dir motion-playbook/plugins/motion-playbook`.
  19. **Codex**
  20. ```bash
  21. codex plugin marketplace add mindburnlabs/motion-playbook # reads .agents/plugins/marketplace.json
  22. codex plugin add motion-playbook@motion-playbook
  23. ```
  24. 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-]*'`.
  25. 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`.
  26. **OpenCode, Cursor, Pi and other Agent Skills hosts**
  27. ```bash
  28. git clone https://github.com/mindburnlabs/motion-playbook ~/plugins/motion-playbook
  29. ~/plugins/motion-playbook/plugins/motion-playbook/bin/motion-install-skills opencode # or: agents | cursor | claude | <dir>
  30. ```
  31. 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.
  32. **Check the machine:** `motion-doctor` checks Node, the ffmpeg filters, Chrome on the GPU, Blender and uv.
  33. **Requirements:** Node 20+, ffmpeg with libx264, and Google Chrome or Chromium (Playwright's cache works too). Blender 5.x and uv are optional.
  34. ## What's inside
  35. **Skills.** Each is model-invoked and also available as a `/` command.
  36. | Skill | Use |
  37. |---|---|
  38. | `motion-playbook:film` | One prompt to a finished, checked MP4: brief, score, contract, stills, draft, render, QA, export |
  39. | `motion-playbook:brief` | Turns adjectives into a numeric director brief (subject, time grid, hex, lenses, damping ratios, bans, QA, done) |
  40. | `motion-playbook:qa` | Measures a film or MP4 and reports every check with its number |
  41. | `motion-playbook:export` | X MP4 with -14 LUFS / -2 dBTP measured after AAC, a GIF within X's limits, or a ProRes master |
  42. | `motion-playbook:blender-asset` | Costumes and props built by Blender script, with numeric intersection checks and phone-size turnarounds |
  43. | `motion-playbook:studio` | Long films with departments (score, layout, animation, look) and a reviewer that did not build anything |
  44. **Agents.** `motion-reviewer` (read-only; tries to break the film), `motion-score`, `motion-layout`, `motion-animator` and `motion-look`.
  45. **Commands on PATH** (from `bin/`):
  46. | Command | Does |
  47. |---|---|
  48. | `motion-new <dir>` | Scaffolds a working 8 s loop (three.js r187) that already passes every check |
  49. | `motion-timing` | Builds the score: beat grids, linear tempo ramps, events, shots, sound 1 frame after picture; `from-audio` tracks beats with librosa |
  50. | `motion-lint` | Determinism lint: clocks, Math.random, carried state, CSS animation, unpinned CDNs, contract |
  51. | `motion-inspect` | Page QA: GPU, stills, contact sheets, seek (cold = sequential = jump), seam, hero width per shot, hero and text in frame |
  52. | `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 |
  53. | `motion-qa` | File QA: freezedetect, motion graph (`motion.svg`), planned moves, seam, black frames, format, BT.709 tags, faststart, loudness |
  54. | `motion-export` | `x`, `gif` and `master` presets |
  55. | `motion-blender` | Runs the bundled Blender scripts headless: `turnaround`, `costume`, `template` |
  56. | `motion-install-skills` | Installs the skills into OpenCode, Cursor or any Agent Skills folder |
  57. | `motion-doctor` | Checks the environment |
  58. **Hook.** After Claude writes a film file, `motion-lint` adds determinism warnings to the conversation. It never blocks.
  59. **motionkit** (`templates/film/motionkit.js`, inlined into every film):
  60. - closed-form damped springs (any ζ) and the impact squash;
  61. - ballistic hops and full hop sequences that carry across the loop seam;
  62. - CSS cubic-bezier easing;
  63. - tempo ramps;
  64. - the score timeline;
  65. - seeded hash noise and periodic loop noise;
  66. - lens and depth helpers, exact silhouette measurement;
  67. - an OfflineAudioContext synth (kick, marimba, piano, bass, noise, reverb) with bit-identical pairwise mixing and folded loop tails.
  68. ## Quick start
  69. ```bash
  70. motion-new crate-hop && cd crate-hop
  71. motion-lint film.html && motion-inspect film.html # about 5 s: stills, contact sheets, all page checks
  72. motion-render film.html --draft && motion-qa renders/film_draft.mp4 --timing film.html
  73. motion-render film.html --subframes 16 --capture canvas # final, motion blur + sound
  74. motion-export renders/film.mp4 && motion-qa renders/film_x.mp4 --timing film.html --delivery
  75. ```
  76. 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.
  77. ## Verified on
  78. 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).
  79. macOS (Apple M4 Max, Metal), Chrome 157, ffmpeg 9.0.2, Node 22, three.js r187, Blender 5.3. On the template film:
  80. - every page check and every video check passes;
  81. - the final render at 8 sub-frames with sound takes 34 s;
  82. - the X export comes out at -14.2 LUFS and -2.8 dBTP after AAC;
  83. - the GIF is 1088×612 at 25 fps, 13.6 MB.
  84. ## Credits and sources
  85. - The method and every prompt in `references/examples.md`: "The Fable 5.2 Motion Playbook: One Prompt, One Film" by @flxrnc (X).
  86. - Field reports:
  87. - Jonathan Edwards, "Fable 5.2: A guide to the best model in the world".
  88. - Ethan Mollick, `emollick/ai-portals`.
  89. - Simon Willison's pelican test.
  90. - Anthropic's Fable 5.2 prompting guide and the Claude Code docs.
  91. - 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.
  92. MIT licence.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.