mermaid

Generate Mermaid diagram syntax from natural language and render SVG/PNG outputs.

Updated Apr 20, 2026
One-click install
npx skills add https://github.com/Anders-planck/opencode-config --skill mermaid-anders-planck
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mermaid
Source: https://github.com/Anders-planck/opencode-config/tree/main/skills/mermaid
Command: npx skills add https://github.com/Anders-planck/opencode-config --skill mermaid-anders-planck

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Mermaid diagrams help teams visualize software designs, data flows, and system interactions without heavy tooling.

Core Features & Use Cases

  • Generate Mermaid syntax from natural language descriptions, code, or refactors.
  • Validate diagrams using mermaid-cli and render previews in SVG/PNG.
  • Use cases include architecture diagrams, sequence flows, class diagrams, and workflow diagrams.

Quick Start

Describe your diagram in plain language to generate a Mermaid file and preview the rendered diagram.

Frequently Asked Questions about mermaid

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

FAQPage Schema
How do I generate Mermaid diagrams from natural language descriptions?

Generating Mermaid diagrams from natural language involves providing a plain text description of your architecture or workflow. The tool translates your description into Mermaid syntax, validates it with mermaid-cli, and renders an SVG or PNG preview.

What is mermaid-cli used for in diagram generation and validation?

Mermaid-cli is used to validate generated Mermaid syntax and render .mmd files into visual outputs. It ensures your architecture, sequence, and class diagrams are syntactically correct before exporting them as SVG or PNG previews.

Can I render SVG and PNG outputs directly from .mmd files?

Yes, you can render SVG and PNG outputs directly from .mmd files. The tool processes the Mermaid syntax within your .mmd files, validates the structure, and generates the corresponding visual diagram outputs.

Does this approach work for software architecture planning and system design reviews?

Yes, this approach works for software architecture planning and system design reviews. It generates Mermaid diagrams from text or code, allowing teams to visualize data flows, system interactions, and class structures during documentation workflows.

What's the best way to update diagrams from code during refactoring?

The best way to update diagrams from code during refactoring is to process your updated code or sketches through the generator. It creates new Mermaid syntax reflecting the changes, validates it with mermaid-cli, and renders a fresh diagram preview.

What types of diagrams can I create using Mermaid syntax?

Using Mermaid syntax, you can create architecture diagrams, sequence flows, class diagrams, and workflow diagrams. These are generated from natural language descriptions or code and rendered as SVG or PNG files for documentation.