mermaid-gen

Installation
SKILL.md

mermaid-gen

Purpose

The mermaid-gen skill provides AI assistants with expert guidance for creating syntactically correct Mermaid diagrams while avoiding common parsing errors that cause rendering failures. This skill focuses on diagram syntax correctness and best practices.

Key Benefits:

  • Error Prevention: Avoid nested quotes, special character issues, and malformed syntax
  • Syntax Mastery: Apply correct patterns for flowcharts, sequence diagrams, state machines, etc.
  • Quality Assurance: Validate diagrams before rendering using proven templates
  • Troubleshooting: Diagnose and fix parse errors systematically
  • Best Practices: Follow standardized naming, styling, and structure conventions

When to Use This Skill

Use mermaid-gen when:

  • Creating new Mermaid diagrams (flowcharts, sequence diagrams, state machines, etc.)
  • Fixing parse errors or rendering issues in existing diagrams
  • Converting written descriptions into Mermaid syntax
Related skills
Installs
5
Repository
ajoslin/dot
GitHub Stars
23
First Seen
Feb 21, 2026