Skills

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

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

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

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

​

準備 Skill 資料夾

Skill 資料夾的結構如下：

weekly-report/
├── SKILL.md
├── template.md
└── scripts/
    └── build_report.py

SKILL.md 以 frontmatter 開頭：

SKILL.md

---
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 注入。

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

​

上傳 Skill

1. 開啟上傳對話框

   在技能頁面點選 上傳技能。

2. 選擇目標執行框架與可見範圍

   • 目標執行框架：這個 Skill 撰寫時針對的 Agent 執行環境，Claude Agent SDK 或 Codex。請見 Harness。
   • 可見範圍：工作區 讓 Skill 只留在這個工作區。公開 則在平台管理員核准後提供給所有工作區。
3. 加入資料夾

   選擇一個 Skill 資料夾，或把一個或多個資料夾拖放到對話框中。每個資料夾都必須包含自己的 SKILL.md。

4. 送出

   點選 送審。每個 Skill 都會以待審核版本的形式出現在 審核佇列 中。

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

​

審核：核准或拒絕

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

點選 核准 或 拒絕。

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

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

​

撤銷

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

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

​

安裝 Skill

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

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

Agent

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

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

知識庫

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

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

App

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

​

版本與更新

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

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

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

​

Skill、知識庫還是記憶？

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

​

下一步

記憶

讓 Agent 在多次執行之間記住學到的東西。

Agent 總覽

在 Agent 中整合知識庫、Skill 與工具。