Claude Md Link Check

What it does

When your agent uses it

• Tasks that involve Agent instruction files

Example prompts

• “/claude-md-link-check”

Requirements

• Pre-approved tools (allowed-tools): Read, Glob, Grep, Bash(find:*), Bash(test:*), Bash(ls:*)

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

1. 1Inventory. find -name "CLAUDE.md" -type f -not -path "*/.git/*" -not -path "*/node_modules/*". Also include .claude/rules/*.md. Record…
2. 2Extract candidates from each file
3. 3Resolve each candidate relative to the file containing it (use Read on the parent file to confirm position, then test -e or Glob).
4. 4Return the report in this exact shape
5. 5If everything resolves, return exactly ## Link Check\n\nAll references resolved across files.. Do not pad.

What it can do on your machine

Read from SKILL.md and the folder at commit 032c5e5. It shows what the files ask for, not the result of running them.

• Tool permissions

  Pre-approves these tools, so the agent can use them without asking each time:

  • Read
  • Glob
  • Grep
  • Bash(find:*)
  • Bash(test:*)
  • Bash(ls:*)

  From allowed-tools in the SKILL.md frontmatter.

• Runs code

  No scripts in the folder and no shell commands in SKILL.md.

  From the folder's file list and the shell code blocks in SKILL.md.

• Network

  No URLs in SKILL.md.

  From URLs in SKILL.md, links to its own repository left out.

• Credentials

  Names no API keys, tokens, secrets or passwords.

  From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Claude Md Link Check loads about 525 tokens when it runs. Until then it costs about 53 tokens; SKILL.md has 160 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~53

When it runs · the whole SKILL.md, loaded when a task matches

~525

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from alirezarezvani/ClaudeForge at commit 032c5e5, republished under its MIT licence (© alirezarezvani). 160 words, ~525 tokens.

name

claude-md-link-check

description

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.

allowed-tools

Read, Glob, Grep, Bash(find:*), Bash(test:*), Bash(ls:*)

when_to_use

Use when the user asks "check my CLAUDE.md links", "are the @-imports still valid?", "find broken cross-references", or as part of /sync-claude-md --weekly.

argument-hint

[path-glob]

context

fork

agent

Explore

disable-model-invocation

false

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

© alirezarezvani, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skill/claude-md-link-check of alirezarezvani/ClaudeForge.

Open the folder on GitHubat commit 032c5e5