What are the best diagram skills for Claude Code?
design-doc-mermaid leads at 44,104 installs (skills.sh registry): it turns specs and existing code into Mermaid flows, sequences and deployment diagrams. excalidraw-diagram-generator has 28,737 installs for editable whiteboard output, and diagram-design has 4,313 installs from a 30,989-star repo (GitHub) for visual polish.
By Skillselion, an Ellelion LLC publication · Updated September 5, 2026 · 3 min read · Stats verified against the live catalog
Ask Claude Code for an architecture diagram without a skill loaded and you get a Mermaid block that parses, renders, and explains nothing: every box the same size, arrows crossing, no hierarchy. The diagram skills in the docs and planning catalog fix different halves of that problem.
Key takeaways
- design-doc-mermaid is the most-installed option at 44,104 installs (skills.sh registry), and it writes the surrounding design doc, not just the diagram.
- excalidraw-diagram-generator has 28,737 installs from
github/awesome-copilot, a repo with 38,647 stars (GitHub). - diagram-design is the visual-quality option: 4,313 installs from a repo with 30,989 stars (GitHub).
- Mermaid renders in GitHub, GitLab and most docs pipelines. Excalidraw produces an editable file. Pick by where the diagram has to live, not by installs.
- Diagram skills belong to two different categories in our catalog, Documentation and Design & UI/UX, which is why a single search rarely surfaces all of them. Browse both from the docs and planning hub.
Why do agent-generated diagrams come out unreadable?
The model optimizes for valid syntax, not for reading order, and nothing in a bare prompt tells it what a good diagram looks like. Mermaid will happily render forty nodes on one canvas. A diagram skill supplies the missing constraints: how many nodes before you split the view, which direction the flow runs, when a sequence diagram beats a flowchart. That is the whole value, and it is why a 4,313-install skill like diagram-design can beat a 44,104-install one on visual quality while losing on breadth.
What is the best diagram skill for Claude Code?
design-doc-mermaid is the default pick at 44,104 installs (skills.sh registry). It turns plain-text specs, architecture notes or existing code into activity flows, sequence diagrams, deployment views and system diagrams, and it frames them inside a design document rather than emitting a lone code block.
npx skills add https://github.com/SpillwaveSolutions/design-doc-mermaid
The two alternatives worth knowing: excalidraw-diagram-generator at 28,737 installs, from GitHub's own awesome-copilot repo (38,647 stars), and baoyu-diagram at 13,802 installs from a repo with 25,655 stars. The full ranked list lives on best skills for docs and planning.

When should you pick Excalidraw over Mermaid?
Pick by the destination file. Mermaid is text, so it lives in the repo, diffs in pull requests, and renders natively on GitHub; the syntax is documented at mermaid.js.org. Excalidraw produces a canvas file someone can drag around afterwards, which suits whiteboard sketches and workshop artifacts more than versioned architecture docs. excalidraw-diagram-generator (28,737 installs) covers the second case; mermaid-diagrams (4,837 installs, 2,427 stars) is a lighter option for the first when you do not want a full design doc.
Which skill makes diagrams that look designed?
diagram-design, at 4,313 installs from a repo with 30,989 stars (GitHub), is the one to reach for when the diagram is going in front of people rather than into an architecture folder. It is filed under Design & UI/UX in our catalog rather than Documentation, which reflects what it optimizes for: spacing, grouping and visual hierarchy over exhaustive coverage. Pair it with the UI design hub when the diagram ships inside a product surface.
npx skills add https://github.com/cathrynlavery/diagram-design --skill diagram-design
A complete starter stack
design-doc-mermaid(44,104 installs) for architecture and specs that live in the repo.diagram-design(4,313 installs, 30,989 stars) when the diagram is for an audience outside the team.excalidraw-diagram-generator(28,737 installs) for editable whiteboard output.- diagram-creator (4,212 installs) if the diagram has to land in a slide deck or document.
Common pitfalls
- Asking for one diagram of the whole system. Ask for one diagram per boundary, then link them; the skills follow that instruction and the model will not volunteer it.
- Generating Mermaid for a destination that cannot render it. Confluence, Notion and many static site generators need a plugin or a pre-rendered image.
- Letting the agent invent component names. Point the skill at the real files first, or the diagram documents a system that does not exist.
Start with design-doc-mermaid, and add diagram-design the first time a diagram has to leave the repository.
Common questions
What is the best diagram skill for Claude Code?
design-doc-mermaid, at 44,104 installs (skills.sh registry). It converts specs, notes or existing code into Mermaid activity, sequence and deployment diagrams inside a design document. See design-doc-mermaid.
Can Claude Code generate Mermaid diagrams without a skill?
Yes, but the output is usually flat: valid syntax with no reading order or grouping. A skill supplies the layout constraints. Compare the options on best skills for docs and planning.
Which diagram skill produces Excalidraw files?
excalidraw-diagram-generator, at 28,737 installs from github/awesome-copilot, a repo with 38,647 stars (GitHub). See excalidraw-diagram-generator.
What is the diagram-design skill?
A visual-quality diagram skill with 4,313 installs from a repo carrying 30,989 stars (GitHub), filed under Design & UI/UX rather than Documentation. It prioritizes spacing and hierarchy over coverage. See diagram-design.
Should architecture diagrams use Mermaid or Excalidraw?
Mermaid when the diagram lives in the repository and has to diff in pull requests; Excalidraw when someone needs to edit the canvas afterwards. Both are covered on the docs and planning hub.
Ranked by Skillselion - an independent directory of AI-coding tools, not affiliated with Anthropic, OpenAI or Cursor. Tool rankings reflect real adoption (installs, then GitHub stars) from the skills.sh registry and GitHub, last updated September 5, 2026.