mermaid-diagram

Purpose

This skill translates verbal or written descriptions of processes, architectures, data models, timelines, and relationships into correct Mermaid diagram syntax. The output is a fenced code block using the mermaid language identifier, which renders natively in Obsidian, GitHub, GitLab, Notion, and any modern Markdown environment.

Mermaid is a text-based diagramming language. It allows diagrams to be version-controlled, diffed, and embedded directly in Markdown files without image uploads. This skill handles the translation from human intent to syntactically correct Mermaid DSL.

When to Use

Invoke this skill when:

• The user asks to "draw", "create", "generate", or "diagram" something
• The user provides a process flow, system architecture, or data model in prose and wants a visual representation
• The user uploads or pastes an existing diagram image and wants its Mermaid equivalent
• The user says "add a diagram to this note" without specifying a tool
• The user explicitly mentions Mermaid, flowchart, sequence diagram, or any diagram type listed below
• The user asks to revise or extend an existing Mermaid diagram
• The user wants to visualize relationships between entities, steps in a process, or states in a system

Do NOT use this skill when: