How do I install the Claude Md Link Check skill?

Run npx skillmds@latest add alirezarezvani/claude-md-link-check in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

What does the Claude Md Link Check skill do?

Verify every @path chain import and every markdown link inside every CLAUDE.md in this project resolves to an existing file. Read-only — returns broken links with file:line refs, never edits. It is listed under Docs & Writing on SkillMD.

Is Claude Md Link Check safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Claude Md Link Check?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Claude Md Link Check free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Claude Md Link Check?

Alireza Rezvani (@alirezarezvani) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Claude Md Link Check by alirezarezvani

Name: Claude Md Link Check
Rating: 4.2 (5 reviews)
Author: Alireza Rezvani

File contents

CLAUDE.md Link Check (forked, read-only)

Optional path-glob: $ARGUMENTS (default . — entire tree).

Run these steps in order. Do not modify any file.

Inventory. find <root> -name "CLAUDE.md" -type f -not -path "*/.git/*" -not -path "*/node_modules/*". Also include .claude/rules/*.md. Record paths.
Extract candidates from each file:
- Chain imports — lines matching ^@\S+. The literal after @ is a relative path.
- Markdown links — [text](target) where target is not an HTTP(S) URL, not mailto:, not a bare anchor #section.
Resolve each candidate relative to the file containing it (use Read on the parent file to confirm position, then test -e <resolved-path> or Glob).
- For @../CLAUDE.md inside skill/CLAUDE.md, resolved path is CLAUDE.md.
- For [Backend](backend/CLAUDE.md) inside the root, resolved path is backend/CLAUDE.md.
Return the report in this exact shape:

## Link Check

Files inspected: <count>
References checked: <chain_imports> @-imports, <md_links> markdown links

### Broken
- <file>:<line> — `<original-target>` → does not resolve (expected `<absolute-path>`)
- ... (omit section if empty)

### Clean
<count> references resolved.

If everything resolves, return exactly ## Link Check\n\nAll <N> references resolved across <M> files.. Do not pad.

Hard rule: never invent a fix. Report the broken target verbatim. Repair is the user's call (or /sync-claude-md's).

Frequently asked questions

Claude Md Link Check