mermaid-diagram-generator

SKILL.md

Mermaid Diagram Generator Skill

Purpose

This skill automatically converts text descriptions of system architectures, module specifications, workflow documentation, and design concepts into valid Mermaid diagram syntax. It enables clear visual communication of complex systems, ensuring diagrams are production-ready and embeddable in markdown documentation.

When to Use This Skill

Architecture Visualization: Convert architecture descriptions into flowcharts or block diagrams

Module Relationships: Create diagrams showing how brick modules connect via their studs (public contracts)

Workflow Documentation: Visualize workflow states, decisions, and transitions (DDD phases, investigation stages)

System Design: Display system components, data flow, and interactions

Sequence Diagrams: Show agent interactions, request/response patterns, or call sequences

Class Hierarchies: Document module structure and class relationships

State Machines: Model workflow states and valid transitions

Entity Relationships: Display data model structures and relationships

Timeline Planning: Create Gantt charts for project phases or milestones

Supported Diagram Types