> ## Documentation Index
> Fetch the complete documentation index at: https://datagen.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Skills

> 把 Skill 資料夾上傳到工作區登錄庫、審核並核准，再安裝到 Agent、知識庫與 App

**Skill** 是打包成資料夾的可重複使用做法：一份含有指示的 `SKILL.md`，加上它需要的任何腳本、範本或參考檔案。Skill 在任何東西使用它之前都必須經過審核，讓工作區能控管 Agent 會遵循哪些指示。

流程永遠相同：**上傳** Skill 資料夾、審核者**核准**，再把核准的版本**安裝**到需要的地方。

在側邊欄開啟 **更多 → 技能**（`/signalgen/skills`）。這個頁面有兩個分頁：**技能**（已核准的 Skill）與 **審核佇列**（待審核的提交）。

## 準備 Skill 資料夾

Skill 資料夾的結構如下：

```text theme={null}
weekly-report/
├── SKILL.md
├── template.md
└── scripts/
    └── build_report.py
```

`SKILL.md` 以 frontmatter 開頭：

```markdown SKILL.md theme={null}
---
name: weekly-report
description: 以公司格式撰寫每週業務管線報告。當使用者要求每週摘要、狀態報告或管線更新時使用。
---

# 週報

1. 載入本週的數字 ...
2. 填入 template.md ...
```

上傳內容會先經過驗證：

| 規則 | 限制 |
| - | - |
| 資料夾名稱（即 Skill 名稱） | 小寫英文字母、數字與 `-`，以字母或數字開頭，最多 64 個字元 |
| `SKILL.md` | 只能有一個，位於資料夾根目錄，且內文不可為空 |
| frontmatter 中的 `name` | 選填；若有填寫，必須與資料夾名稱相同 |
| frontmatter 中的 `description` | 必填，最多 1,536 個字元 |
| 大小 | 最多 100 個檔案、單檔 1 MiB、總計 5 MiB |
| 不允許 | `.git`、`.hg`、`.svn`、`node_modules` 與 `.claude-plugin` 資料夾；`.mcp.json`、`settings.json` 與 `settings.local.json` 檔案 |

`__MACOSX` 資料夾與 `.DS_Store` 檔案會被忽略。有兩種情況會產生給審核者看的**警告**而非錯誤：`SKILL.md` 超過 500 行，以及 `SKILL.md` 使用了動態 shell context 注入。

<Tip>
  `description` 請寫成「它做什麼，以及何時使用」。Agent 就是讀這段文字來判斷這個 Skill 是否適用。
</Tip>

## 上傳 Skill

<Steps>
  <Step title="開啟上傳對話框">
    在技能頁面點選 **上傳技能**。
  </Step>

  <Step title="選擇目標執行框架與可見範圍">
    * **目標執行框架**：這個 Skill 撰寫時針對的 Agent 執行環境，**Claude Agent SDK** 或 **Codex**。請見 [Harness](/zh/foundation/harness)。
    * **可見範圍**：**工作區** 讓 Skill 只留在這個工作區。**公開** 則在平台管理員核准後提供給所有工作區。
  </Step>

  <Step title="加入資料夾">
    選擇一個 Skill 資料夾，或把一個或多個資料夾拖放到對話框中。每個資料夾都必須包含自己的 `SKILL.md`。
  </Step>

  <Step title="送出">
    點選 **送審**。每個 Skill 都會以待審核版本的形式出現在 **審核佇列** 中。
  </Step>
</Steps>

再次上傳同名資料夾會提交下一個版本（v2、v3…），每個版本都會分別審核。只有 Skill 的建立者或管理員可以提交公開 Skill 的新版本。

## 審核：核准或拒絕

開啟 **審核佇列** 分頁。在 **待審核** 中，每筆提交都會顯示版本、上傳者，以及驗證警告的數量。決定前可以開啟提交內容，查看 **驗證檢查** 並瀏覽其 **檔案**。

點選 **核准** 或 **拒絕**。

| Skill 可見範圍 | 誰可以核准或拒絕 |
| - | - |
| **工作區** | 該工作區的 **Admin**，以及平台管理員 |
| **公開** | 只有平台管理員，因為核准會把 Skill 發布到所有工作區 |

核准某個版本後，它會成為該 Skill 的目前版本，並出現在 **技能** 分頁的 **已核准的技能** 表格中，顯示可見範圍、版本、作者、審核者與執行框架。

### 撤銷

平台管理員可以**撤銷**已核准的版本。被撤銷的版本無法再安裝，Skill 會退回到最近一個仍有效的已核准版本，而既有的安裝會顯示 **已撤銷** 標籤，提醒你更新或移除。

<Note>
  核准針對的是 Skill 的內容。安裝則是在每個 Agent、知識庫或 App 上另外做的決定，並且需要在該處具有 **Admin** 或 **Builder** 角色。
</Note>

## 安裝 Skill

已核准的 Skill 可以安裝在三個地方。安裝的位置決定由誰使用它。

| 安裝在 | 位置 | 由誰使用 | 會隨成果一起發布嗎？ |
| - | - | - | - |
| **Agent** | Agent 的 **工具** 分頁 → **技能** | Agent，每次執行都會使用 | 會。複製到 Agent 的 `.claude/skills/`，成為其檔案的一部分 |
| **知識庫** | 知識庫的 **技能** 分頁 | 只有 AI Context Builder | 不會。永遠不會發布到 `.context/<slug>/` |
| **App** | App 的 **工具與知識** 分頁 → **技能** | 只有 App Builder | 不會。永遠不會隨 App 版本發布 |

<Tabs>
  <Tab title="Agent">
    開啟 Agent，再開啟 **工具** 分頁。在 **技能** 卡片中搜尋已核准的 Skill、選取後點選 **新增**。Skill 會複製到 Agent 的 `.claude/skills/`，並在每次執行時載入沙盒。

    連結到 GitHub repository 的 Agent 無法從這張卡片安裝登錄庫中的 Skill，請改為把 Skill 資料夾加入 repository 的 `.claude/skills/`。
  </Tab>

  <Tab title="知識庫">
    開啟知識庫，再開啟 **技能** 分頁。搜尋已核准的 Skill 並點選 **安裝**。建置器可以立即使用它，包括已經開啟的工作階段，而建置器的 **技能** 清單會顯示已安裝的項目。

    這適合用來安裝協助**建立**知識庫的 Skill，例如摘要的寫作風格，或轉換檔案格式的腳本。
  </Tab>

  <Tab title="App">
    開啟 App，再開啟 **工具與知識** 分頁。在 **技能** 中搜尋已核准的 Skill 並點選 **安裝**。這個 Skill 只存在於 App Builder 的沙盒中。
  </Tab>
</Tabs>

### 版本與更新

每次安裝都會**固定**在你安裝的版本。有更新的版本通過核准時，安裝項目會顯示 **有新版本**（在 Agent 上則是一個標示兩個版本號的更新按鈕）。更新必須明確操作，因此核准新版本永遠不會在沒有人決定的情況下改變執行中的 Agent。

若要移除 Skill，點選旁邊的移除按鈕。Skill 仍會保留在登錄庫中。

<Warning>
  與建置器映像內建 Skill 同名的 Skill —— 例如 `datagen-data` 或 `datagen-app-builder` —— 無法安裝在知識庫或 App 上。請重新命名 Skill 資料夾後再次提交。
</Warning>

## Skill、知識庫還是記憶？

* **Skill** 用於**如何**做某件事：流程、格式、腳本。
* **知識庫** 用於**什麼**是事實：政策、產品資訊、參考表。請見 [建立知識庫](/zh/context/build)。
* **記憶** 用於 Agent 在工作中學到的東西。請見 [記憶](/zh/context/memory)。

## 下一步

<CardGroup cols={2}>
  <Card title="記憶" icon="brain" href="/zh/context/memory">
    讓 Agent 在多次執行之間記住學到的東西。
  </Card>

  <Card title="Agent 總覽" icon="robot" href="/zh/agents/overview">
    在 Agent 中整合知識庫、Skill 與工具。
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.