若要建立 Claude 技能,你只需建立一個包含一個檔案的資料夾:其中的 SKILL.md 開頭是名稱和描述,後面接著以一般語言撰寫的指示。 將資料夾壓縮成 ZIP 後上傳至 Claude(或將其放入 ~/.claude/skills/ 以供 Claude Code 使用),當請求符合描述時,Claude 就會載入它。不需要程式碼、SDK 或建置步驟。
這個頁面
整個機制就是如此。能讓技能每次都觸發並產出可直接交付的成果,與讓技能從不觸發的差異,取決於大約六項決策;本指南會依序說明這些決策。最後提供一份可免費複製的範本,以及一份在依賴技能前測試技能的檢查清單。
如果你不熟悉這個概念,請先閱讀 什麼是 Claude Skills?,再回到這裡。本頁假設你已了解什麼是技能,並希望建立一個技能。
開始前需要準備的事項
- 已啟用程式碼執行功能的 Claude 帳戶。 Skills 可在 Free、Pro、Max、Team 和 Enterprise 方案上執行,但必須啟用程式碼執行和檔案建立設定。在 Team 和 Enterprise 方案中,管理員可能需要先為組織啟用 Skills。
- 文字編輯器。 任何能儲存純文字的工具都可以:VS Code、TextEdit 的純文字模式、Notepad。
- 一項可重複執行的工作。 不要寫「行銷」這種內容。可以是「將銷售通話逐字稿轉換成符合我們格式的 CRM 筆記」,或「依照我們標準的五項警示事項審查合約」。工作範圍越窄,技能就越好。
- 兩到三個優質輸出的真實範例。 過去的報告、電子郵件和簡報,只要是你樂意直接發送的內容都可以。這些是製作技能最好的原始素材。
步驟 1:選定一項工作,並定義「完成」
大多數失敗的技能都在這裡失敗了,甚至還沒寫下一行內容。一個試圖涵蓋「行銷經理所做的一切」的技能,最後會得到模糊的描述、在錯誤的時機啟動,並在啟動後提供泛泛的回答。
先寫兩句話,再做任何其他事情:
- 觸發條件:「當有人要求 X 或交付 Y 時使用。」
- 交付成果:「輸出內容是一份 Z,包含以下區段,符合這個長度,採用這種語氣。」
範例:「當有人貼上客戶通話逐字稿並要求整理筆記時使用。輸出內容是一則 CRM 筆記,包含摘要、痛點、預算、下一步和風險,少於 200 字,供未參與通話的銷售經理閱讀。」如果你無法寫出這兩句話,請將工作拆分成兩個技能。
步驟 2:建立資料夾和 SKILL.md 檔案
技能是一個名稱與技能名稱相符的資料夾。其中唯一必要的檔案是 SKILL.md (檔案名稱區分大小寫)。可選的額外檔案會放在它旁邊:
| 路徑 | 是否必需? | 用途 |
|---|---|---|
call-notes/SKILL.md |
是 | 前言區塊加上 Claude 遵循的指示 |
call-notes/resources/example-output.md |
建議 | 交付成果的完整範例 |
call-notes/resources/style-guide.md |
選填 | Claude 僅在需要時才讀取的較長參考資料 |
call-notes/scripts/ |
選填 | 對於必須精確執行的步驟,使用 Python 或 shell 指令碼,例如解析 CSV |
資料夾名稱請維持小寫並使用連字號,例如 call-notes 或 quarterly-report。相同的字串會放在 名稱 在下一步的欄位中。
步驟 3:撰寫前言區塊(決定何時觸發的部分)
檔案開頭是一個簡短的 YAML 區塊,位於兩行各由三個連字號組成的行之間。必填欄位有兩個:
-
name- 僅限小寫字母、數字和連字號,最多 64 個字元。它會成為識別碼,在 Claude Code 中則是斜線命令(/call-notes)。 -
description- 最多 1,024 個字元。這是 Claude 在工作階段開始時讀取每個已安裝技能的唯一部分。它會決定是否載入你的技能。
描述要寫得像是在向必須在一秒內判斷某項要求是否由自己負責的同事簡報。先說明技能會產出什麼,接著列出應該觸發它的情境和說法。比較如下:
- 弱:「協助處理銷售筆記。」
- 強:「將銷售或探索通話逐字稿轉換成結構化 CRM 備註(摘要、痛點、預算、下一步、風險),字數少於 200 字。當使用者貼上通話逐字稿、會議錄音文字或粗略通話筆記,並要求筆記、回顧、CRM 紀錄或後續摘要時使用。」
強而有力的版本會明確列出輸入、輸出,以及人們實際會輸入的文字。這能讓它可靠地觸發,並在其他時候保持安靜。
步驟 4:將指示寫成方法,而不是情緒
前言區塊以下的所有內容都是 Claude 在技能載入後遵循的 Markdown。常見錯誤是寫一大段人物設定(「你是一位擁有 20 年經驗的世界級銷售專家……」),卻沒有程序。Claude 不需要背景故事,而需要步驟、規則和目標格式。適用於大多數商務技能的結構如下:
- 輸入 - 使用者會提供的內容,以及缺少時要詢問的資料(最多提問兩個問題,然後依據已說明的假設繼續進行)。
- 工作流程 - 謹慎的專業人士會依序執行的編號步驟。
- 輸出格式 - 確切的區段、標題、長度和語氣。
- 規則 - 必須始終或絕不發生的事項(「絕不臆造預算數字;寫上『未討論』」)。
- 品質檢查 - Claude 在回答前會快速檢查的項目清單。
目標是讓內容適合顯示在一或兩個畫面內。如果檔案超過約 500 行,請將參考資料(長篇風格指南、價目表、政策文字)移至 resources/ 下的檔案,並在 SKILL.md 中告訴 Claude 何時開啟這些檔案。Claude 只會在任務需要時載入這些額外檔案,讓上下文保持精簡。如需進一步了解檔案結構,請參閱 什麼是 SKILL.md 檔案?
步驟 5:加入一個完成輸出的範例
範例比任何長篇描述都能更快教會格式。請在 resources/example-output.md 並從工作流程中引用它(「符合 resources/example-output.md 的結構和長度」)。使用一份真實的過往工作成果,替換其中的名稱和數字,而不是使用充滿括號的佔位內容。我們自己的目錄也遵循相同規則:每個 Skill 都附有一份範例輸出,因為這是某人確實測試過該項目的最明確證據。
步驟 6:封裝並安裝
在 Claude(網頁版和桌面版)中: 將資料夾壓縮成 zip,並確保資料夾本身位於 zip 的根目錄(call-notes.zip 內含 call-notes/SKILL.md)。在設定中開啟 Skills 區段,上傳 zip,然後開啟該 Skill。開始新的聊天,並提出符合描述的請求。
在 Claude Code 中: 不需要 zip。將資料夾放入 ~/.claude/skills/,即可在每個專案中使用;或放入儲存庫內的 .claude/skills/,即可與所有使用該儲存庫的人共用。輸入 /call-notes,或直接描述任務即可。Claude Code 會自動載入資料夾的變更,不需要重新啟動。
每個介面的完整操作說明,包括檔案存放位置及上傳遭拒時的處理方式,請參閱 如何安裝 Claude Skill。主要在終端機工作的開發者也應閱讀 Claude Code Skills。
步驟 7:像真正使用一樣進行測試
只試過一次的 Skill 還不算經過測試。在與團隊分享前,先執行這項檢查:
- 觸發測試(5 個 prompts)。 以不同方式措辭撰寫五個應觸發此 Skill 的請求。計算觸發了幾個。少於四個表示描述需要加入更多使用者實際使用的措辭。
- 靜默測試(5 個 prompts)。 撰寫五個相近但不應觸發它的請求。如果其中任何一個觸發,就縮小描述範圍。
- 缺少輸入測試。 只提供一半的輸入。它應該提出簡短問題或說明自己的假設,而不是捏造事實。
- 格式測試。將三個輸出與您的範例並排比較。區段是否相同、長度範圍是否一致、語氣是否相同?
- 邊界案例測試。輸入您手邊最混亂的真實資料:冗長的逐字稿、內容不完整的試算表。
修正描述以解決觸發問題,修正工作流程或規則以解決輸出問題。在檔案底部保留簡短的變更記錄,方便您了解團隊正在使用哪個版本。
免費 Claude Skill 範本(複製並調整)
名稱相同的資料夾內 SKILL.md 放在與 名稱 欄位。
---
name: 您的 Skill 名稱
description: 根據特定輸入產出特定交付成果(區段、長度)。當使用者要求 X、貼上 Y 或提及 Z 時使用。不要用於屬於其他地方的相近任務。
---
# 您的 Skill 標題
## 目的
用一或兩句話說明適用對象,以及「完成」的定義。
## 輸入
- 必填:使用者必須提供的內容
- 選填:如何改善結果
- 如果缺少必要輸入,最多提出兩個簡短問題,
接著繼續,並在輸出內容頂端列出您的假設。
## 工作流程
1. 閱讀輸入內容並找出關鍵要素。
2. 根據規則或標準檢查內容。
3. 依照以下格式撰寫輸出內容。
4. 執行品質檢查,修正所有不符合之處,然後回答。
## 輸出格式
- 第 1 節:名稱 - 此處填寫內容(長度)
- 第 2 節:名稱 - 此處填寫內容(長度)
- 第 3 節:名稱 - 此處填寫內容(長度)
按照 resources/example-output.md 的結構和長度撰寫。
## 規則
- 絕不要捏造數字、姓名或日期。請改寫為「未提供」。
- 使用簡明英文。不要加入冗長的開場白。
- 適用於您團隊或產業的規則。
## 品質檢查
- 每個區段是否都存在且順序正確?
- 每項說法是否都能追溯至輸入內容?
- 是否在長度限制內?
## 變更記錄
- v1.0 第一版,日期
想看看完成的 Skill 長什麼樣子嗎?Claude Skill 範例會逐行解析十二個實際的 SKILL.md 檔案,這是校準詳細程度的最快方法。
讓 Skill 失去作用的五個錯誤
- 描述應說明 Skill 是什麼,而不是何時使用。「專業文案撰稿人」永遠不會觸發。「當使用者要求產品描述、PDP 文案或商品頁文字時,根據功能清單撰寫產品頁文案」才會觸發。
- 整個部門共用一個 Skill。把預算編列、薪資和稽核放在同一個檔案中,只會得到三個半成品答案。請建立三個 Skill。
- 沒有輸出格式。沒有格式,每次執行的結果都不一樣,沒有人會信任它。
- 檔案中的機密資訊。 絕不要將 API 金鑰、密碼或客戶資料貼入 Skill。任何與你分享的人都能閱讀它。
- 未閱讀就安裝別人的 Skill。 Skill 是 Claude 會遵循的指示,有時還包含指令碼。請像執行指令碼前閱讀它那樣閱讀它。
讓 Claude 為你撰寫第一份草稿
你不必從空白檔案開始。Claude 可以訪談你,了解任務內容,草擬 frontmatter 和工作流程,產生範例輸出,並提出上方的測試 prompts。Anthropic 提供了專門用於此目的的內建 skill-creator Skill,你也可以用一般文字提出要求:「訪談我,了解我如何撰寫每週客戶報告,然後為它寫一份 SKILL.md。」草稿仍需要你編輯,尤其是描述和規則,但它能省去大部分的打字工作。
偏好表單而不是聊天?免費的 Claude Skill Builder 會將任務的簡短描述轉換成附有 frontmatter 和工作流程的現成 SKILL.md,你可以複製或下載為 .zip,供 Claude.ai 和 Claude Code 使用。無須註冊。
想讓我們替你完成訪談、自我測試和打包嗎? Claude Skill Creator(19 美元)是一個能建立 Skills 的 Skill:它會詢問工作內容、人們實際輸入的請求,以及絕對不能發生的情況,寫出包含 SKILL.md 和範例輸出的完整 Skill 資料夾,根據應該觸發和不應該觸發它的請求測試描述,並為 Claude、Claude Code 和 API 封裝資料夾。若要稽核你撰寫或下載的 Skill,請使用 Claude Skill Reviewer & Security Linter;或者購買 Build Your Own Claude Skills Kit(49 美元),一次取得兩者,以及 prompt、MCP 和程式碼審查 Skills。
要自行建立,還是從現成的 Skill 開始?
當工作流程是團隊專屬、包含外部無人知曉的內部知識,或你喜歡反覆調整時,就自行建立。當工作屬於標準職能(記帳、SEO 簡報、合約審查、客服回覆),而你寧願把下午花在工作上、而不是研究指令時,就從現成的 Skill 開始。我們的 Claude Skills 程式庫 中的現成 Skill 售價 19 美元,附有範例輸出,而且是你可以開啟和編輯的純 Markdown 檔案,因此也能作為你自行製作版本的起始範本。
無論如何,下一步都一樣:挑選一項你每週都會重複的任務,寫下步驟 1 中的兩句話,並在今天結束前完成一個可運作的 Skill。