mermaid-diagramlisted

Use this skill ANY time the user wants a diagram, chart, or visual documentation of any kind — flowcharts, sequence diagrams, architecture diagrams, ER diagrams, state machines, gantt charts, class diagrams, deployment diagrams, mindmaps, or any visual representation of systems, processes, or relationships. Trigger on: "diagram", "chart", "visualize", "draw", "map out", "document the flow", "show how X connects to Y", or when the user describes states, transitions, timelines, or service interactions that imply a visual even without saying "diagram". Also trigger when the user mentions "mermaid" by name or asks to convert code to a diagram.
petermcalister/shared-skills · ★ 2 · AI & Automation · score 68

Install: claude install-skill petermcalister/shared-skills

# Mermaid Diagram Skill Generate validated Mermaid diagrams from text descriptions or source code. ## How This Skill Works 1. **Determine diagram type** from the user's request 2. **Load the relevant guide** for that type (only what's needed — saves context) 3. **Generate the .mmd file** 4. **Validate via mmdc** — diagrams with syntax errors are useless to the user 5. **Deliver** the validated .mmd and rendered PNG/SVG ## Intent Routing Read only the guide you need for this request: | User's intent | Guide to read | |---------------|---------------| | Workflow, process, business logic | `references/guides/diagrams/activity-diagrams.md` | | Infrastructure, deployment, cloud, K8s | `references/guides/diagrams/deployment-diagrams.md` | | System architecture, components, microservices | `references/guides/diagrams/architecture-diagrams.md` | | API flow, service interactions, sequence | `references/guides/diagrams/sequence-diagrams.md` | | General or unsure which type | `references/mermaid-diagram-guide.md` | All paths are relative to this skill's directory. ## Validation Workflow Unvalidated Mermaid diagrams frequently contain syntax errors — broken arrows, reserved word collisions, unescaped characters — that make them useless. Always validate before delivering. ```bash # Option 1: Use the resilient workflow script (standalone via uv run / PEP 723) uv run ${CLAUDE_PLUGIN_ROOT}/skills/mermaid-diagram/scripts/validate_mermaid.py --code "$(cat diagram.mmd)" --output diagr