skill-doctor
hanzhcn/skill-doctor
Claude Code / OpenClaw skill 体检仪表盘 — 自动来源分类/污染副本/漂移/孤儿检测
Instalação
npx convez-ai hanzhcn/skill-doctor1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
README
A tradução para o português deste README ainda está na fila.
skill-doctor
Claude Code / OpenClaw skill 体检仪表盘 —— 一目了然看清你的 skills 来自哪里、有没有污染/漂移/孤儿。
English · 简体中文
为什么做
用 Claude Code / OpenClaw 一段时间后,~/.agents/skills 和 ~/.claude/skills 会堆出几百个 skill,来自四面八方:自己写的、npx skills add 装的、ECC 等插件自带的、OpenClaw 自带的……还会被某次操作批量塞进一堆插件 skill 副本(污染),或者自研 skill 的本地副本和 git 仓库双向漂移(你改了本地没推、仓库改了没拉,CC 一直读旧版)。
现成的 skill 管理器(jiweiyeah/Skills-Manager 等)都是"入库分发"或"手动打标签",没有一个自动按来源分类、检测污染/漂移/孤儿。skill-doctor 把这套审计逻辑产品化。
功能
- 自动来源分类:自研(laohan/cheat)/ npx / 插件副本 / OpenClaw / 孤儿,一眼看清
- 健康检查:
- 🔴 失效链接(dangling symlink)
- 🔴 CC 不可见(agents 有但 claude 没)
- 🟡 插件副本(和插件 skill 同名,可能是污染)
- 🟡 双份实体(agents + claude 都是实体,漂移温床)
- 🟡 漂移(自研 skill 的本地 vs git 仓库 diff)
- 详情视图:路径状态、npx 锁文件元数据、插件原件路径、漂移 diff、SKILL.md 预览
安装
git clone https://github.com/hanzhcn/skill-doctor.git
cd skill-doctor
npm install
npm run dev
# 打开 http://localhost:3000
纯本地运行,只读扫描你的 skills 目录,不修改任何文件。
数据源
| 来源 | 路径 |
|---|---|
| agents 真身 | ~/.agents/skills/ |
| CC 桥接层 | ~/.claude/skills/ |
| npx 锁文件 | ~/.agents/.skill-lock.json |
| 插件清单 | ~/.claude/plugins/installed_plugins.json |
| 自研 git | ~/Documents/laohan-skills/ |
| cheat git | ~/Documents/cheat-on-content/skills/ |
| OpenClaw | ~/.openclaw/skills/ |
分类规则
- symlink 指向
Documents/laohan-skills→ 自研 laohan - symlink 指向
cheat-on-content→ 自研 cheat - symlink 指向
.openclaw/skills→ OpenClaw .skill-lock.json有记录 → npx- 与某插件 skills/ 同名 → 插件副本
- 以上都不是 → 孤儿 ⚠️
技术栈
Next.js 16 (App Router) · React 19 · TypeScript · Tailwind 4 · shadcn/ui
路线图
- 只读体检(扫描/分类/健康检查/详情)
- 写操作(删除副本/转 symlink/同步仓库,带二次确认)
- 更新检测(git fetch / skillFolderHash 比对)
- Tauri 桌面打包
License
MIT