
Diagram Design
Thirty-nine diagram types an agent can draw as self-contained HTML and SVG, without Mermaid's default look
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
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.