Skill 文件结构

一个 Skill 就是一个文件夹，里面几样东西各有各的用途。拆开看就懂了。

---

为什么需要知道这个

你要装一个从网上下载的 Skill，解压后会看到一个文件夹，里面好几个文件。知道每个文件干嘛的，你才能：

• 心里有数：这东西装到我电脑里都放了些什么
• 出了问题知道去哪找原因（比如「为什么装了没反应」→ 去看 SKILL.md 的触发条件）
• 以后想自己写 Skill，知道从哪下手

---

一个 Skill 的全部家当

skill名称/            ← 文件夹就是 Skill 的名字
├── SKILL.md          ← 核心文件，必须有
├── README.md         ← 给用户看的说明书
├── scripts/          ← 脚本文件（可选）
├── references/       ← 参考资料（可选）
└── assets/           ← 动图、模板等资源（可选）

下面逐一拆开讲。

---

1. SKILL.md —— 核心大脑

这是整个 Skill 唯一必须有的文件。没有它，这就是个普通文件夹，AI 不认。

打开来看，分两部分：

顶部（YAML 头）：三行元信息，告诉牛马AI「什么时候触发我」

---
name: 元提示词                              # Skill 名称
description: 用 BROK 框架优化提示词……        # 一句话描述，AI 用它判断要不要触发
---

正文（Markdown）：给 AI 看的详细指令——遇到这类问题时，按什么流程、用什么规则来处理。就是一本给 AI 看的工作手册。

你关心什么	看 SKILL.md 的哪部分
这个 Skill 什么时候触发	顶部的 description
触发后 AI 会怎么做	正文的工作流程

---

2. README.md —— 给人类看的说明书

和 SKILL.md 不一样——SKILL.md 是写给 AI 看的，README.md 是写给你看的。

里面通常是：

• 这个 Skill 是干嘛的（人类语言版）
• 怎么安装、怎么用
• 常见问题

装完之后你可以删掉，不影响 Skill 功能。

---

3. scripts/ —— 让 AI 动手的脚本

Skill 不仅能「告诉 AI 该怎么想」，还能「告诉 AI 该怎么干」。

scripts/ 文件夹里放着可执行的脚本（Python、Bash 等），AI 识别到你让它干的活需要跑脚本时，就会调用这里的文件。

比如一个「简历优化」Skill 可能有：

scripts/
├── parse_resume.py      # 从 PDF 里提取简历文本
└── format_output.py     # 把优化结果排版成 Word

大多数 Skill 不需要 scripts 文件夹。 如果解压出来没有也很正常。

---

4. references/ —— AI 的参考资料库

就像你写论文时要查阅参考文献，AI 处理复杂问题时也需要参考资料。

references/ 里放着 AI 在干活的中间阶段可以查阅的资料——不用每次都查，只在需要的时候加载。

比如一个「数学建模」Skill：

references/
├── 常用模型库.md       # 什么时候用线性回归、什么时候用决策树
├── 论文写作模板.md     # 建模论文的标准格式
└── 历届赛题分析.md     # 过去五年的考点整理

好处：这些东西不塞进 SKILL.md（会太长），而是「要用才看」，省 Token。

---

5. assets/ —— 静态资源

图片、动图、模板文件、字体文件——AI 不读这些，但输出的结果里可能会用到。

比如一个「PPT 制作」Skill：

assets/
├── 模板.pptx           # PPT 排版模板
├── 学校logo.png        # 品牌素材
└── 配色方案.json       # 标准色板

大多数 Skill 不需要 assets，没有也正常。

---

一句话总结

文件/文件夹	给谁看的	干嘛的	必须有？
SKILL.md	AI	Skill 的「脑子」，定义触发条件和做事流程	✅ 必须有
README.md	你（人类）	安装说明、使用教程	❌ 可删
scripts/	AI	可执行脚本，让 AI 能干实际操作的活	❌ 多数没有
references/	AI	参考资料，用时才查，省 Token	❌ 多数没有
assets/	最终输出	模板、图片等静态资源	❌ 多数没有

---

知道了这些，然后呢

• 装第三方 Skill 时看到了 scripts/ → 说明这个 Skill 会动手操作你的文件，留个心
• 装了没反应 → 先读 SKILL.md 顶部的 description，看触发条件是什么
• 想自己写 Skill → 只需要创建一个文件夹 + 一个 SKILL.md，其他四个可有可无