Validation-first workflow + Kroki fallback

mermaid-skill

Generate, validate, and export Mermaid diagrams to PNG / SVG / PDF — with a validation loop that catches syntax errors before export.

/plugin marketplace add Agents365-ai/365-skills
Microservices architecture diagram generated by mermaid-skill from a single natural-language prompt

Generated from one natural-language prompt — full prompt in the README.

Why This Skill

Claude Code can write Mermaid — this skill closes the loop with validation, export, and proactive triggering.

📊

11+ Diagram Types

Flowchart, sequence, class, ER, state, Gantt, pie, git graph, C4 context, mind map — each with copy-paste syntax templates.

🔍

Validation Loop

Catches syntax errors before export. The skill validates the .mmd file and fixes problems in place, so broken diagrams never leak through.

🎨

PNG / SVG / PDF

Auto-export at 2048px PNG (white background, multiple themes), scalable SVG, or print-ready PDF — pick once and the skill remembers.

🚀

Zero-Install Fallback

No mmdc? The skill auto-falls back to the Kroki API. curl is the only requirement.

Proactive Triggering

Auto-activates when explaining systems with 3+ components, APIs, state machines, or architectures — even when you don't say 'diagram'.

🌐

Bilingual Triggers

Handles English and Chinese diagramming requests — '画一个时序图' triggers just like 'create a sequence diagram'.

Install

Pick your platform. Takes 10 seconds.

# Plugin marketplace (recommended)
/plugin marketplace add Agents365-ai/365-skills
/plugin install mermaid

# Or any agent
npx skills add Agents365-ai/365-skills -g

# Manual install
git clone https://github.com/Agents365-ai/mermaid-skill.git ~/.claude/skills/mermaid-skill
# Global
git clone https://github.com/Agents365-ai/mermaid-skill.git ~/.config/opencode/skills/mermaid-skill

# Project
git clone https://github.com/Agents365-ai/mermaid-skill.git .opencode/skills/mermaid-skill
# Global
git clone https://github.com/Agents365-ai/mermaid-skill.git ~/.openclaw/skills/mermaid-skill
# Via SkillsMP CLI
skills install mermaid-skill
# User-level
git clone https://github.com/Agents365-ai/mermaid-skill.git ~/.agents/skills/mermaid-skill

# Project-level
git clone https://github.com/Agents365-ai/mermaid-skill.git .agents/skills/mermaid-skill

Support

If this skill helps you, consider supporting the author.

WeChat Pay WeChat Pay
Alipay Alipay
Buy Me a Coffee Buy Me a Coffee
Give a Reward Give a Reward

Author

Agents365-ai