Agent skill · writing content · erichowens
mermaid-graph-writer
Writes precise, well-structured Mermaid diagrams for any visualization need. Use when creating flowcharts, sequence diagrams, state machines, ER models, timelines, mindmaps, Gantt charts, or
Why this skill is useful
Provides specific Mermaid syntax structures and diagram type selections that the AI wouldn't reliably generate on its own.
What it needs
About 5k tokens when loaded. Last updated 2026-07-14. 180 stars on the source repository.
What this skill does
Mermaid Graph Writer Writes precise, well-structured Mermaid diagrams. Selects the optimal diagram type for the content, uses correct syntax, and produces diagrams that are readable by both humans (rendered) and agents (text DSL). --- When to Use ✅ Use for: Creating any Mermaid diagram from a description or data Choosing the right diagram type for a visualization need Refactoring prose decision trees into Mermaid flowcharts Modeling system architectures, protocols, state machines, data models Encoding temporal knowledge as timeline diagrams ❌ NOT for: Rendering/exporting Mermaid to PNG/SVG/PDF (use mermaid-graph-renderer) ASCII art or Unicode box-drawing (use diagramming-expert) GUI-based design tools (Figma, etc.) --- Diagram Type Selection Quick Reference Content Type Direction --------- ------ ----------- Decision tree / process flowchart TD Top-down for decisions, LR for processes API protocol / agent comms sequenceDiagram Always vertical (implicit) Lifecycle / status machine stateDiagram-v2 Automatic layout Database / data model erDiagram Automatic layout "What changed when" timeline Horizontal chronological Taxonomy / brainstorm mindmap Radial from root Project schedule gantt Horizontal timeline Category proportions pie Circular Effort vs. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills erichowens/mermaid-graph-writer