A high-performance CLI tool designed to identify broken internal links and maintain documentation integrity within Markdown files.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install markdown-validator
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install markdown-validator using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Markdown Validator?
The Markdown Validator is a specialized utility within the Openclaw Skills ecosystem designed to scan local repositories for link consistency. It ensures that every relative link points to a valid file, preventing dead ends in your technical documentation, internal wikis, or project READMEs. By integrating this skill into your development workflow, you can automate the tedious process of manual link checking and maintain a professional documentation standard.
This tool is particularly useful for large projects where file structures change frequently. Instead of manually clicking through every document, the validator provides a comprehensive report of every broken reference, including the exact line number where the error occurs.
Markdown Validator Use Cases
- Verifying internal documentation consistency before major releases.
- Auditing large Markdown repositories for broken relative paths after file restructuring.
- Integrating automated link checks into pre-commit hooks or local CI workflows.
- Maintaining valid cross-references in complex knowledge bases using Openclaw Skills.
- Rapidly identifying orphaned links in technical specifications.
How Markdown Validator Works
- The user invokes the skill through the Openclaw interface, targeting a specific file or an entire directory.
- The validator engine recursively scans all Markdown (.md) files within the provided path.
- Each file is parsed to extract relative links, while external URLs (http/https) and internal page anchors (#) are intelligently ignored.
- The tool checks the file system to verify the existence of every referenced local file.
- A detailed JSON report is generated, highlighting invalid links, their source file, and the specific line of code where they reside.
Markdown Validator Setup
To use the Markdown Validator, you need a functioning Openclaw environment. Execute the skill using the node runtime through the CLI.
# Validate the current directory and all subfolders
openclaw exec node skills/markdown-validator/index.js .
# Validate a specific Markdown file
openclaw exec node skills/markdown-validator/index.js path/to/your/document.md
Markdown Validator Data Schema & Taxonomy
The skill produces a structured JSON array of objects, making it easy to integrate with other automation tools or custom reporting scripts.
| Attribute | Description |
|---|---|
file |
The path to the Markdown file being analyzed. |
valid |
A boolean status indicating if the file passed validation. |
brokenLinks |
An array containing objects for each dead link found. |
text |
The anchor text used for the link. |
url |
The invalid relative path referenced in the document. |
line |
The exact line number in the source file where the broken link is located. |
Markdown Validator Advanced Features
- Deep recursive scanning capability for complex folder hierarchies.
- Intelligent exclusion of web-based URLs to focus strictly on local file integrity.
- Machine-readable JSON output for seamless integration with Openclaw Skills pipelines.
- Anchor-aware filtering to prevent false positives from internal section headers.
- Lightweight execution with minimal overhead for rapid local auditing.
SKILL.md
Loading
Related Openclaw Skills
Markdown Linter
A technical validation skill for auditing Markdown files to ensure link consistency and structural syntax compliance.
json-repair-kit
A specialized Node.js utility designed to automatically repair and normalize malformed or loose JSON syntax into valid standards.
JSON Modifier
A specialized utility for applying RFC 6902 compliant JSON patches to files safely without rewriting the entire document.
JSON Linter
A lightweight utility for recursively scanning workspaces to identify and report syntax errors in JSON files.
Signup Lead for AgenticCreed
Automates the creation of signup leads in the AgenticCreed system via a secure public HTTP endpoint.
IdentityGram Signin
A specialized authentication skill designed to facilitate secure user sign-in to the IdentityGram platform via its gateway API.
Featured*
