01 With your agent
You approve twice: the story, then the look.
Three skills ship in the plugin: animated-diagram, motion-render and project-logo. Everything between your two approvals is mechanical, and the gate checks it. Point at a line, or tab through, to see that stage.
02 Why you can trust the output
A broken diagram never renders. The agent gets the reason instead.
motion-kit check builds every scene in every format and locale and samples it 121 times. Failures name the cause and the fix, so the agent can repair the scene. Pick a mistake.
What the gate does not check
It checks structure, not looks. The spec lists where the docs promise more than the code; these are the ones you would notice.
- How it looks. A human signs off on the storyboard, timing, phone size and dark mode.
bakeandvideorender without running the gate (D2).- Custom
.mjsscenes are checked in English only (D3); a missing translation falls back silently (D4). - The duration limit is 12 s, though the guidance says about 8 s (D1); stagger and entrance timings are not checked (D13).
- All recorded discrepancies
03 Your brand
Same spec. Your colours and type.
A scene names roles, never looks: a node, a connector, the one thing to follow. A style fills eight colour tokens for light and dark and sets a font. The agent checks contrast and shows you a frame first. Describe one, “navy and teal”, and it writes the file.
A style sets colours and a font today. needs: style skins (node, connector, emphasis, pending texture, shadow, backdrop) would let one spec change its drawing, not just its palette.
Contrast check on these values (gate rule G12)
| Pair | Needs | Light | Dark |
|---|
04 Patterns for your pages
Scroll moves the story, one settled step at a time.
Reaching a paragraph jumps the diagram to its step. Nothing scrubs with the wheel, nothing drifts. Ask your agent for this layout, or copy the pattern.
05 Gallery
Diagrams you can step through.
06 Neighbours
When another tool is the better choice
motion-kit makes explainer diagrams that must appear in many media. For footage, audio, rich page motion or maths, use these. Licences checked November 2026.
ToolUse it whenAlongside motion-kit
HyperFramesApache-2.0Video with footage, screen recordings, audio, captions and longer edits.Same seek(t) idea: a motion-kit scene can be a clip through window.__motionKit[id].seek(t).
Remotionsource-availableReact-based video compositions, rich templates, Lambda rendering.Free for individuals and companies of up to 3 people; a company licence otherwise.
Motion Canvas / RevideoMITHand-crafted technical explainer videos with generator timelines.Good for one-off videos; no live-page reuse.
Manim CEMITMathematics and science visuals, equations.Python, video only.
GSAPfree incl. commercialRich page motion, morphing, text splitting.Paused timelines are seekable. Use it for website polish; keep explainers in motion-kit.
MermaidMITStatic diagrams from text; quick structure.Use flowchart or state syntax as input notation, then lay out and animate in motion-kit.
07 Install
Give your agent the skills
Node ≥ 22. PNG and video need @resvg/resvg-js (or Chrome) and ffmpeg. There is no npm package yet.
01
Claude Code plugin
Recommended. The animated-diagram, motion-render and project-logo skills, in every project.
claude plugin marketplace add liqweed/motion-kit
claude plugin install motion-kit@motion-kit02
Clone and try
Check, build and bake the examples yourself.
git clone https://github.com/liqweed/motion-kit
cd motion-kit
node cli/motion-kit.mjs check examples/order-flow.json
node cli/motion-kit.mjs bake examples/order-flow.json \
-o out/order.svg -f wide03
Vendor into your repo
Copies runtime/ and one adapter (slidev, astro or page). Your CI needs no install step.
node cli/motion-kit.mjs vendor <repo>/src/motion-kit \
--adapter astro