周末兴致勃勃装了二十来个 AI Skill，周一想让 AI 跑一下你的周报 Skill，它却回你一句客客气气的"你好，请问有什么可以帮你"——装的全白装。
先别急着卸载重装。多半不是 Skill 本身有问题，而是你不了解它的加载机制。
一、AI 只看见你 Skill 的"两行字"
以 Claude Code 为例，会话启动时它不会把每个已装 Skill 的正文全塞进上下文——那太贵了。系统只读 SKILL.md 头部里的 name 和 description 两个字段当索引常驻着，等你说的话命中了 description，才去加载正文细读。知乎Anthropic官方博客
所以"不触发"的头号原因，是把 description 写成了产品说明书——全是功能概述，没有"什么时候用我"。description 是写给模型看的路牌，不是写给你自己爽的摘要。 可以直接套的思路：使用场景 + 用户口语里会说的动作词 + 具体名词。写"文档处理工具"大概率没人调用，写"当用户说要润色这篇、检查错别字、看能不能发时用"，命中率高一大截。知乎
二、路径和目录名，差一个字就白装
Skill 必须放进官方规范目录：全局是 ~/.claude/skills/<名字>/，项目内是 .claude/skills/<名字>/，而且文件夹名要和 frontmatter 里的 name 严格一致。文件直接扔在根目录、目录名随手起，扫描器根本找不到它。知乎
更隐蔽的是跨目录失效：同一台机器，换个目录启动，Skill 列表说没就没——社交平台上"在 Codex 里找不到"的抱怨，多半是启动工作目录和 Skill 存放路径没对上。小红书
三、装太多，反而互相打架
两个 Skill 的描述语义接近，比如都写着"文档审查"，模型拿不准该用哪个，干脆两个都不用，退化成普通聊天。有团队往库里塞了 47 个测试 Skill，AI 反而更挑不出合适的。解法是各自收紧地盘。一个只管字词错别字，一个只管长文排版评分，边界互斥。知乎
验证就三步，别随机提问碰运气
输入框打一个 / ，看自动补全列表里有没有它；
用斜杠命令显式执行一次；
/clear 清掉上下文，再用一句真实口语测自动触发（“这篇写得怎么样，能不能发”）。
三步全过，才算真装上了。最后补一刀：Skill 是活资产，不是收藏品。 在 Skill 里留个"坑清单"区，接口改了、流程变了随手记进去；三个月没被调用过一次的，删掉——它只会稀释模型的注意力。知乎
别瞎装了，先把装好的弄到能响。
