← ClaudeAtlas

diagramlisted

Creates or updates a diagram, picking mermaid vs drawio per rules/diagrams.md, writing the source file, and previewing via MCP. Use when the user says 'diagram' or '/diagram', or asks for a flowchart, architecture, sequence, or state diagram.
domengabrovsek/claude · ★ 15 · AI & Automation · score 70
Install: claude install-skill domengabrovsek/claude
Create or update the diagram for: $ARGUMENTS ## Step 1 - Pick the format **why-no-hook:** skill workflow guidance; each step requires understanding the surrounding context (repo, task shape, prior state). Read `rules/diagrams.md` if uncertain. Default to **mermaid** unless one of these triggers fires - then use **drawio**: - Custom shapes, icons, or cloud provider symbols requested `(review-time: see section note)` - Precise grid / column layout (network topology, rack diagrams) `(review-time: see section note)` - More than 2 swimlanes, or nested swimlanes `(review-time: see section note)` - Multi-layer architecture (stacked data/control planes) `(review-time: see section note)` - Color or styling carries semantic weight that mermaid cannot express `(review-time: see section note)` - The user explicitly says "drawio" or "complex" `(review-time: see section note)` If the diagram is borderline, ask the user before committing to drawio. ## Step 2 - Locate the doc - Identify the doc this diagram belongs to. If `docs/` does not exist, ask the user where to put it. `(review-time: see section note)` - Slug the topic from $ARGUMENTS or the parent doc's filename. `(review-time: see section note)` ## Step 3 - Mermaid path 1. Write the mermaid source inline in the target doc using ```` ```mermaid ```` fenced blocks (one block per diagram). `(review-time: see section note)` 2. Match diagram type to purpose: `flowchart` / `sequenceDiagram` / `stateDiagram-v2` / `erDiagram` / `cla