diagram

Validate and fix Mermaid diagrams embedded in Markdown files using mmcd and reference guides.

Updated Jan 25, 2026
One-click install
npx skills add https://github.com/codihaus/claude-skills --skill diagram-codihaus
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: diagram
Source: https://github.com/codihaus/claude-skills/tree/main/.claude/skills/diagram
Command: npx skills add https://github.com/codihaus/claude-skills --skill diagram-codihaus

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Mermaid diagrams embedded in Markdown files can be invalid or inconsistent, breaking documentation visuals and automated tooling.

Core Features & Use Cases

  • Validate and fix Mermaid diagrams across Markdown notes and docs.
  • Support core Mermaid diagram types and common syntax errors, with guided fixes.
  • Use case: Ensure architectural diagrams in a project repo render correctly in CI docs.

Quick Start

Run the diagram validator on your Markdown files to detect and fix mermaid blocks.

Frequently Asked Questions about diagram

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

FAQPage Schema
How do I validate Mermaid diagrams embedded in Markdown files?

You validate Mermaid diagrams in Markdown by running this tool to detect syntax errors across multiple blocks and files, then applying guided fixes to ensure correct rendering.

Why do my architecture diagrams break in CI documentation builds?

Architecture diagrams break in CI documentation builds due to invalid or inconsistent Mermaid syntax, which this validator detects and fixes to restore automated rendering.

Can I fix common Mermaid syntax errors across multiple documentation files?

Yes, you can fix common Mermaid syntax errors across multiple documentation files by referencing common-errors guides and applying targeted corrections across your project.

Does this validator support all Mermaid diagram types?

This validator supports core Mermaid diagram types defined in its diagram-types reference, leveraging mermaid-cli (mmdc) to render and validate the specific diagrams embedded in your Markdown.

Do I need mermaid-cli installed to validate Markdown diagrams?

Validating Markdown diagrams requires mermaid-cli (mmdc) because the tool leverages it to render diagrams and detect syntax errors during the validation process.