animdiagram

Installation
SKILL.md

animdiagram

Looping animated SVG explainers. One file, one <style> block, all motion as CSS @keyframes. Works in <img>, Markdown, Substack, GitHub. No script, no SMIL, no fonts to load, no build step.

The design discipline comes from diagram-design (deletion first, one accent, complexity budget, 4px grid, orthogonal connectors, static frame must read on its own). The motion grammar is distilled from the animated figures in SpacetimeDB's "How does Spacetime scale" series: packets on a shared story clock, arrival rings, destination glows, idle ticks, ambient streams, phase captions, growing bars, state swaps.

References load on demand:

Need File
Tokens, type ramp, node treatments, badges, light skin references/style-guide.md
Grid, connectors, nodes, zones, tiles, legend, anti-patterns references/layout.md
Motion primitives, timing math, budgets, reduced motion references/motion-grammar.md
Brief + event list → spec.json format for timeline.py references/storyboard.md
Pre-ship taste gate references/checklist.md

Assets: assets/template.svg (dark), assets/template-light.svg, worked example assets/example-async-jobs.svg + .spec.json.


Installs
1
First Seen
Sep 4, 2026
animdiagram — praveenvijayan/animdiagram