Md Validation

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

593 stars 82 forksWriting & Content Plugin marketplace

Install

Claude Code plugin
/plugin marketplace add haowjy/creative-writing-skills

The repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add haowjy/creative-writing-skills --skill md-validation
Manual install
git clone --depth 1 https://github.com/haowjy/creative-writing-skills.git /tmp/creative-writing-skills
mkdir -p ~/.claude/skills
cp -r /tmp/creative-writing-skills/plugin/claude/skills/md-validation ~/.claude/skills/md-validation

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Markdown Validation

Validate links before committing documentation changes, and read the link graph
before and after restructuring a tree. Validate Mermaid syntax and style after
diagram edits. Fix every reported issue and repeat the validation until it is clean.

Use the validators your project or runtime provides. Their commands, warning
categories, suppression comments, and ignore files belong to that tool: when
the runtime offers Markdown-validation guidance, read it before running them.
Report any check you could not run.

When a warning marks a construct you meant, suppress only that category, as
narrowly as the validator allows, with the reason beside the diagram. Exclude
generated or vendored material from validation; never exclude a broken page
that belongs to the tree.

See `resources/mermaid-authoring.md` for diagram authoring rules.
Read the full skill on GitHub

Details

Skill name
md-validation
Path
plugin/claude/skills/md-validation/SKILL.md
License
Apache-2.0
Repo updated
16 November 2026

FAQ

What does the Md Validation skill do?

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

How do I install the Md Validation skill?

Claude Code plugin: /plugin marketplace add haowjy/creative-writing-skills. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Md Validation popular?

It lives in haowjy/creative-writing-skills, which has 593 GitHub stars and 82 forks.

Related skills

Character Sim

593

haowjy/creative-writing-skills

Load to speak as a specified character from what they know, how they talk, and what they feel now: in-character conversation, voice discovery, or a relationship pressure test. Pass the character, the story moment, and their style and character-state files.

Testing & QA82

Creative Research

593

haowjy/creative-writing-skills

Load when a story needs factual grounding the writer doesn't have: historical detail, cultural texture, domain accuracy, or how other authors handled similar material. Pass the question and story context; returns a sourced report the writer can draw from.

Research & Science82

Creative Writing Craft

593

haowjy/creative-writing-skills

Load when putting fiction on the page or judging how it reads there: the production modes (fresh draft, revision, bridge, alternate take, line polish), prose technique, scene mechanics, style analysis, and genre craft.

Writing & Content82

Project Setup

593

haowjy/creative-writing-skills

One-time project setup for creative writing: interview the author about the project, writing samples, and voice, then create the AGENTS.md, kb/ layout, and style files every writing agent reads. User-invoked; run it once when starting a project.

Writing & Content82

LLM Writing

593

haowjy/creative-writing-skills

Load before you write a commit message, PR body, changelog entry, issue, report to the user, doc, README, AGENTS.md or .context/ page, KB page, or prompt: choose plain words, write for the reader's context, and strip default LLM phrasing.

Writing & Content82

Story Memory

593

haowjy/creative-writing-skills

Creative-writing domain knowledge for durable story state. Load when preserving or retrieving project memory — fact extraction, context scoping, reference writing, artifact layout, and issue tracking. If you are a knowledge agent such as kb-lead, load this for the fiction-specific categories and conventions your general methodology doesn't cover.

Writing & Content82

Browse the most popular Claude skills, all writing & content skills, or write your own with the skills generator.