Claude 官方教你製作 Skills
整理版優先睇
掌握 Claude Skills：一次設定，長久重用，節省大量 token
呢篇文章係基於 Anthropic 官方喺 2026 年 1 月 29 日發佈嘅 33 頁 PDF《The Complete Guide to Building Skills for Claude》整理出嚟嘅精華版。作者嘅目的係幫讀者喺 15 分鐘內掌握 Skills 嘅核心概念、結構設計、觸發機制同測試方法。整體結論係：Skill 係一個文件夾，入面寫好 Claude 點樣處理某類任務嘅指示，一次配置就可以反覆受益，仲可以透過漸進式信息披露節省 70-90% token。
官方將 Skills 定義為「教識 Claude 一次，每次都用得着」。佢最適合用喺跟團隊規範生成前端界面、用一致方法論做研究、跟品牌指南創建文檔、或者編排多步驟自動化流程呢類場景。對於已經用緊 MCP 嘅開發者，Skills 就係上面嘅知識層，話畀 Claude 點樣用好啲工具。
文章仲詳細拆解咗三層架構、文件命名規範、YAML 觸發條件、指令寫法、三維測試方法同常見故障排查，最後講到 Skills 已經成為開放標準，可以跨平台使用。一句講曬：掌握好 YAML description 嘅寫法係令 Skill 正確觸發嘅核心，配合漸進式結構同官方嘅 skill-creator，15-30 分鐘就可以整到第一個可用 Skill。
- Skill 係一個文件夾，入面有 SKILL.md 同可選嘅 scripts、references、assets 目錄，用 kebab-case 命名，唔可以用 claude 或 anthropic 做名。
- 三層漸進式結構（YAML 前置、SKILL.md 正文、關聯文件）可以慳 70-90% token，同時保持專業深度。
- YAML frontmatter 嘅 description 係觸發關鍵，要同時寫明「呢個 Skill 做咩」同「幾時觸發」，用具體關鍵詞（例如「創建 Sprint」「項目規劃」）而唔係「幫你處理」。
- 官方建議三維測試：觸發測試（10-20 個正負用例，目標觸發率 90% 以上）、功能測試（用 given-when-then 格式）、性能對比（睇 token 消耗同對話輪數改善）。
- Skills 可以透過 zip 上傳到 Claude.ai 或放入 Claude Code 目錄，團隊管理員仲可以喺工作區統一部署，而且已經成為 agentskills.io 開放標準，跨平台通用。
Agent Skills 開放標準
Anthropic 發佈嘅開放標準，目標係令 Skills 跨工具、跨平台運行。
Skill 文件夾結構模板
標準 Skill 文件夾包含 SKILL.md（必須）、scripts/（可選）、references/（可選）、assets/（可選），命名要用 kebab-case。
咩係 Skill？點解要整？
每次開新對話 Claude 都由零開始，你要反覆交代同一套背景、風格同流程，好嘥時間。Anthropic 嘅解法就係 Skills：一個文件夾，入面寫好 Claude 應該點樣處理某類任務，一次配置，反覆受益。
Skills 最適合嘅場景包括：跟團隊規範生成前端界面、用一致方法論做研究調查、跟品牌指南創建文檔、或者編排多步驟自動化流程。如果你已經用緊 MCP 服務器，Skills 就係上面嘅知識層——MCP 畀 Claude 連接外部工具嘅能力，Skills 話畀 Claude 點樣用好呢啲工具。
三層漸進式結構：點樣慳 token 又保持深度？
Skills 最精妙嘅設計係漸進式信息披露（progressive disclosure），分成三層，只喺需要嘅時候先載入對應內容。
- 1 Level 1：YAML 前置信息 — 永遠加載，寫入系統提示詞，等 Claude 知道有呢個 Skill 同幾時用，但唔佔用完整上下文。
- 2 Level 2：SKILL.md 正文 — 按需加載，當 Claude 判斷任務相關時先載入完整指令同示例。
- 3 Level 3：關聯文件（references/）— 淨係喺執行特定步驟嗰陣先讀取詳細 API 文檔、大量示例同模板。
文件結構方面，一個標準 Skill 文件夾係咁：your-skill-name/ 入面有 SKILL.md（必須）、scripts/（可選）、references/（可選）、assets/（可選）。留意幾條硬性規則：SKILL.md 一定要大寫，唔可以叫 README.md；文件夾名要用 kebab-case（全小寫、連字符分隔）；名稱唔可以包含「claude」或「anthropic」。
YAML 前置信息：觸發嘅關鍵
YAML frontmatter 係 Skill 最重要嘅部分，決定 Claude 幾時加載呢個 Skill。最簡形式只需要兩個字段：name 同 description。
---
name: notion-project-setup
description: 管理 Notion 項目工作區，包括頁面創建、數據庫配置和模板應用。當用戶提到「新建項目」、「Notion 工作區」或「項目初始化」時使用。
---description 係觸發核心，要同時包含：呢個 Skill 做咩（用具體行為詞，例如「管理」「生成」「編排」）同埋幾時觸發（列舉用戶可能講嘅短語，例如「創建 Sprint」「項目規劃」）。避免寫「Helps with projects」呢啲模糊表達。
無效寫法：description: Helps with projects. 有效寫法：管理 Linear 項目工作流，包括 Sprint 規劃、任務創建和狀態追蹤。當用戶提到「Sprint」、「Linear 任務」、「項目規劃」時使用。
指令寫法同測試方法
YAML 之後嘅正文係核心說明，官方推薦：具體且可執行，直接話畀 Claude 行咩命令、預期見到咩輸出；每步都要有明確成功判斷標準；另外一定要包一個 Troubleshooting 區塊，列出最常見報錯信息、原因同修復步驟。
正文長度建議控制在 5000 詞以內，詳細 API 文檔同大量示例就放入 references/ 目錄。官方仲提出咗三維測試方法，由淺入深：
- 1 觸發測試：準備 10-20 個正負測試用例，目標觸發率 90% 以上。正例例如「幫我規劃呢個 Sprint」應觸發；負例例如「今日天氣點樣」唔應觸發。
- 2 功能測試：驗證 API 調用成功、錯誤處理有效、邊界情況覆蓋。用「Given 條件 → When 動作 → Then 預期結果」三段式定義。
- 3 性能對比：對比啓用同禁用 Skill 嘅 token 消耗同對話輪數。官方案例：啟用後由 15 輪變 2 輪，token 由 12,000 變 6,000，零 API 錯誤。
使用場景、故障排查同分發
官方將 Skills 應用歸納為三大類：文檔與資產生成（例如 frontend-design、docx）、工作流自動化（例如 skill-creator 引導一步步整新 Skill）、同埋MCP 增強（例如 Sentry code-review Skill）。
常見故障有兩類：欠觸發（應加載但無）→ 補充更多關鍵詞到 description；過觸發（無關查詢都加載）→ 喺 description 加負向觸發詞。分發方面，個人用戶可以下載文件夾打包 zip，喺 Claude.ai 設定上傳；團隊管理員可以喺工作區層面統一部署（2025 年 12 月上線功能），支援自動更新。
Anthropic 已經將 Agent Skills 發佈為開放標準 agentskills.io，目標係跨工具、跨平台運行。
一句話總結：Skill 係 Claude 嘅「記憶與流程」，將你嘅專業知識同工作流程寫成一個文件夾，一次定義，永久複用。掌握好 YAML description 嘅寫法係觸發核心，三層結構慳 token，配合官方 skill-creator 十五分鐘內就可以整到第一個可用 Skill。
Claude Skills
完整建立手冊
Anthropic 喺 2026 年 1 月 29 日發布咗一份 33 頁嘅官方 PDF，系統咁整合咗 Skills 嘅結構設計、觸發機制、測試方法同埋分發策略。呢篇文章提煉咗核心內容，幫你喺 15 分鐘內建立全局認知。
咩係 Skill，解決咩問題
每次開新對話，Claude 都由零開始。不停咁交代同一套背景、風格同流程，呢個係效率問題，而 Skills 就係 Anthropic 畀出嘅解法。
A skill is a set of instructions, packaged as a simple folder, that teaches Claude how to handle specific tasks or workflows.
簡單啲講，Skill 係一個文件夾，入面寫好咗 Claude 應該點樣處理某類任務。一次配置，重複受惠。官方用一句話點明價值：teach Claude once and benefit every time。
Skills 最適合以下呢幾類工作場景：
對於已經有 MCP 伺服器嘅開發者，Skills 係佢哋上面嘅知識層：MCP 畀咗 Claude 連接外部工具嘅能力，Skills 就話畀 Claude 知應該點樣用好呢啲工具。
核心架構：漸進式資訊揭露
Skills 最精妙嘅設計係漸進式資訊揭露（progressive disclosure），呢個係佢能夠喺節省 token 嘅同時保持專業深度嘅原因。成個系統分三層：
漸進式載入相比『將所有說明塞入系統提示詞』嘅傳統做法，可以節省 70~90% 嘅 token 消耗，同時保持深度專業能力。
檔案結構同命名規範
一個標準 Skill 文件夾嘅結構如下：
有幾條硬性規則一定要遵守：
文件夾命名一定要用 kebab-case（全小寫、連字符分隔）。Skill 名稱入面唔可以包含claude或anthropic（系統保留詞）。
YAML 前置資訊：觸發嘅關鍵
YAML frontmatter 係 Skill 最重要嘅部分，佢決定 Claude 會唔會載入呢個 Skill。最簡單嘅形式只需要兩個字段：
description字段係觸發機制嘅核心，一定要同時包含兩個要素：
清晰描述功能範圍，使用具體行為詞，避免『幫助你處理』呢類模糊表達
列舉用戶可能講出嘅具體短語，例如『創建 Sprint』、『項目規劃』等關鍵詞
description: Helps with projects.description: 管理 Linear 項目工作流，包括 Sprint 規劃、任務創建和狀態追蹤。當用戶提到"Sprint"、"Linear 任務"、"項目規劃"時使用。指令寫法嘅最佳實踐
YAML 之後嘅正文係 Skill 嘅核心說明，官方推薦跟以下原則：
三維測試方法
官方將測試分為三個維度，由淺入深覆蓋 Skill 嘅完整行為：
驗證 Skill 喺正確時機載入、喺無關查詢嗰陣唔載入。準備 10~20 個正負測試用例，目標觸發率 90% 以上。
✓ "幫我規劃這個 Sprint" → 應觸發
✓ "創建項目任務" → 應觸發
✗ "今天天氣怎麼樣" → 不應觸發驗證 Skill 產出正確結果，包括 API 調用成功、錯誤處理有效、邊界情況覆蓋。用『給定條件 → 執行動作 → 預期結果』三段式定義測試用例。
對比啓用同禁用 Skill 嘅差距。官方真實案例數據：
3 次 API 錯誤
12,000 tokens
0 次 API 錯誤
6,000 tokens
先喺一個高難度任務上重複迭代，直到 Claude 成功，再將成功嘅做法提煉成 Skill。咁比起一開始就跑大量測試用例效率更高，因為你可以更快揾到真正有效嘅指令模式。
三大使用場景同故障排除
官方將 Skills 嘅常見應用場景歸納為三類：
故障排除方面，官方總結咗兩類常見問題：
Skill 應該載入但冇觸發，用戶需要手動啓用
Skill 喺無關查詢嗰時都俾載入，幹擾正常使用
分發同分享
Skills 目前嘅分發路徑有兩條：
下載文件夾 → 打包 zip → 喺 Claude.ai 設置上傳；或者放入 Claude Code 嘅 Skills 目錄
管理員可以喺工作區層面統一部署（2025 年 12 月 18 日上線），支援自動更新同集中管理
Anthropic 已經將 Agent Skills 發布為開放標準（agentskills.io），類似 MCP 嘅定位，目標係等同一個 Skill 可以跨工具、跨平台運行，唔侷限於 Claude 生態。
一句話總結
Skill 係 Claude 嘅『記憶與流程』，將你嘅專業知識同工作流程寫成一個文件夾，一次定義，永久重用。
內容整理自 Anthropic 官方《The Complete Guide to Building Skills for Claude》（2026.01.29）
Claude Skills
完整構建手冊
Anthropic 於 2026 年 1 月 29 日發佈了一份 33 頁官方 PDF，系統整合了 Skills 的結構設計、觸發機制、測試方法與分發策略。本文提煉核心內容，幫你在 15 分鐘內建立全局認知。
什麼是 Skill，解決什麼問題
每次開啓新對話，Claude 都從零開始。反覆交代同一套背景、風格和流程，這是一個效率問題，而 Skills 正是 Anthropic 給出的解法。
A skill is a set of instructions, packaged as a simple folder, that teaches Claude how to handle specific tasks or workflows.
簡單說，Skill 是一個文件夾，裏面寫好了 Claude 應該如何處理某類任務。一次配置，反覆受益。官方用一句話點明價值：teach Claude once and benefit every time。
Skills 最適合以下類型的工作場景：
對於已有 MCP 服務器的開發者，Skills 是其上的知識層：MCP 給了 Claude 連接外部工具的能力，Skills 則告訴 Claude 該如何用好這些工具。
核心架構：漸進式信息披露
Skills 最精妙的設計是漸進式信息披露（progressive disclosure），這是它能在節省 token 的同時保持專業深度的原因。整個系統分三層：
漸進式加載相比"把所有說明塞進系統提示詞"的傳統做法，可節省 70~90% 的 token 消耗，同時保持深度專業能力。
文件結構與命名規範
一個標準 Skill 文件夾的結構如下：
有幾條硬性規則必須遵守：
文件夾命名必須使用 kebab-case（全小寫、連字符分隔）。Skill 名稱中不能包含claude或anthropic（系統保留詞）。
YAML 前置信息：觸發的關鍵
YAML frontmatter 是 Skill 最重要的部分，它決定 Claude 是否加載該 Skill。最簡形式只需兩個字段：
description字段是觸發機制的核心，必須同時包含兩個要素：
清晰描述功能範圍，使用具體行為詞，避免"幫助你處理"這類模糊表達
列舉用戶可能說出的具體短語，如"創建 Sprint"、"項目規劃"等關鍵詞
description: Helps with projects.description: 管理 Linear 項目工作流，包括 Sprint 規劃、任務創建和狀態追蹤。當用戶提到"Sprint"、"Linear 任務"、"項目規劃"時使用。指令寫法的最佳實踐
YAML 之後的正文是 Skill 的核心說明，官方推薦遵循以下原則：
三維測試方法論
官方將測試分為三個維度，由淺入深覆蓋 Skill 的完整行為：
驗證 Skill 在正確時機加載、在無關查詢時不加載。準備 10~20 個正負測試用例，目標觸發率 90% 以上。
✓ "幫我規劃這個 Sprint" → 應觸發
✓ "創建項目任務" → 應觸發
✗ "今天天氣怎麼樣" → 不應觸發驗證 Skill 產出正確結果，包括 API 調用成功、錯誤處理有效、邊界情況覆蓋。用"給定條件 → 執行動作 → 預期結果"三段式定義測試用例。
對比啓用和禁用 Skill 時的差距。官方真實案例數據：
3 次 API 錯誤
12,000 tokens
0 次 API 錯誤
6,000 tokens
先在一個高難度任務上反覆迭代，直到 Claude 成功，再把成功的做法提煉成 Skill。這比一開始就跑大量測試用例效率更高，因為你能更快找到真正有效的指令模式。
三大使用場景與故障排查
官方將 Skills 的常見應用場景歸納為三類：
故障排查方面，官方總結了兩類常見問題：
Skill 應加載卻沒有觸發，用戶需要手動啓用
Skill 在無關查詢時也被加載，干擾正常使用
分發與分享
Skills 當前的分發路徑有兩條：
下載文件夾 → 打包 zip → Claude.ai 設置中上傳；或放入 Claude Code 的 Skills 目錄
管理員可在工作區層面統一部署（2025 年 12 月 18 日上線），支持自動更新與集中管理
Anthropic 已將 Agent Skills 發佈為開放標準（agentskills.io），類似 MCP 的定位，目標是讓同一個 Skill 能跨工具、跨平台運行，不侷限於 Claude 生態。
一句話總結
Skill 是 Claude 的"記憶與流程"，把你的專業知識和工作流寫成一個文件夾，一次定義，永久複用。
內容整理自 Anthropic 官方《The Complete Guide to Building Skills for Claude》（2026.01.29）