Mermaid Diagrams

Produce valid Mermaid source that communicates relationships more clearly than prose.

Routing

• Choose Mermaid by default for Markdown-native diagrams.
• Choose ../plantuml/SKILL.md for strict UML notation, detailed C4, or .puml output.
• Choose ../processon-diagram-generator/SKILL.md when the user explicitly wants ProcessOn or hosted editable rendering.
• Do not ask the user to choose a tool when the context already determines a safe default.

Workflow

1. Extract entities, states, decisions, messages, or dependencies from the request and available source.
2. Select the smallest suitable diagram type.
3. Generate syntactically complete Mermaid source.
4. Keep labels concise and quote labels containing punctuation, parentheses, or special characters.
5. Validate the structure and, when a Mermaid renderer is available, render it before delivery.
6. Save a file only when the user asks for a file or the diagram belongs in an existing document.