给 AI 写一本
它自己会翻的操作手册
我拆了 304 个真实的 Skill，把它们的骨架、套路、写法全扒出来了。 看完这一页，你能写出属于自己的那一个 —— 不用会写代码。
01Skill 到底是什么？
一句话：给 AI 的一份操作手册。它不是程序，就是一段有格式的文字。
平时你用 AI，每次都得重新交代一遍背景。写成 Skill，就是把这套交代固化下来， 以后说一句「用你会的那招」就行。
先看一个完整的、最小的 Skill
下面这个是全文，一个字没删（352 字）。
就这么点东西，但它已经把「什么时候用、读什么、输出什么」全说清楚了。
02一个 Skill 就是两半
建一个文件夹，里面放一个 SKILL.md。这个文件分两截：
--- name: 你的技能名 description: 什么时候该用它 + 它能干什么 version: 1.0.0 --- # 正文：具体怎么做 （这里写步骤、规则、例子）
绝大多数人写 Skill 写废，不是正文写得差，是头部没让人看懂「什么时候该用它」。
03description 是命门
凭这一行，AI 决定要不要想起你。我把 304 个真实 Skill 的描述全量了一遍：
长短不重要，说清「什么时候用」才重要。实战里能打的写法就三派：
自动读取店铺、产品、广告、询盘、订单和团队资料，诊断国际站增长卡点，并拆解老板、运营、业务、广告、供应链的具体任务。
…触发词：品牌战略、品牌屋、品牌定位、首页文案、详情页文案、competitive messaging、品牌落地。
当商品曝光量稳定或上升，但点击率下降幅度超过20%时，使用本技能系统排查并优化产品主图、商品标题、定价策略和流量定向设置。不适用于曝光量同步下降或新上线无历史数据的商品链接。
「当用户……时，使用本技能……」+ 一句「不适用于……」
前半句管触发，后半句管边界。两句写完，你就比 80% 的人强了。
04正文不用写得有多好，要写得有结构
挑一个真实案例拆给你看：b2b-inquiry-diagnosis（2119 字，被下载了两万多次）。
它讲 5 个诊断维度，每个维度都是同一个三段式：
因为 AI 不是只会照做的机器。你告诉它「为什么」，它碰到你没写到的情况，才能自己判断。
只写「要这样」，它遇到新情况就傻了；写了「为什么这样」，它会举一反三。这一步是新手和老手的真正分水岭。
常见骨架，挑一个套
05五步写完一个 Skill
但它是效果最猛的。给一个真实的输入输出例子，比写十条规则都管用 —— AI 看例子学得比看规则快。
06现场生成一个
填三个空，拿走你的骨架。回家把正文填上就是你的 Skill。
在上面填点东西，这里就出来了。
07什么时候该拆成多个文件
一开始一个 SKILL.md 就够了。出现下面两种情况再拆：
- 正文超过 3000 字 —— 太长 AI 会抓不住重点，拆成主文件 + 参考文档
- 有固定素材 —— 比如词库、话术模板、检查清单，单独放一个文件，正文里指个路就行
我扒的这批案例里，最复杂的一个带了 39 个附属文件，正文也才 3 千字 —— 它把重活都丢给附属文件了。
还有个东西叫 evals
有些 Skill 里有个 evals/ 文件夹，装的是几组「输入 → 期望产出」。
它的作用是：你以后改了内容，跑一遍就知道有没有改坏。跟写代码要跑测试是一个道理。
个人用不写也行，但你要是想把这个 Skill 交给团队里其他人用，强烈建议写。
08案例库：61 个真实 Skill，随便翻
挑的都是有代表性的 —— 352 字的最小体、3 万字的工业化大件、 带脚本的、带知识库的，各种形态都有。点开看全文，可以照着抄结构。
还有 243 个没放出来
案例库这里只放了一部分。剩下 243 个真实 Skill 的完整文件、
加上一批可以直接改成自己用的模板，都在群里。
进群领 · 有问题也可以直接问