Agent Skills 是什麼：agentskills.io 開放標準與 SKILL.md 規範（哪些工具支持、怎麼校驗）

本文根據 agentskills.io 官方站點、規範文檔和 agentskills/agentskills 倉庫整理，資料核對於 2026-10-10。規範仍在演進，以官方規範頁為準。

是什麼

逛 Skill 庫之前，先弄清「一個 Skill 到底長什麼樣」會省很多事。Agent Skills 是一套開放格式：一個技能就是一個文件夾，裏面必須有一份 SKILL.md，開頭用 YAML 寫元數據（至少有 name 和 description），正文用 Markdown 寫給智能體看的操作說明；文件夾裏還可以帶 scripts/（可執行腳本）、references/（參考文檔）、assets/（模板和資源）。

官網說明，這個格式最初由 Anthropic 開發，隨後作為開放標準發佈，現在由社區在 agentskills/agentskills 倉庫裏共同維護，接受生態各方貢獻。正因為有這份標準，同一個技能文件夾才能在不同廠商的智能體裏通用——本目錄裏絕大多數 Skill 庫都是按它寫的。

截至 2026-10-10，GitHub 顯示規範倉庫約 2.6 萬 Star、2,000 Fork，最近一次推送在 2026-08-09。

包含哪些 Skill

這個倉庫不提供成品技能，提供的是規範和工具：

• 規範（Specification）：規定目錄結構和 SKILL.md 的字段。name 必填，最長 64 個字符，只能用小寫字母、數字和連字符，且要和文件夾同名；description 必填，最長 1024 個字符，要寫清「做什麼」和「什麼時候用」；可選字段有 license、compatibility（運行環境要求）、metadata 和實驗性的 allowed-tools。
• 漸進式加載的約定：啟動時只讀每個技能的名稱和描述（約 100 個 token）；任務匹配時才加載 SKILL.md 全文（建議不超過 5000 個 token、500 行）；腳本和參考文件按需再讀。所以裝很多技能也不會把上下文塞滿。
• skills-ref：參考實現庫，可以校驗一個技能是否符合規範。
• 文檔站：快速上手、技能寫作指南，以及支持該標準的客戶端清單。
• 成品示例指向 anthropics/skills 倉庫。

官網列出的支持方（部分）：Claude Code、Claude、ChatGPT 與 Codex、Cursor、GitHub Copilot、VS Code、Gemini CLI、OpenCode、Goose、Amp、Kiro、TRAE、Roo Code、Junie、Factory、OpenHands、Hermes Agent、OpenClaw、Mistral Vibe 等數十個。

怎麼安裝

標準本身不用安裝，照着寫就行。校驗自己寫的技能用規範頁給出的命令：

bash
skills-ref validate ./my-skill

它會檢查 SKILL.md 的元數據是否合法、命名是否符合約定。skills-ref 的獲取方式見倉庫裏的 skills-ref 目錄。

技能寫好後放到哪裏，取決於你用的智能體，各家文檔給出的位置不同：

• Claude Code：~/.claude/skills/<技能名>/（個人）或項目裏的 .claude/skills/<技能名>/；
• Codex：倉庫內 .agents/skills，或用戶級 $HOME/.agents/skills；
• 其他工具見 agentskills.io 的客戶端清單，每個條目都連結到對應產品的技能文檔。

怎麼用

• 寫一個最小技能：新建文件夾 weekly-report/，在裏面的 SKILL.md 開頭寫上 name: weekly-report 和一句描述，正文寫步驟；放進上面的目錄後，對智能體說「幫我寫本週週報」，描述匹配時它就會加載。
• 判斷一個第三方技能寫得好不好：看 description 是否具體、SKILL.md 是否短而清楚、長資料是否拆到 references/、腳本是否說明了依賴——這些都是規範裏的建議。
• 檢查兼容性：技能如果寫了 compatibility 字段，會說明它面向哪個產品、需要哪些系統依賴或聯網權限，裝之前先看一眼。

適合誰 / 不適合誰

適合：

• 準備自己寫技能、或要在團隊裏統一技能寫法的人；
• 想知道「這個技能能不能在我的工具裏用」的用戶；
• 做智能體產品、要接入技能支持的開發者。

不適合：

• 只想找現成技能直接用的人——去看官方技能倉庫和各類技能目錄更快；
• 期待標準解決一切兼容問題的人——各家在標準之上有自己的擴展字段和目錄位置。

注意事項

• 許可證：倉庫代碼 Apache-2.0，文檔 CC-BY-4.0。
• 各家有擴展：例如 Claude Code 文檔說明它在標準之上加了調用控制、子智能體執行等字段；而在 claude.ai 上載或走 Skills API 時只接受標準裏的那幾個字段，多寫會報錯。跨工具分發的技能盡量只用標準字段。
• 標準不管安全：規範只定義格式，不審核內容。技能可以帶腳本，allowed-tools 還能預先授權工具，第三方技能安裝前仍要自己通讀。
• 維護狀態：倉庫最近一次推送在 2026-08-09，更新節奏比技能倉庫慢，屬於正常的規範維護節奏。