你的 Skill 写了一大堆,AI 死活不触发?看看 skill-management

你有没有这种感觉——自己写的 SKILL.md,越写越长,最后塞了一堆”这个技能可以做什么”进去,AI 却根本不知道什么时候该触发它?

这不是你一个人遇到的问题。oakoss 写的 skill-management,就是来解决这个的。

它不是一个用来完成业务功能的 Skill,而是一个关于 Skill 本身的元技能——专门教你怎么创建、规范、审计一个真正能被 AI 正确触发的高质量 Skill。

核心内容是什么

skill-management 围绕 Agent Skills 开放标准(agentskills.io)展开,覆盖一个 Skill 从诞生到上线的完整生命周期:

创建阶段:SKILL.md 的标准结构怎么搭,YAML frontmatter 怎么写才规范,description 字段怎么写才能被 AI 发现而不是自嗨式描述。

描述规范:Skill 的 description 是 AI 判断”要不要用这个技能”的唯一依据。这个 Skill 详细拆解了优秀 description 的公式——第一段写”能做什么+核心技术”,第二段写”触发场景+错误关键词”,250-350字符,缺一不可。

渐进式披露:SKILL.md 不是把所有内容都塞进去。skill-management 告诉你哪些放元数据、哪些放 SKILL.md 主文件、哪些放到 references/ 目录下按需加载——这直接决定了 AI 加载 Skill 时的 token 消耗。

审计流程:提供了一个 9 阶段系统审查流程,从 YAML 格式、命名规范、官方文档一致性,到代码示例准确性、跨文件引用完整性,一项项过。发现的问题按 Critical/High/Medium/Low 四级分类,每级都要有证据才能定级。

为什么值得装

如果你在用 Claude Code 或者团队在维护一套 Skill 库,这个 Skill 的价值在于让你少走弯路

比如”description 怎么写”这件事,大多数人第一反应是”这个技能帮助我XXX”,但 skill-management 明确说——要用第三人称主动语态,”Build X”而不是”This skill helps you build X”。这一个点改过来,你写的 Skill 触发准确率能提升一截。

再比如它提供的 Common Mistakes 表格,列举了 8 种典型错误,包括”把 README.md 也放进 skill 目录””description 里没有触发关键词””把全部内容都塞进 SKILL.md 不做渐进式披露”——这些都是真实踩过的坑。

安装方式

npx skills add oakoss/agent-skills --skill skill-management

安装后在 Claude Code 里直接说”帮我创建/审计一个 Skill”,它就会按照标准流程引导你走完。

总结一下

skill-management 适合:已经在用 Agent Skills、想提升 Skill 质量、或需要团队共享 Skill 规范的开发者。它不帮你写业务代码,但它帮你把 Skill 写得规范、可触发、易维护——这是 Skill 生态里经常被忽略的基础功。

GitHub:https://github.com/oakoss/agent-skills


GitHub: https://github.com/oakoss/agent-skills

评论区

0 条评论

登录后可评论。

江望 12 阅读