AgentIndex icon
AgentIndex
ToolsMCP ServersHOTCategoriesTrendingNewBest ListsCompareGuides
Submit Tool
ToolsMCP ServersHOTCategoriesTrendingNewBest ListsCompareGuides
Home/
Dev Tooling/
diagram-design
diagram-design logo

diagram-design

Active·★ 67.9k·MIT·Updated 2026-11-12
★ Most Popular

diagram-design is an agent skill developed by Cathryn Lavery (LittleMight) that renders publication-grade technical and architectural diagrams directly as single, self-contained HTML and SVG files. Supporting 45 distinct diagram archetypes—ranging from cloud infrastructure topology and microservice sequences to quadrant trade-off matrices and user journeys—it explicitly eschews generic 'Mermaid slop' in favor of clean typographic hierarchy, pan-and-zoom controls, and native dark mode support.

A key distinguishing feature is its brand onboarding capability. By issuing a command like `/onboard https://yoursite.com`, the skill automatically inspects the target website's color palette, surface contrasts, and typography choices, storing these brand tokens so that every subsequently generated diagram matches the organization's existing visual identity without manual styling prompts.

The skill installs universally across Claude Code, Codex, Cursor, Gemini CLI, and Windsurf via `npx skills add cathrynlavery/diagram-design` or via Claude Code's plugin marketplace. The output is a standalone vector file that opens in any browser. However, teams should note that diagrams are rendered as immutable SVG code rather than editable node graphs (such as Draw.io or Excalidraw); structural revisions require prompting the agent to regenerate the coordinate layout, which can consume significant token budgets on dense networks.

This write-up is based on the project's README and public repository data. We have not hand-tested the tool. Data as of 2026-11-12.

License
MIT
Latest release
No GitHub releases
Last commit
2026-11-10
Contributors
71
Forks
4,421
Open issues and PRs
49
First published
2026-04-16

Source: GitHub, npm and PyPI public APIs.

#agent-skills#claude-code#codex#data-visualization#dev-tooling#diagrams#drawio#mermaid
$ Install
$ npx skills add cathrynlavery/diagram-design
↗ Visit site★ GitHub
01

Features

01Diagram-type guidance and HTML/SVG output
02Brand palette and font onboarding
03Documented draw.io, Mermaid and Excalidraw imports with PNG/SVG export
02

Why choose it

+Covers 45 diverse diagram types with polished typography, crisp SVG vectors, and dark mode.
+Outputs single self-contained HTML/SVG files with built-in pan/zoom that run in any browser.
+Brand onboarding automatically extracts site palettes and fonts to maintain consistent styling.
+Broad runtime compatibility across Claude Code, Cursor, Codex, Copilot, and Gemini CLI.
03

Trade-offs

!Generates static SVG geometry rather than interactive editable canvas nodes (like Draw.io or Excalidraw).
!Dense architectural graphs require extensive coordinate calculations, consuming noticeable agent tokens.
!High-resolution PNG and PDF exports require headless browser CLI tools such as Playwright.
!Complex multi-branch routing can occasionally produce overlapping connection lines on very large diagrams.
04

Maintenance check

ActiveChecked: 2026-11-12
Last commit
2026-11-09
Commits, last 90 days
100+
Releases, last 90 days
0
Latest release
—
Open issues
49
Recent issues with at least one comment
3/15
Commits per week, last 12 weeks
Commits per week, last 12 weeks: 3, 3, 24, 22, 0, 36, 59, 73, 20, 32, 12, 22

Oldest week on the left; the latest four weeks are orange. Source: GitHub commit activity.

Status rule: archived on GitHub = Archived; last commit within 90 days = Active; 91 to 365 days = Slowing; older = Stale. All figures come from the GitHub API on the date shown.

Most discussed open issues

  • #62 Proposal: new dataviz types — treemap, sankey, slopegraph + more12 comments · 2026-08-15
  • #130 [Feature]: SBGN Diagrams5 comments · 2026-08-20
  • #252 [Feature]: Route strip — sites along a linear asset on an honest metric axis (pattern on Timeline)3 comments · 2026-09-25
  • #251 [Feature]: Physical link topology — named ports, open ring points and link bundles on Deployment3 comments · 2026-09-25
  • #250 [Feature]: Port cross-connect — a semantic pattern on Database schema3 comments · 2026-09-25

Issue titles are quoted from GitHub. Open the link to check whether a problem still applies to the version you use.

05

Compatibility

Agent Skills
Claude Code, Codex, Cursor and other Skill-capable hosts
Verified via docs
Web browser
View generated HTML and SVG artifacts
Verified via docs
06

Quick start

1
$ npx skills add cathrynlavery/diagram-design
07

Use cases

↳Explaining a software architecture visually
↳Creating a branded process or sequence diagram
↳Adapting an existing diagram into an HTML handoff
08

Alternatives

⚡Top VS:
VStaste-skill★117.7k→VSskills★57.8k→VSdarwin-skill★7.0k→VSskills★4.0k→
taste-skill logo
taste-skill★ 117.7k
Agent skills that give coding agents taste: art direction, reference images and a browser check instead of generic AI pages
VSCompare→
skills logo
skills★ 57.8k
Skills for Designers and Engineers.
VSCompare→
darwin-skill logo
darwin-skill★ 7.0k
达尔文.skill —— 一个让你的Skill无限进化的系统:评估→改进→测试→保留或回滚 | Autoresearch-inspired autonomous skill optimization for Claude Code. Evaluate, improve, test, keep or revert.
VSCompare→
skills logo
skills★ 4.0k
Agent Skills for NVIDIA products — install into Claude Code, Codex, and other coding agents to run Physical AI, robotics, simulation, CUDA, and RAG workflows end to end.
VSCompare→
ex-ussr-kinship-research logo
ex-ussr-kinship-research★ 2.6k
Evidence-first genealogy skill for AI agents (Codex, Claude Code): church books, civil, military, deportation and repression records across the former USSR. Replies in your language.
VSCompare→
beautify-github-readme logo
beautify-github-readme★ 2.0k
README design skill for Claude Code & Codex. 帮你把 GitHub README 做得好看又好懂。
VSCompare→
claude-code-my-workflow logo
claude-code-my-workflow★ 1.7k
A ready-to-fork Claude Code template for academic research — papers, data analysis (R, Stata, Python), slides and teaching — with multi-agent review, enforced quality gates and replication protocols. Codex and Antigravity can use it too.
VSCompare→
skills logo
skills★ 1.5k
Reusable AI agent skills for software factories: explore ideas, write specs, implement, review, and run autonomous research. Works with Claude Code, Codex, and other skill-compatible agents.
VSCompare→
See all alternatives →

Comments

Log in to leave a comment

No comments yet. Be the first!

On this page
01Features02Why choose it03Trade-offs04Maintenance check05Compatibility06Quick start07Use cases08Alternatives
cathrynlavery /
diagram-design
↗

Editorial architecture and system diagrams as self-contained HTML and SVG files

67.9k4.4kMIT
Last commit6d ago
StatusActive
CategoryDev Tooling
Contributors71
Links
Documentation↗Discussion↗Issues↗Releases↗
Cloud Infrastructure
Ad

Deploy on DigitalOcean

Host your MCP servers, Docker containers, and AI agents with $200 free credit over 60 days.

Claim $200 Free Credit
© 2026 AgentIndex.app|Built by a 10-year iOS Developer.
Best by use caseAboutContactAdvertisePrivacy PolicyTerms of UseQYSGitHubBuy me a coffee ☕

Browse by Category

MCP ServersCode AssistantWorkflow AutomationRAG / Knowledge BaseMulti-AgentBrowser AutomationLLM InfraDev ToolingObservability

Not affiliated with Anthropic, OpenAI or Microsoft.