mermaid

Create, validate, and repair Mermaid.js diagrams with rp1 CLI.

38|8|Updated Nov 30, 2025
One-click install
npx skills add https://github.com/rp1-run/rp1 --skill mermaid-rp1-run
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mermaid
Source: https://github.com/rp1-run/rp1/tree/main/plugins/base/skills/mermaid
Command: npx skills add https://github.com/rp1-run/rp1 --skill mermaid-rp1-run

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps create, validate, and repair Mermaid.js diagrams used in documentation and design notes.

Core Features & Use Cases

  • Create diagrams (flowcharts, sequence, class, ER, state, Gantt)
  • Validate syntax with rp1 CLI and categorize errors
  • Repair guidance and integration with fixer agent

Quick Start

Activate the mermaid skill to build and validate diagrams embedded in your Markdown files.

Frequently Asked Questions about mermaid

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

FAQPage Schema
How do I validate Mermaid diagram syntax?

Validate Mermaid diagrams using the rp1 CLI, which categorizes syntax errors into types like ARROW_SYNTAX, QUOTE_ERROR, and CARDINALITY. This error categorization guides targeted fixes for flowcharts, sequence diagrams, class diagrams, ER diagrams, state diagrams, Gantt charts, and other diagram types.

Can I automatically repair broken Mermaid diagrams?

Yes. The Skill detects specific error categories—ARROW_SYNTAX, QUOTE_ERROR, CARDINALITY, LINE_BREAK, DIAGRAM_TYPE, and NODE_SYNTAX—and provides repair guidance to fix syntax issues iteratively. Integration with a fixer agent automates the correction workflow.

What Mermaid diagram types does this Skill support?

The Skill creates, validates, and repairs flowcharts, sequence diagrams, class diagrams, ER diagrams, state diagrams, Gantt charts, and other Mermaid.js diagram types. All diagram categories benefit from syntax validation and error-guided repair.

What's the best way to embed validated diagrams in documentation?

Create and validate Mermaid diagrams in Markdown files using the Skill, which handles syntax checking and repair before embedding. This ensures diagrams render correctly in documentation without runtime errors.

Do I need the rp1 CLI to use this Skill?

Yes. The Skill requires rp1 CLI v0.3.0 or later to perform validation and error categorization. Without it, syntax checking and repair guidance are unavailable.