
diagram-design
Thirteen editorial diagram types for Claude Code. Self-contained HTML + SVG. No shadows, no Mermaid-slop.
The Lens
By Erik Loyd, SaaS CEO and former COO/CFO of an AWS Premier Partner.
Updated Oct 2026
Diagram-design is an agent skill that makes your coding agent draw diagrams a designer wouldn't wince at. Ask in plain words for an architecture sketch, flowchart, sequence diagram, Sankey or Gantt chart, and it picks from more than 40 types and writes one self-contained HTML file with inline SVG. MIT licensed and free.
It's no longer Claude Code only. npx skills add cathrynlavery/diagram-design installs it into Cursor, Codex, Copilot, Gemini CLI, Cline and other skill-aware agents; plugin marketplaces add updates and slash commands. Point it at your website and it pulls your palette and fonts, checks contrast, and every diagram after that matches your brand. It also redraws draw.io, Mermaid and Excalidraw files and exports SVG or PNG.
Solo writers and technical bloggers: install it. Small teams: save a brand profile everyone uses. Larger teams with a design system: test it first, because the style is opinionated on purpose (one accent color, hairlines, no shadows).
The catch: the output is a finished picture, not a source file. Nothing to diff in a pull request, no canvas to drag, and the same prompt can lay out differently twice. For docs that change every sprint, its own README says Mermaid fits better.
Free vs Self-Hosted vs Paid
fully freeFree: Everything. MIT licensed skill, templates and scripts. Per its privacy policy there is no server, no accounts, no analytics and no telemetry.
Self-hosted: Nothing to host. Install with npx skills add cathrynlavery/diagram-design or a plugin marketplace (Claude Code, Codex, GitHub Copilot, Factory Droid, Pi). Saved brand profiles in ~/.diagram-design/profiles/ survive updates, but direct edits to the installed style-guide.md can be overwritten by package updates, so clone and symlink if you customize it. PNG export needs Playwright and Chromium. Diagrams load fonts from Google Fonts unless you ask for system fonts.
Paid: No paid tier. It runs inside an AI agent, so the cost is whatever plan or tokens that agent already uses.
Free and MIT. The only cost is the AI agent you already run it in.
What to do by team size
- Solo
- free; install it and onboard it to your site in about a minute
- Small team
- free; save one brand profile so every diagram matches
- Medium team
- free; good for docs and decks, keep Mermaid for diagrams that change every sprint
- Large team
- free, but check the editorial style against your design system before rolling it out
Get tools like this every Wednesday
One featured tool, three on the radar. No fluff.
A low score is not a verdict on quality. Young and niche tools start low by design. How we calculate scores
Trust Signals
About
- Owner
- Cathryn Lavery (User)
- Stars
- 63,085
- Forks
- 4,127
Also by Cathryn Lavery
Explore Further
More tools in the directory
rea
Reverse engineer anything with agents, from app behavior down to native binaries.
409.4k ★openclaw
Your own personal AI assistant. Any OS. Any Platform. The lobster way. 🦞
393.3k ★everything-claude-code
The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
292.9k ★