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#

CheckWhat it findsAuto-fixable?Broken links[[wiki-links]] pointing to nothingYes — fuzzy-matches the right targetOrphan pagesFiles no other page links toSuggests where to add linksMissing frontmatterNo title, tags, or metadataYes — generates from contentThin articlesUnder 100 wordsSuggests outlinesBad filenamesSpaces, non-kebab-caseYes — renames + updates all referencesInconsistencyMixed tag casing, date formatsYes — normalizes

Links#

• GitHub: SingggggYee/kb-lint
• PyPI: pip install kb-lint

---

Below are instructions for Claude Code. You can ignore this section.

Instructions#

1. Find the target. User-specified path, or scan for docs/, wiki/, notes/, content/. If user says "memory", target ~/.claude/.

2. Run the linter. bash

   kb-lint --version 2>/dev/null || pip install kb-lint
   kb-lint <path> --format json --severity info 2>&1
   
   

   If kb-lint unavailable, check files manually for: broken [[wiki-links]], missing frontmatter, thin articles (<100 words), orphans, bad filenames.

3. Show a health dashboard. Score out of 100, issues grouped by category and severity, most critical first.

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

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