# Md Validation

Load after writing, moving, or linking markdown pages or Mermaid diagrams, before...

- Repository: https://github.com/haowjy/creative-writing-skills (556 stars)
- Category: Writing
- License: Apache-2.0
- Last updated: 2026-10-28
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add haowjy/creative-writing-skills --skill md-validation -g -a claude-code -y`
Codex: `npx skills add haowjy/creative-writing-skills --skill md-validation -g -a codex -y`
Cursor: `npx skills add haowjy/creative-writing-skills --skill md-validation -g -a cursor -y`
Gemini CLI: `npx skills add haowjy/creative-writing-skills --skill md-validation -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add haowjy/creative-writing-skills`

## Description

Load after writing, moving, or linking markdown pages or Mermaid diagrams, before committing them: validates links, the KB link graph, and diagram syntax.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Markdown 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.