建立與發佈技能
建構自己的技能並分享到技能市集
任何擁有 Claw Buff 帳號的人都可以在技能市集上建立和發佈技能。
建立技能
編輯器
技能編輯器有兩個面板：
左側面板 — SKILL.md 內容：
用 Markdown 撰寫技能指令。這是技能的核心——教導 Agent 如何執行任務的提示詞文件。你還可以上傳選用的腳本檔案（JS/TS）用於進階行為。
右側面板 — Metadata：
| 欄位 | 必填 | 描述 |
|---|---|---|
| 名稱 | 是 | 顯示名稱（至少 2 個字元） |
| 描述 | 是 | 卡片上顯示的簡短摘要 |
| 分類 | 是 | 開發、生產力、通訊等其中之一 |
| 標籤 | 否 | 逗號分隔的探索標籤 |
| 版本 | 是 | 語意化版本（如 1.0.0） |
撰寫好的 SKILL.md
技能的品質完全取決於指令的清晰度。遵循以下結構：
---
name: my-skill
description: 一句話描述這個技能做什麼
version: 1.0.0
---
# My Skill
## 概述
簡要說明 Agent 使用此技能能做什麼。
## 指令 / 工作流程
Agent 應遵循的逐步指令。
明確指定使用哪些工具以及順序。
## 範例
展示具體的輸入/輸出範例，
讓 Agent 理解預期行為。
## 限制
此技能不能做什麼或不應嘗試什麼。最好的技能是專注且具體的。一個做好一件事的技能比試圖涵蓋所有的更有用。想「GitHub PR 審查器」而不是「通用程式碼助手」。
儲存與發佈
你有兩個選項：
- 儲存草稿 — 儲存但不發佈。只有你能看到草稿。適用於開發中的技能。
- 發佈 — 提交技能進行審核，審核通過後在市集上架。
審核流程
發佈技能時，會發生以下步驟：
- 自動安全掃描 — 腳本檔案（如有）會被掃描已知惡意模式（反向 shell、資料外洩、憑證竊取）。
- 審核狀態 — 通過掃描的含腳本技能設為「待審核」。不含腳本的技能（僅 SKILL.md）自動通過。
- 通知 — 技能被核准或拒絕時你會收到通知。被拒絕的技能包含審核說明。
僅包含 SKILL.md（無腳本檔案）的技能會自動通過，因為它們是純提示詞文件，沒有可執行程式碼。加入腳本會觸發安全審核流程。
管理你的技能
我的技能
在市集頁面點擊我的技能標籤查看所有技能及其狀態：
| 狀態 | 含義 |
|---|---|
| 已發佈（綠色） | 在市集上架，所有人可見 |
| 待審核（橙色） | 已提交，等待核准 |
| 已拒絕（紅色） | 被拒絕並附有審核說明——編輯後重新提交 |
| 未發佈（灰色） | 草稿或手動取消發佈 |
編輯
點擊你的任何技能在編輯器中開啟。你可以更新：
- SKILL.md 內容
- Metadata（名稱、描述、分類、標籤）
- 版本號
- 腳本檔案
對已發佈技能的變更儲存後立即生效。
取消發佈
要暫時從市集下架技能而不刪除它：
- 在編輯器中開啟技能
- 在危險區域點擊取消發佈
技能變為草稿。你可以隨時重新發佈。
刪除
要永久刪除技能：
- 在編輯器中開啟技能
- 在危險區域點擊刪除
- 確認刪除
刪除是永久性的，無法復原。如果使用者已安裝你的技能，已安裝的副本會保留在他們的 Agent 上，但不會再有後續更新。
最佳實務
- 指令要具體。 「幫使用者處理 GitHub」太模糊。「使用
gh pr create建立包含已暫存變更的 Pull Request」才是可操作的。 - 包含範例。 展示好的輸入和輸出。這能大幅提高技能的可靠性。
- 宣告相依性。 如果技能需要 API 金鑰或二進位檔，在 SKILL.md 的 frontmatter 和描述中清楚說明。
- 有意義地版本化。 做出變更時遞增版本號。使用者和平台會追蹤版本記錄。
- 發佈前測試。 在自己的 Agent 上安裝技能，驗證其按預期運作後再公開。
- 寫清楚描述。 這是使用者最先看到的。要具體——這個技能到底能為他們的 Agent 做什麼？