[开源] Skill Optimizer —— 你的 Skills 可能有一半都没被触发过，这个工具帮你找出来

问题描述：

本帖使用社区开源推广，符合推广要求。我申明并遵循社区要求的以下内容：

• 我的帖子已经打上 开源推广 标签： 是
• 我的开源项目完整开源，无未开源部分： 是
• 我的开源项目已链接认可 LINUX DO 社区： 是
• 我帖子内的项目介绍，AI生成、润色内容部分已截图发出： 是
• 以上选择我承诺是永久有效的，接受社区和佬友监督： 是

以下为项目介绍正文内容，AI生成、润色内容已使用截图方式发出

---

背景

用 Claude Code / Codex 写了不少 skills，但一直有几个问题困扰我：

• 有些 skill 写了就没被触发过，不知道是描述写得不好还是压根没用
• 有些触发了但我每次都要手动纠正，说明触发得不对
• 有些 skill 写得又长又复杂，不知道到底值不值这个 token

手动一个个排查太累了，就写了个 skill 来自动诊断。

它能干什么

不只是检查 SKILL.md 格式，而是挖你的真实 session 数据来分析：

• 漏触发检测 — 你说了"帮我并行跑"但 skill 没响应？找出来
• 用户反应分析 — 触发后你是接受了还是直接否掉了
• Workflow 完成率 — skill 定义了 7 步但每次只跑到第 4 步？定位卡在哪
• 14 项静态检查 — YAML 安全、描述质量、信息位置、token 经济性等
• P0/P1/P2 修复建议 — 不是泛泛而谈，每条建议引用具体研究数据

最后每个 skill 打 5 分制综合评分。

支持平台

Claude Code、Codex、以及所有兼容 Agent Skills 标准的 agent。自动检测你装了哪些平台，扫描对应路径。

安装

粘贴到 agent 对话里就能装：

Install the skill-optimizer skill from https://github.com/hqhq1025/skill-optimizer

装完之后：

/optimize-skill # 扫描所有 skills /optimize-skill my-skill # 只看一个

一点技术背景

分析维度参考了几篇论文，感兴趣的可以看 README 里的 Research Background：

• Memento-Skills — 漏触发是 skill 系统的主要失效模式
• MCP Description Quality — 好描述 vs 随机基线 = 72% vs 20% 选择率，3.6 倍差距
• Lost in the Middle — 关键信息放在文件中间会被 LLM 忽略

GitHub

GitHub - hqhq1025/skill-optimizer: Diagnose and optimize your Agent Skills (SKILL.md) with real session data + research-backed static analysis. Works with Claude Code, Codex, and any Agent Skills-compatible agent. · GitHub

第一个版本，欢迎体验、反馈、提 issue。觉得有用的话给个 star

网友解答：

---

--【壹】--：

好工具，收藏了，但是这个hui’fu’x

---

--【贰】--：

claude我记得是3月初的时候有发布相关的关于skills 测试优化的标准，也可以去借鉴下

---

--【叁】--：

感谢佬的分享！

---

--【肆】--：

好的! 感谢分享 我再去看看有没有什么值得完善补充的地方

---

--【伍】--：

感谢佬友分享！
还停留在很初级的对话辅助编程水平，实在太多了，学不过来啊。
看到佬友们共享的很多经验技巧，开源很多项目，老是沉不下心来，真正用起来的不多。
选择困难症晚期

---

--【陆】--：

貌似在哪里看到过，谢谢分享

---

--【柒】--：

感觉不错，加入收藏清单，不知道在nanobot里面能用不

---

--【捌】--：

可以的 直接跟 nanobot 发链接让他安装就可以 其实最近 Hermes agent 的推出 对于 skills 的生成和优化 跟这个 skills optimizer 的出发点很像!

---

--【玖】--：

确实! 我也是因为这个原因 才萌生的这个想法 目前使用体验还不错 欢迎试一下!

---

--【拾】--：

感谢大佬

---

--【拾壹】--：

这个不错啊，装了一堆skills.每次感觉都没调用

---

--【拾贰】--：

感谢分享，抽空试试看