What problem does it solve? Writing architecture and process documentation often requires diagrams, but hand-crafting Mermaid syntax is error-prone and diagrams frequently fail to render or add no informational value. This Skill produces validated, semantically precise Mermaid diagrams that compress complex information into clear visuals. ## Core Features & Use Cases - Diagram Type Selection: Automatically maps content patterns to the right Mermaid type — C4 context/container, flowchart, sequence, ER, state, Gantt, mindmap, quadrant, class, gitgraph, and journey diagrams. - Composition & Validation Rules: Enforces syntax validity for Mermaid v10+, a 20-node limit, labeled edges, semantic styling, and accessibility text summaries for every figure. - Deliverable Integration: Embeds diagrams in Markdown or HTML deliverables with figure numbering and evidence tags, following a per-deliverable diagram catalog. - Use Case: Given a documented checkout architecture, produce a C4 container diagram plus a sequence diagram of the API authentication flow, ready to embed in a technical analysis document. ## Quick Start Ask the assistant to create a Mermaid sequence diagram of your API authentication flow using the mermaid-diagramming skill.