Setup & Installation
Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:
What This Skill Does
Validates Markdown files for broken local relative links by scanning recursively through a directory or a single file. Ignores external URLs and same-file anchors. Outputs a JSON report with each broken link's file path, link text, target URL, and line number.
Skipping external URLs and same-file anchors keeps results focused on local file integrity, avoiding false positives from network issues or anchor variations.
When to use it
- Checking internal doc links before a release
- Auditing a wiki after files are reorganized
- Verifying README links across a monorepo
- Finding dead links after renaming or moving files
- Running link validation in CI on documentation changes
Example Workflow
Here's how your AI assistant might use this skill in practice.
User asks: check all Markdown files in the current directory for broken links
- 1Run the validator against the current directory
- 2Receive a JSON array of results per file
- 3Identify entries where valid is false
- 4Extract brokenLinks arrays with text, url, and line fields
JSON report listing each file with broken relative links, showing the link text, target path, and line number for each broken reference