← Back to all projects

Diagram Design

Thirty-nine diagram types an agent can draw as self-contained HTML and SVG, without Mermaid's default look

Agent skillMIT
Stars
63.2k
Forks
4.1k
Open issues
46
Last commit
27 Oct 2026

What is Diagram Design?

Asking an agent for a diagram usually returns rounded boxes and arrows that look nothing like the document they are going into, so the diagram gets dropped. This skill gives the agent a vocabulary instead: thirty-nine named layouts — architecture, sequence, swimlane, quadrant, Sankey, fishbone, Wardley map, story map and more — each shipped in light, dark and full-editorial variants as one HTML file with inline SVG. No build step, no JavaScript, no external images: open the file in a browser or drop it into a page. It can also read your site to pick up the brand, and redraw an existing draw.io or Mermaid source at a chosen size and level of detail.

What can you do with Diagram Design?

  • Name the shape you want — Thirty-nine layouts each have a name and a purpose, so "draw this as a Wardley map" produces that, rather than boxes with arrows again.
  • Get one file with nothing to install — Output is a self-contained HTML file with inline SVG — no build step, no JavaScript and no external images to lose track of.
  • Match the document it goes into — It can read a site to pick up colours and type, so a diagram sits in a page rather than looking pasted in from elsewhere.
  • Redraw what you already have — An existing draw.io or Mermaid source can be handed over and reproduced at a chosen format, size and level of detail.
  • Keep the density down on purpose — The skill reserves the accent colour for the one or two things that matter and pushes towards deletion, which is what separates a diagram from a picture of a system.

Before you choose Diagram Design

  • The output is HTML, not an editable diagram file — changes go back through the agent, so this suits a diagram you regenerate rather than one a colleague opens and nudges.
  • Thirty-nine named types is a lot to hold in your head, and picking the wrong one is the usual failure — the type list is worth reading before the first request rather than after.

Star history

29 Aug to 30 Oct · +34.7k

28.5k63.2k

Frequently asked questions

Is Diagram Design free for commercial use?

Diagram Design is released under the MIT licence — OSI-approved open source, which permits commercial use.

How can Diagram Design be deployed?

Diagram Design is available as Runs locally.

Diagram Design
Ask AI
GitHub