Skill 的原理：不是工具，是给 AI 的 4 张便签
Skill 现在被各种营销文吹成 AI 时代的新标志，就像你写个 Skill 或给产品配个 Skill，你就在拥抱这个时代。这类文章看了几篇，每篇都喊得响，没几个真把原理讲明白。
很多人写 Skill 时，把它当 API：AI 调用一个 Skill，Skill 返回一个结果。这个误解有个具体来源，是 scripts/ 这个文件夹。看见 scripts，大脑自动跳到工具那边去了。
但 scripts 在 Skill 里只占很小一块；绝大部分内容是文字。AI 不调用文字，AI 读文字。前段时间帮人 review 过几个 Skill。最常见的错是 description 写成”处理 X 类问题”这种，一行话覆盖一整个方向，AI 根本不知道什么时候用。
Skill 的原理就一件事。 哪段文字什么时候出现在 AI 眼前。
老员工在墙上贴的那几张便签
想象一个老员工，工位旁边的墙上贴了几张便签。
第一张贴在最显眼的位置，写的是”我管什么”。客户问题归我处理，合同条款不归我管，bug 找研发别找我。这张永远在那，每个路过的同事都瞥得见。
第二张贴在抽屉里。要处理客户问题的时候，他才把抽屉拉开来看。里面写着这个场景下该怎么做、注意什么、什么时候找经理。
第三张是更厚一沓，压在最下面。具体到某个客户、某条规则、某个例外才会翻出来对一下，平时不动。
AI 读你写的 Skill，也是这三层。
三层文字，三种进场时机
第一层是 description。这是贴在最显眼位置的那张便签，永远在 AI 的上下文里。AI 凭这一行决定这件事归不归这个 Skill 管。
抽屉里那一张是 SKILL.md 正文。AI 决定归这个 Skill 管，才把整篇塞进上下文。一次几百行，不便宜。
最底下一沓压着 references/ 里的参考资料。AI 在读 SKILL.md 时发现要看某个具体的东西，才会去翻。平时根本不动。
references 这一层我自己也常忘拆。明明能拆出去，懒得动。结果就是每次都把一堆没用的塞进上下文。
那 scripts/ 呢
老员工的工位上，墙上贴着便签，桌上还放着一个计算器。便签是写给眼睛看的，计算器是用来按的。
scripts/ 就是那台计算器。AI 从不读 scripts 里的代码。AI 看到 SKILL.md 写”用这个脚本算一下”，调一次，看输出。脚本里有多少行、怎么算的，AI 全不关心。
scripts 出现在 Skill 文件夹里，让人误以为整个 Skill 都是工具。其实只有这一小块是。剩下三层，全是给 AI 看的文字。
实际上多数 Skill 根本没有 scripts 这个文件夹。即使真要放一个脚本，放在 Skill 文件夹里也不一定是最佳做法。
分不清这件事，Skill 就漂
description 写不清，AI 不知道什么时候用，整个 Skill 不被触发。SKILL.md 写得太长，每次都加载一大堆，AI 中间一段就漏看，行为飘忽。
references 全堆在 SKILL.md 里没拆出去，AI 永远在读那些只有百分之一概率用到的内容，白占上下文。该跑脚本的事写成 SKILL.md 步骤，AI 一步步推理，慢、贵、还可能算错。
看到 SKILL.md 写一千行的 Skill，每次触发都把那一千行塞上下文。看一次烧一次，作者自己都说不清什么时候会触发。
你写 Skill 时，记住这一件事：每段内容，什么时候出现在 AI 眼前。
口诀就 4 句：
description 永远在。SKILL.md 触发才在。references 找才在。scripts 不读，是 AI 调的。
你的 Skill 没人触发，多半不是 Skill 写得不好，是 description 那一行话写得太礼貌。你上次写 description 时，是在描述触发场景，还是在描述 Skill 自己？
记住这件事，Skill 就不会写漂。