mermaid-draw

Installation
SKILL.md

mermaid-draw

Write Mermaid (and DOT) that renders on the first try and still reads as a diagram, not as arrow soup. LLM Mermaid fails in two separate ways: the parser rejects it (unquoted punctuation, a lowercase end, -> arrows), or it renders fine and nobody can read it (25 nodes, generic labels, a theme that changed under Mermaid 12). This skill fixes both with constraints on the source and a deterministic loop around it, inside one fixed budget.

When NOT to use

  • The idea has no format yet and the destination is a feed, article, or slide → diagram-brief first (it may route to illustration-draw).
  • Reviewing or fixing a diagram someone else wrote → diagram-review.
  • Editable draw.io/FigJam output, C4 modelling, or a deck → the handoffs in diagram-brief's catalog.

Budget (the whole skill runs inside it)

Installs
8
First Seen
Sep 14, 2026