Skill Picker
本机 agent skills 装多了找不到？说一句意图，弹出 2–4 个候选让你点选；顺手标出重复与漂移。
English one-liner: Forget skill names? Skill Picker turns “which skill for X?” into 2–4 clickable candidates — and flags duplicate/drifted skills. 100% local.
30 秒安装
git clone https://github.com/469910093-ui/Skill-picker.git
cd Skill-picker
python skillpick.py install
一条命令完成：扫描全部 skill 目录 → 生成 ~/.skill-picker/catalog.md + dashboard.html → meta-skill 装进 Cursor / Claude Code / Codex / OpenClaw → 工具自拷贝到 ~/.skill-picker/。
给 coding agent 装：把本仓库丢给它，说 install this（见 AGENTS.md）。
你会得到什么
| 能力 | 说明 |
|---|
| 找技能 | 「用哪个 skill 做周报」→ 会话内 2–4 个候选 + AI 推荐，你自己点选 |
| 理技能 | 同名漂移、功能重叠自动圈出，红色感叹号提醒（只提示，不代删） |
| 本地看板 | 单文件 HTML，意图输入实时匹配，双击即可打开 |
| 一键安装 | add <github 地址> 从 GitHub 装 skill：先出计划（来源 / 提交号 / 目标路径）再写盘，同名绝不覆盖，逐文件 sha256 存证，装完自动体检，remove 可回滚 |
| 五道门禁 | 工具副本 / 覆盖率 / 解析质量 / 漂移 / 匹配黄金用例，每次扫描自检 |
| 本地优先 | 无服务器、无账号、零第三方依赖（Python 标准库）；找技能 / 理技能全程不发网络请求。出网只有两处，都由你主动触发：「去 GitHub 发现」tab（本机未同步 skill-feed 时内嵌加载公开发现页）、以及 add 拉取 GitHub 压缩包 |
灵感来自 tab-out：不管理数据，只读取已存在的事实；暴露冗余，决策留给用户。
装好后怎么用
-
会话内：说「帮我选个 skill 做周报」「帮我看看本机有没有剪视频的能力」「我要干周报了哪个 skill 最适配」「整理一下我当前安装的所有 skills」→ 弹出看板 + 候选，点选后执行
-
看板：打开 ~/.skill-picker/dashboard.html（无需服务器）
-
CLI：python ~/.skill-picker/skillpick.py match "意图" --top 4 --json
命令
| 命令 | 作用 |
|---|
python skillpick.py install | 扫描 + 装 meta-skill + 自拷贝 |
python skillpick.py scan / check | 刷新索引；退出码 0=可信 / 2=门禁 FAIL |
python skillpick.py match "意图" | 共享引擎检索候选 |
python skillpick.py add <github> | 从 GitHub 装 skill；不带 --yes 只打印计划 |
python skillpick.py installed | 列出装过的 skill 及完整性（改动 / 缺失） |
python skillpick.py remove <id> --yes | 卸载回滚；改动过的文件需 --force |
python skillpick.py serve | 本地看板服务（可选） |
python -m unittest discover -s tests | 测试（含黄金匹配回归） |
从 GitHub 装一个
# 1) 先看计划：来源仓库、提交号、将写入哪个宿主的哪个路径、有什么冲突
python skillpick.py add https://github.com/anthropics/skills --path skills/canvas-design
# 2) 确认无误再写盘，装完自动重扫 + 跑五道门禁
python skillpick.py add https://github.com/anthropics/skills --path skills/canvas-design --yes
# 3) 不想要了（只删自己写过、且装完没被改过的文件）
python skillpick.py remove claude-code:canvas-design --yes
monorepo 不给 --path 时会把候选子目录列出来让你挑。默认装到 skill 最多的那个宿主，--host 可改，--as 可改目录名。目标目录已存在一律阻塞，没有 --force 覆盖开关。
架构（一图）
rules.json ──── 近义词 / 权重 / 分类 / 黄金用例（唯一可调参）
│
├── matching.py ── 共享打分引擎
│ ├── mcp_server.py ← ① MCP 插件
│ ├── skillpick.py ← ② CLI
│ └── tests/ ← 回归
└── dashboard.py ── JS 同构镜像（页面搜索 = 会话路由）
三级降级：MCP → CLI + HTML → 系统浏览器打开 dashboard.html。
门禁
| 门禁 | 含义 | FAIL 时 |
|---|
| G1 覆盖率 | 有 skill 目录没扫到 | 加进 ~/.skill-picker/config.json 的 extra_roots 后重跑 check |
| G2 解析质量 | 缺描述占比过高 | WARN，列出问题 skill |
| G3 漂移 | 同名多端内容不一致 | 打开「理技能」自行取舍（工具不代删） |
| G4 黄金用例 | 匹配引擎回归 | 请开 issue |
只读铁律
永不修改、移动、删除任何已有 skill 文件。 发现漂移或重叠只提醒，不代你合并。
唯一往宿主目录写东西的是 add，它也守着同一条线：只新建自己的目录，
同名一律阻塞、没有覆盖开关；remove 只删存证里自己写过、且装完之后
没被改动过的文件。其余数据全在 ~/.skill-picker/。
相关：从 GitHub 发现新 skill
skill-picker 只索引本机已装 skills（找技能 / 理技能 100% 本地）。
当意图在本机 没有匹配 时，看板第三 tab 「去 GitHub 发现」 会嵌入 skill-feed 的 lite 子页（无关注、无发布、无个人后台）——浏览远程线索 → 打开 GitHub 自行安装 → 再 scan。
完整网页产品（Stories/关注/UGC）见兄弟仓库 skill-feed 的 publish-site（site/index.html）。
文档
更新
git pull
python skillpick.py install # 或
python ~/.skill-picker/skillpick.py scan
MIT · 若有用请 ⭐ —— 比互赞群靠谱。
