Agent skill · design visual · axtonliu
mermaid-visualizer
Transform text content into professional Mermaid diagrams for presentations and documentation. Use when users ask to visualize concepts, create flowcharts, or make diagrams from text. Supports process flows, system architectures, comparisons, mindmaps, and more with built-in syntax error prevention.
Why this skill is useful
Provides specific syntax rules and configuration options for generating Mermaid diagrams that the AI wouldn't reliably generate on its own.
What it needs
About 5k tokens when loaded. Last updated 2026-06-26. 3,277 stars on the source repository.
What this skill does
Mermaid Visualizer Overview Convert text content into clean, professional Mermaid diagrams optimized for presentations and documentation. Automatically handles common syntax pitfalls (list syntax conflicts, subgraph naming, spacing issues) to ensure diagrams render correctly in Obsidian, GitHub, and other Mermaid-compatible platforms. Quick Start When creating a Mermaid diagram: 1. Analyze the content - Identify key concepts, relationships, and flow 2. Choose diagram type - Select the most appropriate visualization (see Diagram Types below) 3. Select configuration - Determine layout, detail level, and styling 4. Generate diagram - Create syntactically correct Mermaid code 5. Output in markdown - Wrap in proper code fence with optional explanation Default assumptions: Vertical layout (TB) unless horizontal requested Medium detail level (balanced between simplicity and information) Professional color scheme with semantic colors Obsidian/GitHub compatible syntax Diagram Types 1. Process Flow (graph TB/LR) Best for: Workflows, decision trees, sequential processes, AI agent architectures Use when: Content describes steps, stages, or a sequence of actions Key features: Swimlanes via subgraph for grouping related steps Arrow labels for transitions Feedback loops and branches Color-coded stages Configuration options: layout: "vertical" (TB), "horizontal" (LR) detail: "simple" (core steps only), "standard" (with descriptions), "detailed" (with annotations) style: "minimal", "professional", "colorful" 2. Circular Flow (graph TD with circular layout) Best for: Cyclic processes, continuous improvement loops, agent feedback systems Use when: Content emphasizes iteration, feedback, or circular relationships Key features: Central hub with radiating elements Curved feedback arrows Clear cycle indicators 3. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills axtonliu/mermaid-visualizer