Install
You need: Claude Code, Node.js 18 or newer, git and FFmpeg. On Windows and macOS, /umd:doctor installs FFmpeg for you.
1. Add the marketplace and install the plugin. In Claude Code, type:
/plugin marketplace add 1AngelMicka/ultimate-motion-design/plugin install umd@ultimate-motion-design2. Restart Claude Code (or type /reload-plugins), open your project folder and run:
/umd:doctorIt checks Node, FFmpeg and the filters it needs, Playwright and Chromium, and your route's tools (Blender, Manim, Python…). With your approval it installs what is missing:
- Playwright and Chromium go to
~/.umd/runtime, shared by all your projects; nothing is added to your project; - FFmpeg comes through winget (Windows) or Homebrew (macOS). On Linux it gives you the
aptcommand.
3. Start your first project:
/umd:go a 30-second launch video for our app, 16:9Then just type /umd:go each time to carry on.
4. Optional, depending on your route: the useful official skills and MCP servers. See Companion tools; /umd:kickoff suggests the ones that fit your project.
Have your AI agent install the plugin
The /plugin … commands are typed by hand: an agent cannot run them, and claude plugin … is refused from inside a running Claude Code session. Your agent can instead add this block to ~/.claude/settings.json (all your projects) or to the project's .claude/settings.json, merged with what is already there:
{
"extraKnownMarketplaces": {
"ultimate-motion-design": { "source": { "source": "github", "repo": "1AngelMicka/ultimate-motion-design" } }
},
"enabledPlugins": { "umd@ultimate-motion-design": true }
}The plugin loads at the next start of Claude Code (trust the folder if asked). Until then, the CLI below already works.
Use the CLI without the plugin
Everything umd does (rendering, analysis, style library, automatic audit) also works without the plugin, before a restart or from another agent (Codex, Cursor…):
npx github:1AngelMicka/ultimate-motion-design doctorgit clone https://github.com/1AngelMicka/ultimate-motion-design && node ultimate-motion-design/plugins/umd/scripts/umd.mjs styles matchWithout arguments the CLI prints its help. In a clone, npm link puts the umd command on your PATH.
Install for a whole team
In the project folder, run once in your terminal, then commit .claude/settings.json:
claude plugin marketplace add 1AngelMicka/ultimate-motion-design --scope projectclaude plugin install umd@ultimate-motion-design --scope projectYour teammates get the plugin when they open the project in Claude Code and trust the folder. Each of them runs /umd:doctor once on their machine.
Update
Type /plugin marketplace update ultimate-motion-design in Claude Code. For automatic updates: /plugin → Marketplaces → ultimate-motion-design → Enable auto-update.
Uninstall
/plugin uninstall umd@ultimate-motion-design/plugin marketplace remove ultimate-motion-designYour project keeps its .motion/ folder and deliverables; delete them if you no longer want them. The shared Playwright runtime lives in ~/.umd/runtime.