- name
- Doc Doctor
- description
- Say 'lint my docs' to scan your markdown KB for broken links, orphan pages, and missing metadata — then auto-fix them.
- version
- 3.0.0
- metadata
- openclaw
- requires
- bins
- emoji
- 🔍
- homepage
- https://github.com/SingggggYee/kb-lint
- os
- install
- package
- kb-lint
Doc Doctor
Your markdown docs have broken links, orphan pages, missing metadata, and you don't know it. This skill finds them all and fixes them for you.
Quick start
Just say:
- "lint my docs" — scan your project's markdown files
- "check my KB" — get a health score out of 100
- "fix my wiki" — auto-fix broken links, missing frontmatter, bad filenames
- "lint my memory" — audit your Claude Code memory files
What it checks
| Check | What it finds | Auto-fixable? |
|---|---|---|
| Broken links | [[wiki-links]] pointing to nothing | Yes — fuzzy-matches the right target |
| Orphan pages | Files no other page links to | Suggests where to add links |
| Missing frontmatter | No title, tags, or metadata | Yes — generates from content |
| Thin articles | Under 100 words | Suggests outlines |
| Bad filenames | Spaces, non-kebab-case | Yes — renames + updates all references |
| Inconsistency | Mixed tag casing, date formats | Yes — normalizes |
Links
- GitHub: SingggggYee/kb-lint
- PyPI:
pip install kb-lint
*Below are instructions for Claude Code. You can ignore this section.*
Instructions
- Find the target. User-specified path, or scan for
docs/,wiki/,notes/,content/. If user says "memory", target~/.claude/.
- Run the linter.
kb-lint --version 2>/dev/null || pip install kb-lint
kb-lint <path> --format json --severity info 2>&1If kb-lint unavailable, check files manually for: broken [[wiki-links]], missing frontmatter, thin articles (<100 words), orphans, bad filenames.
- Show a health dashboard. Score out of 100, issues grouped by category and severity, most critical first.
- Offer to fix. Go beyond the CLI:
- Broken links: fuzzy-match the intended target, confirm with user - Frontmatter: generate meaningful title/tags/confidence from content, get created date from git history - Orphans: suggest which articles should link to the orphan - Thin articles: suggest an outline, never fabricate content - Filenames: rename to kebab-case, update all references
- Verify. Re-run linter, show before/after score.
Claude Code memory mode: For ~/.claude/ targets, also check MEMORY.md index accuracy, validate memory frontmatter, flag stale entries (>90 days), find duplicates.
Rules: Never fabricate content. Always show changes before applying. Respect <!-- kb-lint-disable --> inline comments and per-check severity overrides.