# 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-tw/skills/what-are-skills.md): 從使用者角度看技能
- [技能怎麼寫](https://docs.micromeet.ai/zh-tw/skills/skill-anatomy.md): 開頭和方法怎麼寫
- [搭建第一個技能](https://docs.micromeet.ai/zh-tw/skills/first-skill.md): 讓 AI 幫你做一個