Claude Md Link Check

alirezarezvani/claude-md-link-check

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.

527 tokens

context cost

the whole folder, loaded on every use

files

instructions only

copies elsewhere

how many repositories repackaged it

413

stars on the repo

on the repository, not the skill itself

Install

one command, takes just this skill from the repository

npx skills add https://github.com/alirezarezvani/ClaudeForge --skill claude-md-link-check

The instruction itself

1 sections, as written by the author

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 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 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).

How to use it

Copy the folder

Take alirezarezvani/claude-md-link-check from the repository into ~/.claude/skills for personal use, or into .claude/skills inside a project.

Check the name does not clash

The agent identifies a skill by the name field in its header. Two skills with the same name cannot sit side by side — one of them will be ignored.