About md-validation
md-validation is a skill for checking documentation changes, covering broken links, document relationships, and Mermaid diagrams before committing.
Key features
- 01Broken-link validation
- 02Link-graph inspection
- 03Orphan and disconnected page detection
- 04Mermaid syntax and style checks
Use cases
- 01Check documentation links before a commit
- 02Find orphaned or disconnected documents
- 03Validate diagrams after Mermaid edits
Install
Copy the command and run it in a terminal.
npx skills add https:/ / github.com/ haowjy/ creative-writing-skills --skill md-validationAfter installing, type/md-validationin Claude Code to confirm it loaded.
Bundled filesresources/validation-inputs.mdresources/mermaid-authoring.md
Details
From the project READMEMarkdown Validation
Validate broken links before committing documentation changes. Inspect the link graph when you need to understand document topology or find orphan, hub, and disconnected pages.
Validate Mermaid syntax and style after diagram edits. Fix every reported issue and repeat the validation until it is clean.
See resources/mermaid-authoring.md for diagram authoring rules, validator
warning categories, and inline suppressions. See
resources/validation-inputs.md for context path names and persistent ignore
files.