Does it check for C4 model specific standards?

Absolutely. It verifies specific C4 syntax such as correct keyword usage for System/Person definitions and ensures the four required arguments for 'Rel()' are present.

How do I use this to prevent CI/CD failures?

You can use this skill within your Claude Code environment to validate all '.md' files globally before pushing, or reference its logic to build a GitHub Action workflow.

What types of Mermaid diagrams does this skill support?

The skill supports a wide range of types including C4 models (Context, Container, Component), Sequence Diagrams, Flowcharts (graphs), and Entity Relationship Diagrams (ERD).

Can it fix my Mermaid diagrams automatically?

Yes, it includes automatic correction rules for indentation normalization, quote completion for special characters, and arrow notation unification.

Does it work with non-English characters in diagrams?

Yes, the skill is optimized to handle multi-byte characters like Japanese, applying specific quoting rules only where necessary to ensure correct rendering.

Mermaid Validator

Name: Mermaid Validator
Author: sk8metalme

bysk8metalme

0•

콘텐츠 관리

Validates and automatically corrects Mermaid diagram syntax in Markdown files to ensure error-free documentation rendering.

Mermaid Validator is a specialized Claude Code skill designed to maintain the integrity of visual documentation. It automatically scans Markdown files for Mermaid diagram blocks—including C4 models, sequence diagrams, flowcharts, and ERDs—to detect common syntax errors like unclosed brackets, improper indentation, or invalid keyword usage. By providing automated fixes and following structural best practices, it ensures that architectural and design documents render correctly in viewers and CI/CD pipelines without the need for manual debugging.

주요 기능

01Automated syntax error detection for C4 models, Sequence diagrams, Flowcharts, and ERDs

02Validation of C4 model parameters, ensuring mandatory arguments are present for relationships

03Standardization of arrow notation and participant declarations in sequence diagrams

04Intelligent correction of indentation and quoting for subgraphs and complex labels

05Pre-commit style verification to prevent parsing failures in Markdown-based documentation

060 GitHub stars

사용 사례

01Standardizing sequence diagram notation across a large technical documentation repository

02Ensuring complex C4 architectural diagrams in 'architecture.md' are syntactically perfect before deployment

03Automating the cleanup of Mermaid diagrams extracted from legacy documentation or AI-generated drafts

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add sk8metalme/michi mermaid-validator

For use in Claude.ai and ChatGPT

Download Skill