Doc Doctor is an automated maintenance tool for markdown knowledge bases that scans for broken links, missing metadata, and orphan pages to ensure a high-quality documentation score.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install doc-doctor
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 doc-doctor 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 Doc Doctor?
Doc Doctor is a specialized utility designed to handle the tedious maintenance of markdown-based documentation and personal knowledge management systems. As a featured tool within the Openclaw Skills ecosystem, it performs deep audits of your files to identify structural weaknesses such as broken wiki-style links, inconsistent frontmatter, and poor naming conventions.
Beyond simple error reporting, Doc Doctor acts as an intelligent assistant that can proactively repair your KB. It uses fuzzy matching to reconnect broken links, generates metadata from existing content, and renames files into standard kebab-case while automatically updating all internal references across your entire project.
Doc Doctor Use Cases
- Auditing a large markdown wiki for broken internal references and dead links.
- Normalizing frontmatter and metadata across hundreds of legacy documentation files.
- Cleaning up file naming conventions in a project to ensure consistency and web compatibility.
- Monitoring the health of Claude Code memory files to prevent stale or duplicated context.
- Identifying thin articles that require more substance or structured outlines.
How Doc Doctor Works
- The skill identifies the documentation root directory, such as a docs, wiki, or notes folder.
- It executes a comprehensive scan using the kb-lint engine to evaluate file structure and link integrity.
- A health dashboard is generated, providing a score out of 100 based on the severity and frequency of issues found.
- For every issue identified, the skill proposes specific fixes, such as fuzzy-matching a target for a broken link or generating a title from the header.
- Upon user confirmation, changes are applied across the filesystem, including file renames and reference updates.
- A final verification scan is run to confirm the improved health score and ensure all issues were resolved.
Doc Doctor Setup
To integrate this capability into your workflow, ensure you have python3 installed and then use the following commands:
# Install the core linting engine
pip install kb-lint
# Run a scan on your current directory
kb-lint . --format json --severity info
Within your AI agent environment, simply trigger the skill by saying "lint my docs" or "check my KB".
Doc Doctor Data Schema & Taxonomy
Doc Doctor interacts with standard Markdown files and organizes its analysis based on the following taxonomy:
| Attribute | Description | Management Style |
|---|---|---|
| Frontmatter | YAML metadata at the top of files | Auto-generated/Normalized |
| Links | [[wiki-links]] or standard Markdown links |
Fuzzy-matched and repaired |
| Filenames | Kebab-case naming (e.g., my-file-name.md) |
Automated renaming + refactoring |
| Context | Git history and file content | Used for creation dates and tag generation |
It also respects <!-- kb-lint-disable --> comments for granular control over specific files or sections.
Doc Doctor Advanced Features
- Claude Code Memory Audit: Specialized mode for scanning
~/.claude/to validate memory index accuracy and flag stale entries. - Intelligent Refactoring: Automatically renames files and performs a global search-and-replace to update all incoming links.
- Automated Outline Generation: Identifies thin articles (under 100 words) and suggests logical structures to help you expand the content.
- Git Integration: Pulls
createdandmodifieddates directly from git history to ensure metadata accuracy. - Multi-OS Support: Fully compatible with both macOS and Linux environments through Openclaw Skills.
SKILL.md
Loading
Related Openclaw Skills
Claude Config Linter
A specialized utility to audit Claude Code configurations for token waste and provide actionable performance scores.
Solana Analytics Pro
A professional-grade Solana ecosystem analysis platform integrating technical indicators, on-chain metrics, and sentiment tracking.
OpenClaw Session Cleaner
A maintenance utility designed to safely delete aged session logs and rebuild the session index for OpenClaw agents on Ubuntu ARM.
Idea Trace
Idea Trace helps you follow the lifecycle of a core proposition from a vague seed to a mature, shaped judgment.
Ark Seedance Video Generation
An end-to-end video generation skill for AI agents using Volcengine Ark Seedance models for professional video synthesis.
Extract Design System
Reverse-engineer public website design primitives into localized design tokens and CSS variables automatically.
Featured*
