# Skills
URL: /zh-CN/docs/customize/skills

用户、.spirit、.agents 下的 Skill，以及内置的 create-rule、create-skill、create-hook。



Skill 是带 `SKILL.md` 的文件夹。Spirit 从三处发现：

| 范围         | 路径                                           |
| ---------- | -------------------------------------------- |
| 用户         | `{spiritDataDir}/skills/{name}/SKILL.md`     |
| 工作区 Spirit | `{workspace}/.spirit/skills/{name}/SKILL.md` |
| 工作区 agents | `{workspace}/.agents/skills/{name}/SKILL.md` |

你在某一回合点名某个 Skill 时，Spirit 可以把全文附到那条用户消息上。它不会把所有 Skill 塞进 system。

## Frontmatter [#frontmatter]

`SKILL.md` 必须以 Frontmatter 开头。缺少 `name` 或 `description` 时不会被发现。

| 参数            | 说明                                         |
| ------------- | ------------------------------------------ |
| `name`        | 必填。Skill 名称，须与文件夹名一致。1–64 个字符，仅小写字母、数字和连字符 |
| `description` | 必填。简短说明                                    |

## 内置 Skills [#内置-skills]

这些随 Spirit 提供（不在你的数据目录里）：

* `create-rule` — 起草一条 [rule](./rules.mdx)
* `create-skill` — 起草一个 [Skill](./skills.mdx)
* `create-hook` — 起草一个 [hook](./hooks.mdx)

在 **设置 → Skills** 管理。Git 的 commit / push / merge chip 是宿主 UI，不是内置 Skill。见 [Desktop](../desktop.mdx)。