Claude Doc Doctor

通过 kb-lint 命令行扫描指定的 Markdown 知识库或笔记目录，检查断链、孤立页、缺失 frontmatter、过短文章、文件名与格式不一致，给出按严重度分组的 0-100 健康评分；经用户确认后修复链接、生成元数据、重命名文件并复检；也支持审计记忆文件目录。

singggggyee

热度 46.35

最近更新 2026-05-11 17:40:12

分类：知识依赖：代码执行 / 读写文件应用场景：笔记整理 / 报告撰写 / 工作流

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add doc-doctor

Metadata

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":["python3"]},"emoji":"🔍","homepage":"https://github.com/SingggggYee/kb-lint","os":["macos","linux"],"install":[{"kind":"uv","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

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>&1
```
If 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  inline comments and per-check severity overrides.