返回文档中心
入门
什么是 Skill？
理解 Skill 是使用 Skill 工坊的第一步。
一句话解释
Skill 是一份可复用的 AI 指令文件，由 YAML 元数据和 Markdown 格式的执行规范组成。 它告诉 AI 在特定场景下该怎么处理、遵循什么标准、产出什么结果。 导入到 Claude、Cursor、Trae 等工具后，AI 在需要时自动加载并严格按规范执行。
Skill 的文件结构
每个 Skill 是一个包含 SKILL.md 的目录，由两部分组成：
| 部分 | 字段 | 作用 |
|---|---|---|
| YAML 元数据 | name | 技能名称，也是手动调用的命令 |
| YAML 元数据 | description | 描述这个 Skill 做什么、何时触发 |
| YAML 元数据 | allowed-tools | 声明该 Skill 需要的工具权限 |
| Markdown 正文 | 指令内容 | AI 执行时遵循的规范——可以是流程步骤、编码标准、输出模板，或角色设定 |
两种常见用法
参考知识类
注入编码规范、API 设计约定、领域知识。AI 在工作时自动引用，确保输出符合团队标准。
例：API 命名规范、数据库设计约定、品牌文案风格指南
任务流程类
定义从输入到输出的完整步骤。手动调用 /skill-name，AI 按流程执行。
例：PR 审查、部署检查清单、短视频脚本生成
和提示词有什么不同
- 提示词是一次性的对话指令，用完即弃。
- Skill 是持久化的结构化文件——写好一次，反复调用，可以在团队间共享。
- Skill 有明确的触发条件（description 字段），AI 能在合适的场景自动加载，不需要每次都手动粘贴。
- Skill 支持懒加载——平时只有名称和描述挂在上下文里，被调用时才展开完整内容，不浪费 token。
Skill 不是什么
- 不是独立的 App，需要运行在支持它的 AI 工具里
- 不是训练出来的模型，是给现有 AI 的指令文件
- 不需要编程知识——用自然语言和 Markdown 就能写