mermaid-diagram

Generate Mermaid diagrams from user requirements and validate syntax.

Updated Apr 8, 2026
One-click install
npx skills add https://github.com/KYRIE66nb/codex-omx-public-config --skill mermaid-diagram-kyrie66nb
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mermaid-diagram
Source: https://github.com/KYRIE66nb/codex-omx-public-config/tree/main/home/.codex/skills/mermaid-diagram
Command: npx skills add https://github.com/KYRIE66nb/codex-omx-public-config --skill mermaid-diagram-kyrie66nb

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill translates user requirements into ready-to-render Mermaid diagrams, automating diagram code creation, validation, and output storage.

Core Features & Use Cases

  • Automatic diagram type selection and syntax-aware generation
  • Output to figures/ with both .mmd (raw Mermaid code) and .md (preview wrapped in a code block)
  • Real-world use: convert a user story into a sequence or flowchart, then export ready-to-render diagram files for documentation

Quick Start

Generate a Mermaid diagram from the user’s requirements and save the raw code to figures/<diagram-name>.mmd and a wrapped preview to figures/<diagram-name>.md.

Frequently Asked Questions about mermaid-diagram

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

FAQPage Schema
How do I generate Mermaid diagrams from text requirements automatically?

You can generate Mermaid diagrams by providing your text requirements to the tool. It translates the input into ready-to-render diagram code, selects an appropriate diagram type automatically, and saves the output directly to your figures directory.

What diagram types are supported by automated Mermaid visualization tools?

Automated Mermaid visualization tools support multiple diagram types including flowcharts, sequence diagrams, class diagrams, ER diagrams, and Gantt charts. The generation process selects the correct syntax based on your specific requirements.

How do I validate Mermaid syntax before adding diagrams to documentation?

To validate Mermaid syntax before adding diagrams to documentation, the tool performs syntax validation using Mermaid CLI during generation. It enforces a structured workflow with pre-flight checks and a final visual review to ensure error-free output.

Does Mermaid diagram generation save both raw code and markdown preview files?

Yes, Mermaid diagram generation saves both raw code and markdown preview files. It outputs the raw Mermaid code as a .mmd file and a wrapped preview as a .md file directly in the figures directory for documentation use.

What is the best way to convert a user story into a sequence or flowchart diagram?

The best way to convert a user story into a sequence or flowchart diagram is to use an automated generation tool. It parses your requirements, selects the correct diagram type, generates the syntax-verified Mermaid code, and exports ready-to-render files.