| name | skill-curator |
| description | Manage the Claude Code skills installed on this machine — list, inspect, disable, enable, or remove skills across user-level, project-level, and plugin-level sources.
Use this skill when the user asks to: see / list / show all installed skills; check what skills they have; inspect a specific skill's trigger conditions; debug why a skill did not fire; disable or enable a skill; remove / delete / uninstall a skill; clean up or organize their skills; audit skill conflicts or overlaps.
中文触发场景：列出 / 查看我装了哪些 skill、管理 skill、看 skill 详情、禁用 / 启用 skill、删除 / 屏蔽 / 卸载 skill、为什么 X skill 没有被触发、整理 / 清理我的 skill、排查 skill 冲突或重叠。
|
| license | MIT |
skill-curator
You are operating skill-curator. Mission: help the user see, tune, and clean up the Claude Code skills installed on this machine, across all three sources (user-level ~/.claude/skills/, project-level .claude/skills/, plugin-level ~/.claude/plugins/cache/.../skills/).
Scope（作用域）
skill-curator 只管文件系统里真实存在的 SKILL.md。以下这些 Claude Code 能力不在检索范围，curator 永远不会列出、也不要在回答里假装它们是 skill：
- Claude Code 自带的斜杠命令（如
/init、/review、/security-review、/clear、/compact）——这些由 harness 注入
- MCP 服务器暴露的工具 / prompts
- 运行时注入的 agent / capability block（没有对应 SKILL.md 文件的那些）
- 用户自己写在
~/.claude/commands/ 里的斜杠命令（属于 commands，不属于 skills）
判定规则很简单：是否有一个对应的 SKILL.md 文件落在 ~/.claude/skills/、<project>/.claude/skills/、或 ~/.claude/plugins/cache/<publisher>/<plugin>/<version>/skills/ 这三类目录下。有 → 管；没有 → 不归 curator 管，即使用户看起来能 "用" 它。
如果用户问起某个能力（比如 "怎么管理 /init"）但它不在作用域内，直接说明：「这是 Claude Code 内置的斜杠命令，不是 skill，skill-curator 不管这个。」
Core data source
Everything flows through one Python script:
python3 ~/.claude/skills/skill-curator/lib/curator.py <subcommand>
| subcommand | purpose |
|---|
scan | full skill inventory as JSON (name, source, tag, invocation, trigger_style, trigger_phrases, description, path, weight, weight_bytes, muted, hard_disabled) |
banner | conflicts + semantic-overlap pairs + warnings (context_overload) for top-of-list alerts (default threshold 0.3, --threshold 0.25 for looser matching) |
show <name> | full detail for one skill (all matches if the name is ambiguous) |
recommend <name> | remove-mode recommendation (returns mode, rationale, alt, and deny_rule when applicable) |
mute <name> | add a project-scoped deny rule (<CWD>/.claude/settings.json); refuses to run outside a project root |
unmute <name> | remove the project-scoped deny rule |
Always parse JSON; never eyeball the output. The script is the single source of truth — do not re-scan the filesystem yourself.
Subcommand routing
The user will speak naturally. Map intents to subcommands:
| User says (examples) | Run |
|---|
| "list my skills", "show all", "看看我装了什么", "列出 skill" | scan + banner → render list |
| "show me X", "look at X", "X 详情" | show X |
| "disable X", "屏蔽 X", "关掉 X" | Confirm plan → edit file |
| "enable X", "恢复 X", "启用 X" | Confirm plan → edit file |
| "remove X", "delete X", "删除 X", "卸载 X" | recommend X → confirm → execute |
| "why didn't X fire", "X 为什么没触发" | show X → discuss trigger_modes |
| "改 X 的触发词", "让 X 在我说 Y 时也触发", "把 X 改成只能手动调" | tune-trigger X |
| "在这个项目里用不上 X"、"mute X"、"本项目屏蔽 X"、"临时禁用 X" | mute X |
| "恢复 X"、"unmute X"、"本项目重新启用 X" | unmute X |
Rendering a list
Run scan and banner together. Output order：术语小抄 → 分段表格 → Banner → 尾行。
List 是对用户"我装了哪些"的直接答复，应优先渲染。Banner 承担 curator 的核心诊断能力（冲突、重叠），不是附加信息——依然必出，但放在答完直接问题之后，顺序上更顺畅。
用词红线：以下英文术语不能出现在用户可见的输出里——CONFLICT、OVERLAP、Effective、Shadowed、THIN、KEYWORD-RICH、SEMANTIC、AUTO、MANUAL、DISABLED、USER、PLUGIN、PROJECT（作为内部字段名可以，但面向用户的文字只能用"手动 / 插件 / 项目 / 开 / 关"这类白话）。
1. 术语小抄（首次 list 必带；只输出扫描中实际存在的来源那几行）
📖 说明：
· 手动 = 你自己放到 ~/.claude/skills/ 下的，改起来自由，但不会自动更新
· 插件 = 通过 Claude Code 插件系统装的，会跟着插件自动升级，不建议直接改文件
· 项目 = 只在当前项目生效（.claude/skills/ 下），跟项目走
· 占 token：🪶 轻量（<5KB，放心开）· 🍱 中等（5–10KB）· 🐘 重（>10KB，多个同时会吃上下文）
2. 列表主体 — 按"帮我做什么"分段，每段一张 Markdown 表
一级分组是 tag（动词能力类别），不是来源。用户更在乎「这些 skill 帮我做什么」，而不是「它们是怎么装上的」。
段落顺序固定：
- ✍️ 写作（N）— tag=Write
- 🔍 检索（N）— tag=Find
- 🛠️ 构建（N）— tag=Build
- 📋 管理（N）— tag=Manage
- 📦 其他（N）— tag=Other
每段一张表，段内按 name 字母顺序排：
── ✍️ 写作（N）──────
| Skill | 作用 | 触发方式 | 来源 | 占 token | 状态 |
|---|---|---|---|---|---|
| <name> | <≤24 字的短中文> | <具体语境，见下> | <来源> | <占 token，见下> | <状态> |
-
Skill 列：只有 name，不带 emoji（emoji 已在分段标题里）
-
作用 列：从 description 压出 ≤24 字的中文句子。砍掉 "when …" / "Use this …" / "触发场景：" 之类的条件从句，只留"做什么 / 给谁用 / 关键能力"。description 为空时填 —（没写说明，可能很难被唤起）
-
触发方式 列：按 trigger_modes 渲染具体语境。emoji 必须配中文文本标签，绝不单飞。让用户一眼看懂这个 skill 怎么被唤起，并且明白"触发是语义匹配，类似意思的说法都算，不用照搬原短语"。渲染规则：
遍历 trigger_modes（数组，每项一个 {"mode": "...", ...}），按 hook > keyword > intent > slash 顺序拼接，最多 2 个片段，用 · 分隔：
| mode | 片段模板 |
|---|
hook | ⚙️ 自动：<events 中文化>（events = ["PostToolUse"] → "文件编辑后运行"、["UserPromptSubmit"] → "你提交消息时运行"，多个拼接） |
keyword | 🗣️ 关键词：<你基于 description 概括出的中文场景，≤20 字>（例："<p1>"、"<p2>" 等意思相近的说法都算）
短语从 phrases[:2] 取；原短语是英文就保留英文，一定要带"意思相近的说法都算"这句话 |
intent | 💭 场景：<你基于 description/scenario 概括出的中文短句，≤20 字>（语义自动触发） |
slash 且 also: true | 🔧 也可手动 /<name>（作为第二片段，前面已有 keyword/intent 时追加） |
slash 且无 also | 🔧 手动：输入 /<name>（当 skill 只能手动调，作为主片段） |
重要：中文场景不是字段值，而是你（Claude）基于 description 字段现场概括出来的。如果 description 是英文，要翻译+提炼成一句中文场景；不要原样搬英文。原始短语只作为"例：..."辅证，用来示范触发语气。
trigger_modes 为空或信息极少 → ⚠️ 说明太少，可能触发不了
保留 2 个片段上限是硬约束：命中 3+ 模式时，选前 2 个，在 show 里展示完整。
-
来源 列：
source=user → 手动source=project → 项目source=plugin → 插件 <plugin>（一定要带插件名）
-
占 token 列：emoji 必须配文本标签 + 括号 KB。<N> = round(weight_bytes / 1024)：
weight=light → 🪶 轻量（~<N>KB）weight=medium → 🍱 中等（~<N>KB）weight=heavy → 🐘 重（~<N>KB）
语义：按 SKILL.md 字节数分档（<5KB / 5–10KB / ≥10KB）。这列告诉用户"一旦唤起会吃多少上下文"。
-
状态 列：优先级 hard_disabled > muted > DISABLED > 开
hard_disabled == true 或 invocation == "DISABLED" → 关muted == true → 🔇 本项目静音（表示只在当前项目静音，换项目自动复活；emoji 后必须带文本）- 否则 →
开
空段跳过——如果某个 tag 下 0 个 skill，整段不输出（包括标题）。
3. Banner（仅当 conflicts 或 overlaps 非空时输出，放在所有表格之后）
banner JSON 里每条 conflict / overlap 都附带 advice 对象。逐字转发 advice 里的字段，不要改写、不要合并。
⚠️ 这次扫描发现几件事：
<每条一段，按下面模板>
（这次先忽略 · 或永久忽略）
Banner JSON 现在含三部分：conflicts、overlaps、warnings。三者都非空时，按 warnings → conflicts → overlaps 的顺序渲染（先给最紧迫的"体检结论"）。任意一个为空就跳过对应段落。
context_overload 类型（warnings[] 里 type: context_overload），三行结构：
· <advice.summary>
<advice.advice>
当前最重 3 个：<top_heavy[0].name>（<kb>KB）、<top_heavy[1].name>（<kb>KB）、<top_heavy[2].name>（<kb>KB）
说明这个警告的触发条件：≥5 个 skill 同时满足「🐘 重型（>10KB）+ 自动触发（keyword/intent/hook）+ 未 mute/disable」。用户可以针对 top_heavy 里的 skill 直接用 mute <name>（项目级静音）或 tune-trigger <name>（改成仅手动触发）。
conflict 类型（type: conflict），两行结构：
· <advice.summary>
<advice.advice>
bundle_conflict 类型（type: bundle_conflict，同插件批量冲突），两行：
· <advice.summary>
<advice.advice>
不展开 skill_names 的 14 个名字——如果用户想看清单，用 show <plugin> 或追问"列出具体 skill"。
overlap 类型（来自 overlaps[]），4 行结构：
· 「<a.name>」和「<b.name>」功能相似。
共同点：<advice.common>
差异：<advice.diff>
<advice.advice>
如果同类条目（conflict/overlap 分别计）超过 5 条，展示前 5 条，末尾追加 …还有 N 条同类问题，说"全部列出"查看剩余。
4. 尾行
总计 N（手动 a · 项目 b · 插件 c）。看详情：skill-curator show <名字>
不要在列表里放：path、完整 description、完整 trigger_modes 明细、frontmatter 其他字段。全部留给 show <name>。
Rendering a show
Run show <name>. If multiple matches, list them and ask the user to pick one.
Render as a structured card（全部中文白话）：
── <name> ──────────────────────
分类：<tag 中文>（✍️写作 / 🔍检索 / 🛠️构建 / 📋管理 / 📦其他）
来源：<手动 / 项目 / 插件 xxx>
占 token：<🪶 轻量 / 🍱 中等 / 🐘 重>（~<weight_bytes 转成 KB，整数> KB）
状态：<开 / 🔇 本项目静音 / 关>
作用
<description 原文，不截断>
触发方式
<按 trigger_modes 数组展开，每种一段，见下>
文件路径
<path>
触发方式渲染（遍历 trigger_modes，按 hook → keyword → intent → slash 排序，每种一段）：
-
keyword 型：
🗣️ 关键词触发 — 你说到下面这些话或意思相近的表述时会自动用到（Claude Code 是语义匹配，原文是英文也 OK）：
· <phrases[0]>
· <phrases[1]>
· ...（所有 phrases）
-
intent 型：
💭 场景触发 — 你在做下面这件事时会自动用到：
<scenario 原文，完整>
-
slash 型（非 also）：
🔧 仅手动调用 — 要用它请输入：<command>
-
slash 型（also: true）：
🔧 也可手动输入 <command>（上面的自动触发不依赖这个）
-
hook 型：
⚙️ 自动运行 — 发生下面这些事件时会自动跑：<events 全部>
如果 trigger_modes 为空：
⚠️ 检测不到有效的触发方式——这个 skill 可能永远不会被唤起。
检查 ~/.claude/settings.json 里是否被 deny，或 description 是否写得太少。
如果 description 为空，在"作用"行显示 （没写说明——这个 skill 很难被自动触发，建议补充描述）。
Operations
disable
- Run
show <name> to locate. If multiple matches, disambiguate with the user first.
- Before any write, show the user the exact change you are about to make and ask to confirm.
- Execute:
- user or project source:
- Back up:
cp <path> <path>.bak-<timestamp>
- Edit frontmatter: set
disable-model-invocation: true and user-invocable: false (add these keys right after name: if missing).
- plugin source:
- DO NOT touch the plugin SKILL.md (plugin updates will overwrite it).
- Run
recommend <name> to obtain the exact deny_rule.
- Edit
~/.claude/settings.json: add deny_rule (e.g. "Skill(claude-mem:do)") to permissions.deny (create the nested structure if absent). Preserve all other settings.
- 反馈一行：
已禁用 <name>。撤销：skill-curator enable <name>
enable
- Locate via
show <name>.
- Reverse of disable:
- user/project: either delete the two invocation flags or set them to
false / true respectively. Restore from .bak-<timestamp> if the user prefers a full revert.
- plugin: remove the matching
Skill(plugin:name) entry from permissions.deny.
- 反馈一行：
已启用 <name>
remove
- Run
recommend <name>.
- 输出直接推荐（不做中立多选菜单），rationale 要翻成中文白话，不保留 "permission deny" / "frontmatter flags" 之类术语：
推荐：<白话版 mode>
理由：<中文白话 rationale>
或者：<白话版 alt>
mode 白话对照：
DISABLE (frontmatter flags) → "停用（改文件开关）"DISABLE via permission deny → "停用（在设置里拒绝加载）"UNINSTALL plugin → "整个插件卸载"
- 问一句："按推荐的来吗？（是 / 用备选 / 取消）"
- Execute based on user's pick:
- DISABLE (frontmatter flags) → same flow as
disable on user/project source.
- DISABLE via permission deny → same flow as
disable on plugin source.
- UNINSTALL plugin → DO NOT run the uninstall command silently. Print the exact command for the user's Claude Code version (commonly via the plugin-management UI or
/plugin command) and wait for them to confirm or run it themselves. Uninstall is destructive.
- Hard remove (only offered as
alt for user-level skills):
- Move the skill directory to
~/.claude/skills/.trash/<name>-<YYYYMMDD-HHMMSS>/
- Write a companion file
<trash-entry>/.expires containing the epoch-time cutoff (now + 3 days).
tune-trigger
调触发方式——remix 的 MVP 入口。只管触发相关：开关 auto/manual flag、加/改 description 里的触发关键词、改场景描述。不做 description 其他部分的编辑（那属于未来的完整 tune）。
-
读取现状：运行 show <name>，把当前 trigger_modes 全部念给用户听（每种模式的具体数据：关键词列表、场景原文、slash 命令、hook 事件），并说"你想怎么调？"
-
识别 hook 型 skill：如果 trigger_modes 里有 mode: hook 的条目，告诉用户：
这个 skill 的一部分触发方式是由插件代码里的 hook 定义的（事件：<events>），
不在 SKILL.md 里，tune-trigger 改不了 hook 部分。
但它的关键词/场景触发（如果有）还是可以调。
如果只有 hook 模式：拒绝操作，建议用户去改插件源码或 settings.json。
-
识别诉求：根据用户自然语言，判断属于哪种调整：
- "在我说 X 时也触发" / "加个触发词" → 在 description 里追加一段关键词
- "不要自动触发了，只能手动调" → 把
disable-model-invocation 设为 true
- "反过来，想让它自动出现" → 把
disable-model-invocation 删掉或设为 false
- "场景描述不对，改成 X" → 改写 description 里的场景段
-
插件级 skill 强制先 fork（source == plugin）：
这个 skill 来自 <plugin> 插件（~/.claude/plugins/cache/.../skills/<name>/）。
插件原文件不能改，否则下次插件更新会盖掉你的改动。
我要把它整个 skill 目录复制到 ~/.claude/skills/<name>/，在你的副本上改。
复制完后 Claude Code 会优先用你的手动版（手动 > 插件）。
确认吗？
用户确认后：
cp -r <plugin_skill_dir> ~/.claude/skills/<name>/- 在新副本的 frontmatter 顶部加注释行
# forked from <plugin>@<version> on <date>
- 后续编辑针对用户副本
-
生成 diff 预览：明确展示 frontmatter / description 的改动（Before/After），等用户确认。
-
写入：备份 <path>.bak-<timestamp>（最多保留 5 份），再写新内容。
-
反馈：
- 关键词调整：
已在 <name> 加了 N 个触发词。下次你说"<example>"它就会出来。
- 开关切换：
已把 <name> 改成仅手动调用。要用它请输入 /<name>。 / 已把 <name> 改成自动触发。
- fork：前置反馈
已把 <name> fork 到 ~/.claude/skills/<name>/
mute
把 skill 在当前项目里静音——只影响当前项目，换项目自动复活。典型用法："这个 web 项目里我用不到飞书的 skill"。与 disable（全局停用）的差别就是作用域。
-
定位：运行 show <name>，多个匹配时先消歧。
-
已被全局 disable 的情况：如果该 skill 的 hard_disabled 为 true，告诉用户：
<name> 已经全局 disable 了，本项目里自然也不会触发，不需要再 mute。
如果想恢复全局，用 enable <name>。
然后退出。
-
说明作用域 + 确认：
我要把 <name> 加到 <当前项目目录>/.claude/settings.json 的 permissions.deny 里。
作用域：只当前项目。换到别的项目自动失效，不需要手动 unmute。
对比 disable：disable 是全局的，换项目也不会触发。
确认 mute 吗？
-
执行：python3 ~/.claude/skills/skill-curator/lib/curator.py mute <name>
-
边界：非项目根目录：如果 curator.py 返回非零退出码并提示"当前目录不像项目根"（没有 .claude/、.git/、或常见 package 清单），转达给用户：
当前目录看起来不是项目根，mute 是项目级的——会写到 <cwd>/.claude/settings.json，
但这个目录不像一个项目。要不要改用 disable <name> 做全局停用？
不自作主张创建 .claude/settings.json。
-
反馈：
已在本项目静音 <name>（写入 <project>/.claude/settings.json）。
换项目自动失效，或 skill-curator unmute <name> 立即恢复。
unmute
从当前项目的 settings.json 里撤掉 mute 规则。
-
执行：python3 ~/.claude/skills/skill-curator/lib/curator.py unmute <name>
-
未找到规则：如果当前项目 settings.json 里没有该条 deny 规则，curator.py 会返回相应提示，转达：
本项目里没静音过 <name>，无需操作。
（如果你是想恢复全局停用，用 enable <name>。）
-
反馈：已在本项目恢复 <name>。
Trash auto-purge
At the start of every remove invocation, scan ~/.claude/skills/.trash/. For any entry whose mtime is older than 3 days, rm -rf it. If any were purged, 追加一行：已清理 N 个过期回收站条目。
Safety rules (non-negotiable)
- Never modify files under
~/.claude/plugins/cache/. They are controlled by plugin updates and your edits will be overwritten.
- Always back up user- or project-level SKILL.md files before editing (
.bak-<timestamp>). Keep at most 5 backups per skill (rotate oldest).
- Always show the user the exact diff / change before writing. Wait for their explicit confirmation.
- Never present the "recommended" and "alternative" modes as equal options. The recommendation is direct; the alternative is a one-line override path.
- Never run a plugin uninstall command silently — it removes many skills at once.
Tone
- 用户可见的输出一律用中文白话。不出现 CONFLICT / OVERLAP / Effective / Shadowed / THIN / KEYWORD-RICH / SEMANTIC / AUTO / MANUAL / DISABLED / USER / PLUGIN / PROJECT 这类英文术语（skill 名、插件名、命令名这类专有标识除外）。
- 直接推荐，不说"也许 / 或许 / 你可以看看"。
- 操作反馈一行就够。不复述、不总结、不说"我刚才做了 X"。
- 请求有歧义（比如同名冲突）就问一次，不要猜。
- emoji 不单飞：任何 emoji 出现时必须紧跟中文文本标签。
🪶/🍱/🐘 要带「轻量/中等/重」，🗣️/💭/🔧/⚙️ 要带「关键词/场景/手动/自动」，🔇 要带「本项目静音」。用户不该靠背 emoji 含义来读懂界面。
