mermaid

Generate Mermaid diagrams from plain text descriptions for documentation.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/cuozg/oh-my-unity --skill mermaid-cuozg
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mermaid
Source: https://github.com/cuozg/oh-my-unity/tree/main/skills/mermaid
Command: npx skills add https://github.com/cuozg/oh-my-unity --skill mermaid-cuozg

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Mermaid diagrams help teams visualize complex software systems, workflows, and data relationships that are difficult to grasp from text alone.

Core Features & Use Cases

  • Generate Mermaid diagrams (flowcharts, sequence diagrams, state machines, and class diagrams) from plain descriptions.
  • Embed diagrams in documentation, PRs, wikis, or design notes to improve communication.
  • Use cases include architecture diagrams, data-flow mappings, and process visualizations.

Quick Start

Provide a subject and diagram type, and I will output a Mermaid code block ready for embedding.

Frequently Asked Questions about mermaid

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate a flowchart from plain text for my documentation?

To generate a flowchart from plain text, provide a subject and diagram type to output a Mermaid code block. This block is ready for embedding directly into documentation, wikis, or PRs to visualize processes.

Can I use Mermaid syntax to map system architecture and data flows?

Yes, you can use Mermaid syntax to map system architecture and data flows. It transforms plain text descriptions into visual diagrams, making complex software systems and data relationships easier to grasp.

What is the best way to create sequence diagrams for pull requests?

The best way to create sequence diagrams for PRs is converting plain descriptions into Mermaid-compatible diagrams. Proper code-block formatting ensures the sequence flows render correctly when embedded in pull request comments.

Does this approach support class diagrams and state machines?

Yes, this approach supports class diagrams and state machines. You can generate both from plain text descriptions to visualize class relationships and state transitions across your technical documentation.

Do I need Mermaid syntax support to embed these diagrams?

Yes, you need Mermaid syntax support and proper code-block formatting in your target environment. The outputs are Mermaid-compatible diagrams, so your documentation platform, wiki, or PR viewer must render Mermaid.