# Skill

Skill 是写给 AI 的做事方法：一个带 `SKILL.md` 的文件夹，可再带脚本和参考资料。请求和某个技能的说明对得上时，AI 开工前先读这个技能。

## 文件夹

| 部分 | 内容 |
|---|---|
| `SKILL.md` | 开头一段写 `name` 和 `description`，后面用平常的话写方法 |
| `scripts/` | 可选，技能要运行的代码，比如 `run.mjs` |
| `references/` · `assets/` | 可选，AI 需要时才读的资料 |

## 技能放在哪

| 来源 | 文件夹 | 谁能改 |
|---|---|---|
| 本机 | `<Cowork 主目录>/skills/` | 你和本机上的 AI |
| 工作区 | `<工作区>/.agents/skills/` | 你和 AI；跟着文件夹走 |
| 你的主目录 | `~/.agents/skills/` | 你 |
| 平台 | `<Cowork 主目录>/platform_skills/` | 只读；由 Micromeet 更新 |
| 机构 | `<Cowork 主目录>/institution_skills/<机构 ID>/` | 只读；由 Micromeet 更新 |

## 规则

- `SKILL.md` 开头必须有 `name` 和 `description`。description 写它做什么、什么时候用。
- JavaScript、TypeScript 脚本用 Cowork 自带的 Bun 运行，不用另装 Node 或 Python。
- 要新建技能，在对话里让 AI 做。它会建好文件夹并检查格式；从你的下一条消息起就能用。

## 相关

- [技能是什么](https://docs.micromeet.ai/zh/skills/what-are-skills.md): 从使用者角度看技能
- [技能怎么写](https://docs.micromeet.ai/zh/skills/skill-anatomy.md): 开头和方法怎么写
- [搭建第一个技能](https://docs.micromeet.ai/zh/skills/first-skill.md): 让 AI 帮你做一个