Mermaid Diagram Generator

Converts architecture descriptions, specs, and workflow docs into valid Mermaid diagram syntax. You feed it prose about how your system works and it outputs flowcharts, sequence diagrams, class diagrams, state machines, ERDs, or Gantt charts ready to drop into markdown. Supports the common use cases like visualizing module relationships, agent interactions, DDD workflow phases, and data models. The skill walks through identifying the right diagram type for your source material, extracting entities and relationships, then generating clean Mermaid code. Beats manually writing Mermaid syntax when you're documenting architecture or need to turn meeting notes into actual diagrams. Just be ready to tweak node labels if your source descriptions are ambiguous.

install copies · 90 days. Times the install command was copied on this site in the last 90 days, bots filtered.: 7
skills.sh installs: 429
GitHub stars: 76
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add rysweet/amplihack --skill mermaid-diagram-generator --agent claude-code

Installs into .claude/skills of the current project.

Files

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