Brief it in a sentence.Ship it to every medium.

Your agent storyboards the brief, writes one scene, runs the gate and renders it for your web page, slides, README and video. Every output is the same frame at the same t.

claude plugin marketplace add liqweed/motion-kit
claude · ~/my-docsanimated-diagram

Explain how an order reaches the customer, in plain language.

  • ✓Storyboard: 6 steps, one sentence each. Approved by you.
  • ✓Wrote a sequence specdiagrams/order-flow.json
  • ✓Gate passes: 6 formats × 2 locales.motion-kit check diagrams/order-flow.json
  • ✓Rendered: live player, slide frames, README SVG, 9:16 reel.
  • ◆Waiting for your sign-off on the look.

Illustrative session. The diagrams beside it are the real scenes; the agent’s wording is ours.

JavaScript is off, so the diagrams show their final frame.

Slide16:9 · settled step frame
READMEbaked SVG · zero JS
Reel9:16 · MP4

frame(t) · one scene, four targets

Same t, same bytesRendering a time twice gives identical output, in Node and in the browser.
Settled step framesEvery step is a finished frame you can put on a slide.
Every format × localeSix formats, every language in the spec; labels must fit or the scene fails.
Zero JS where neededBaked SVGs carry no script: they play in a README and hold.

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.
  • bake and video render without running the gate (D2).
  • Custom .mjs scenes 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)
PairNeedsLightDark

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.

Open the gallery →

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-kit
02

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 wide
03

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