Diagram Design (cathrynlavery/diagram-design)Partly tested🌏 World

Cathryn's (@cathrynlavery) Diagram Design has Claude Code / Codex / Cursor draw self-contained HTML+SVG architecture diagrams from one sentence, with its visual rules written as hard constraints instead of Mermaid's rounded gray-blue boxes

Cathryn Lavery (@cathrynlavery) open-sourced Diagram Design (MIT, ~61k★ on GitHub, diagramdesign.dev): a diagram skill for Claude Code, Codex, Cursor, Copilot and peers. The agent picks one of 45 types (architecture, sequence, Sankey, exploded axonometric…), then writes a double-clickable .html. Defaults ban shadows, allow one accent color, and snap geometry to a 4px grid. You can onboard a site URL for palette/fonts, or import draw.io / Mermaid / Excalidraw and export PNG/SVG. Chinese posts by @Zen_with_AI and @dngzsn37461 recently shared the install line and a practical order of use. We cloned the repo, syntax-checked the Python scripts, ran self_check on a shipped example HTML, and extracted a two-node Mermaid digest; we did not open a live Claude Code session to draw a new diagram.

Visit site Diagram Design (cathrynlavery/diagram-design) ↗
Pricing
Free
Region
Global
Where it's from
Overseas
Added
Oct 26, 2026
Tested on
Oct 26, 2026
Version we used
Diagram Design v2.6.128 (plugin.json); repo cathrynlavery/diagram-design ~61k★ as of 2026-10-26
Categories
DesignProductivity
Original author
Cathryn Lavery @cathrynlavery ↗
Our test
Partly tested
Cost / time
The skill is free (MIT). You still need your Claude Code / Codex / Cursor plan or API. Export scripts need local Python / a browser.
Source
X @Zen_with_AI(中文介绍) ↗X @dngzsn37461(实操顺序) ↗X @cathrynlavery(50k★) ↗GitHub cathrynlavery/diagram-design ↗diagramdesign.dev ↗

The task

Have a coding agent produce architecture, sequence, Sankey and other diagrams for tech specs, fundraising decks and integration docs—self-contained and brandable, not default Mermaid rounded boxes.

Steps

  1. Install: `npx skills add cathrynlavery/diagram-design` (Claude Code: `/plugin marketplace add cathrynlavery/diagram-design` then `/plugin install diagram-design@diagram-design`; Codex has matching marketplace commands).
  2. On the first diagram in a project, the skill checks whether the style guide is still the shipped paper/ink/coral defaults; onboard a site URL, paste tokens, or keep the default on purpose.
  3. Ask in plain words, e.g. "architecture of frontend, backend, database, Redis"; sequence, quadrant and Sankey work too. The agent should state the type and plan, then write one `.html`.
  4. Open the file by double-clicking or in a browser; export PNG/SVG via the repo scripts when you need to embed.
  5. Existing drafts: import draw.io / Mermaid / Excalidraw for a redraw; check node names and edges before trusting the import so facts are not rewritten.
  6. Practical order from Chinese write-ups: install → one architecture prompt and open the .html → onboard the site for palette/fonts → only then batch diagrams for docs.

Prompt

Use diagram-design to draw an architecture diagram of frontend, backend, database and Redis as a self-contained HTML file I can open directly.

What the author says

The README / site claim 45 diagram types, self-contained HTML+SVG, no shadows, one accent, geometry on a 4px grid; site onboarding for palette/fonts; import from draw.io / Mermaid / Excalidraw and export PNG/SVG. Cathryn's X posts have shown 3D exploded views and database-schema examples; the repo is ~61k★. Chinese posts highlight the one-liner install and a try-then-batch workflow.

Our test

We did not open a Claude Code / Codex session to draw a new diagram. Shallow clone: plugin.json version 2.6.128; SKILL.md documents 45 types plus one-accent / 4px-grid rules; ~63 files under references/; `python3 -m py_compile` passes on scripts/*.py; self_check passes on assets/example-sequence-full.html; mermaid_extract produced an IR from a two-node flowchart. Stars were ~61,046 when checked on 2026-10-26.

What we found when we tried it:Public files match the install story; shipped example HTML opens as a self-contained page. Live natural-language generation quality and brand onboarding were not verified by us.

How to get in

GitHub and diagramdesign.dev are public; Chinese write-ups are on X (login may be required). The skill installs into a local agent with no geo wall.

Who it suits

People who ship architecture and process diagrams from coding agents and are tired of default Mermaid looks; also useful to restyle old draw.io / Mermaid drafts to a brand.

Pitfalls

  • Layouts can change between runs; you cannot drag boxes like in Figma—re-prompt or edit the SVG.
  • Before importing an old diagram, verify nodes and edges: extractors only pull structure, and the agent may rewrite facts while "cleaning up".
  • Accent color is for 1–2 focal nodes; painting everything coral erases the signal.
  • Official builds come only from this repository; other listings are unofficial copies (see PRIVACY.md).
  • A standalone `npx skills add` install does not auto-follow marketplace upgrades; use `npx skills update` or switch to the marketplace.

More in this category