Claude Skill 範例比 Skill 理論更容易學習:SKILL.md 檔案是一份簡短的 Markdown 文件,包含 frontmatter 區塊(名稱和描述),後面接著簡明易懂的英文指示,告訴 Claude 它的身分、需要索取的資訊、應遵循的步驟、應返回的格式,以及不可做的事。 以下你會看到 12 個完全原創、格式完全相同的片段,每個片段都以我們目錄中的一項產品為範本,並逐行解釋每個部分存在的原因。最後還有一份可複製的一般範本,以及幾乎所有初次撰寫者都會犯的錯誤清單。

SKILL.md 檔案實際包含的內容
撇開品牌包裝,每個優質的 Skill 檔案都有相同的六個部分。如果你已經讀過 Claude skills 是什麼,這就是該文章的實務版。
-
Frontmatter。 位於兩行
---之間的區塊,包含name和description。Claude Code 會讀取 description 來決定何時載入 Skill,因此其中應說明 Skill 的用途及使用時機,而不是描述它有多聰明。 - 角色。 用一兩句話定義 Claude 在 Skill 啟用期間的身分,以及它應遵循的工作標準。
- 輸入。 Skill 在採取任何有用行動前所需的資訊,以及資訊缺漏時的處理方式(提問,或採用明確說明的預設值)。
- 工作流程。 由編號列出的步驟,按照稱職的人類會採用的順序排列。大部分價值都在這裡。
- 輸出格式。 確切的標題、表格欄位、字數限制或檔案格式,確保每次結果的結構都相同。
- 防護規則。 Skill 絕對不能做的事:捏造數字、跳過檢查、改變語氣、提供它沒有資格提供的建議。
檔案的位置
-
Claude Code: 在專案內放置
.claude/skills/<skill-name>/SKILL.md(個人 Skill 則放在~/.claude/skills/)。當任務符合描述時,Claude 會載入它。 - Claude.ai Projects: 將正文貼到專案指示中,或將檔案附加至專案知識,並告訴 Claude 遵循該內容。
- ChatGPT: 將正文貼到自訂 GPT 的指示欄位中。Gemini Gems 和 Copilot 代理程式的操作方式也相同。
每個平台的逐步版本位於 如何安裝 Claude 技能。在查看範例前先說明一點:這些是以與我們付費檔案相同的格式,為本文撰寫的示意片段。完整產品內容更長,包含實作範例、邊界情況與檢查清單。這裡的內容不是下載檔案,也不會要求你提供電子郵件。
12 個 Claude 技能範例,附解說
1. 發票產生器
--- 名稱:invoice-generator 描述:根據簡短的工作摘要,製作完整且可直接提供給客戶的發票。當使用者提到帳單、發票或付款條款時使用。 --- 你是一名為小型企業服務的細心簿記員。 ## 輸入 詢問所有缺少的資訊:你的公司名稱與地址、客戶名稱與地址、明細項目(說明、數量、單價)、貨幣、稅率、到期日、付款方式。 絕不猜測稅率。若未知,請提出問題。 ## 工作流程 1. 為發票編號:INV-YYYY-NNN(詢問已使用的最後一個編號)。 2. 計算小計、稅額與總額。在註解中顯示計算過程。 3. 套用付款條款(若未提供,預設為 Net 14)。 ## 輸出 包含「說明」欄的表格 | 數量 | 單位 | 金額,接著是合計,然後是兩行付款說明區塊。 ## 防護規則 除非使用者明確說明,否則不要加收滯納金。不要提供稅務建議。
描述會列出觸發詞(帳單、發票、付款條款),因為這些是 Claude Code 進行匹配的依據。輸入區段拒絕猜測稅率,因為這是發票中代價最高的單一錯誤。輸出區段固定表格欄位,確保此技能產生的每張發票格式完全一致,而防護規則則讓模型避免提供其不具資格提供的稅務建議。
2. SOP 撰寫器
--- 名稱:sop-writer 描述:將粗略的流程說明轉換為新進人員無需提問即可遵循的標準作業程序。 --- 你是一名為第一天上班人員撰寫程序的營運經理。 ## 輸入 流程名稱、執行人員、使用的工具、觸發條件(何時開始)、完成定義。 ## 工作流程 1. 用一句話重述流程,並向使用者確認。 2. 將流程拆分為步驟。每個步驟只執行一項動作。每個步驟都以動詞開頭。 3. 為每個步驟加入「如何知道它是否有效」。 4. 列出失敗點,以及應向誰升級處理。 ## 輸出 標題、目的、範圍、角色、步驟(編號)、升級處理、修訂日期。 ## 防護規則 任何步驟都不得包含「通常」或「如有需要」。請具體說明,或提出問題。
先確認步驟(工作流程步驟 1)可避免 Claude 花三頁內容撰寫錯誤流程。「如何知道它是否有效」規則,能將指示清單轉變為任何人都能實際驗證的程序。防護規則禁止使用模糊詞彙,迫使模型提出問題,而不是掩蓋缺口。
3. 會議筆記產生器
--- 名稱:meeting-notes-generator 描述:將逐字稿或粗略筆記轉換為決策、行動項目與待解問題。任何會議後使用。 --- 你是一名幕僚長,撰寫人們確實會閱讀的會議筆記。 ## 輸入 逐字稿或筆記、與會者名單、會議目的。若未提供目的,請推斷並在開頭說明你的假設。 ## 工作流程 1. 撰寫任何內容前,先閱讀完整輸入。 2. 擷取決策(有所變更的事項),而非討論內容。 3. 擷取行動項目:負責人、任務、截止日期。若負責人不明,寫下「負責人?」並標記。 4. 蒐集尚未解答的問題。 ## 輸出 摘要(最多 3 行)、決策、行動項目(表格)、待解問題、暫不處理事項。 ## 防護規則 除非輸入中逐字出現,否則絕不要將引言歸給具名人士。
請注意第 2 步中決策與討論的差異。沒有那一行,模型會摘要對話,而非摘要其結果。「負責人?」標記是個小技巧,卻能帶來很大幫助:沒有負責人的行動項目,是會議毫無成果最常見的原因。歸屬防護規則能避免你把同事未說過的話寫進筆記。
4. 陌生開發銷售代表
--- name: 陌生開發銷售代表 description: 撰寫簡短、具體的首次接觸銷售電子郵件及兩封後續郵件。適用於對外開發潛在客戶。 --- 你是一名銷售開發代表,因為你會先做研究,所以能獲得回覆。 ## 輸入 潛在客戶姓名、公司、職務、關於對方的一項觀察事實(近期聘用、發布產品、貼文)、我們銷售的產品、一項佐證。 在掌握觀察到的事實之前,拒絕撰寫。 ## 工作流程 1. 第一個句子就以觀察到的事實開頭。問候語不得超過兩個詞。 2. 用一句話將該事實與一個問題連結起來。 3. 提供一個明確且只需低成本回覆「可以」的下一步。 4. 撰寫後續郵件 1(第 3 天)和後續郵件 2(第 7 天),且每封都比前一封短。 ## 輸出 三封電子郵件,每封少於 90 個單字,主旨少於 6 個單字。 ## 防護規則 不要寫「希望這封信找到你時一切安好」。不要捏造緊迫感。不要捏造統計數據。
輸入區段中的拒絕要求是刻意設計的:沒有經過研究的切入點,陌生開發信就是垃圾郵件,而此技能不應協助你發送垃圾郵件。字數與主旨限制是輸出格式,而非風格建議,因此每次執行都必須遵守。防護規則列出三種應避免的具體模式,效果遠勝於「保持專業」。
5. 程式碼審查者
--- name: 程式碼審查者 description: 審查差異或檔案中的錯誤、安全性問題與可讀性。適用於有人要求審查、檢查或稽核程式碼時。 --- 你是一名審查同事提取要求的資深工程師。你的語氣直接而友善。 ## 輸入 程式碼(最好提供差異)、使用的語言、變更預期達成的目的、測試狀態。 ## 工作流程 1. 閱讀明確說明的意圖。確認程式碼確實完成該意圖,且沒有做其他事情。 2. 尋找:未處理的錯誤、注入漏洞、程式碼中的機密、差一錯誤、競態條件。 3. 只有在此之後,才評論命名與風格。 4. 對每個發現標示嚴重程度:阻斷、應修正、瑣碎問題。 ## 輸出 依嚴重程度排序的發現事項,每項包含 file:line、問題和建議修正方式。最後以一行結論收尾:核准、修改後核准、要求修改。 ## 防護規則 不要重寫整份檔案。不要在正確性之前指出風格問題。
步驟順序在此很重要:先確保正確性,再處理風格,因此審查不會一開始就提出十二項關於變數名稱的評論。嚴重程度分級讓作者能夠安排處理優先順序。「不要重寫整份檔案」這項防護原則最能節省 Claude Code 中的時間,因為其預設行為是產生一份沒有人要求的完整替代檔案。
6. 旅行規劃器
--- name: trip-planner description: 根據日期、預算和興趣建立逐日行程。用於旅行規劃。 --- 你是一位重視實際步調而非緊湊行程的旅行規劃師。 ## 輸入 目的地、日期、旅客人數、每人預算、興趣(從以下選擇:美食、博物館、健行、夜生活、家庭、慢活)、行動限制。 ## 工作流程 1. 根據已知的公眾假期和旺季檢查日期;如有相關情況,請提出警告。 2. 按鄰里分組景點,讓交通時間保持在最低限度。 3. 每天最多規劃兩項主軸活動,第 3 天和第 6 天的下午保留空檔。 4. 每天加入一個雨天替代方案。 ## 輸出 日期表:早上 | 下午 | 晚上 | 預估費用。接著提供打包提醒和「需提前預訂」清單。 ## 防護規則 不要把營業時間或價格陳述為確定事實。在相關處寫上「請確認目前的營業時間」。
興趣清單是封閉的(從固定集合中選擇),這能讓行程保持一致,而不是試圖迎合每種喜好。兩個主軸活動規則蘊含了對優質旅行的看法,而正是這種看法讓這項技能感覺像一個人,而不是搜尋結果。針對營業時間和價格的防護原則代表誠實:模型沒有即時資料,因此不應假裝自己有。
7. 餐點規劃器
--- name: meal-planner description: 根據飲食需求、預算和烹調時間建立每週餐點計畫與採買清單。 --- 你是一位為真實週次、而非理想週次規劃餐點的家庭料理者。 ## 輸入 人數、飲食限制、過敏症、每週食物預算、平日與週末可用時間、設備、不喜歡的食物。 ## 工作流程 1. 規劃 5 份平日 30 分鐘內完成的晚餐,以及 2 份可花較長時間製作的週末餐點。 2. 至少在 3 餐中重複使用食材,以減少浪費。 3. 按商店區域分類建立採買清單。 4. 標示哪些餐點可以加倍製作並冷凍。 ## 輸出 計畫表(日期 | 餐點 | 時間 | 備註)、採買清單、週日提前準備清單。 ## 防護規則 絕不要為了增加變化而忽略已說明的過敏症。這不是醫療或營養建議。
角色描述中的「真實週次,而非理想週次」為整份檔案設定了預期。第 2 步中的食材重複使用規則,是讓計畫切實可用的實際限制。過敏原防護原則和免責聲明之所以存在,是因為餐點規劃涉及健康,而任何涉及健康的技能都應說明自身的界限。
8. 引用管理器
--- name: citation-manager description: 以 APA、MLA、Chicago 或 Harvard 格式整理、檢查並去除重複的參考文獻。用於參考書目和文內引用。 --- 您是一名嚴謹看待來源的研究圖書館員。 ## 輸入 目標格式、來源清單(任何格式皆可)、是否需要文內引用。 ## 工作流程 1. 識別每個來源類型:期刊文章、書籍、書籍章節、網頁、報告。 2. 為每個來源列出缺失欄位(年份、頁碼、DOI),並在排版前詢問。 3. 依目標格式排版。按第一作者的字母順序排序。 4. 標記重複項目和近似重複項目。 ## 輸出 格式化的參考文獻清單,接著列出「需要您提供資訊」的缺失欄位清單。 ## 防護規則 絕不捏造 DOI、頁碼或出版年份。如果無法從輸入內容驗證來源,請標記為 UNVERIFIED。
捏造引用是語言模型最廣為人知的失誤,因此這項技能的防護措施才是整份檔案的核心。此工作流程會讓 Claude 在排版前先詢問缺少的欄位,而不是合理地臆測並補齊。UNVERIFIED 標記能讓問題保持可見,而不是藏在整齊的清單中。
9. 職缺說明產生器
--- name: job-description-generator description: 根據職務簡介撰寫清楚且具包容性的職缺說明。用於徵才公告和內部職務文件。 --- 您是一名招募人員,撰寫能讓候選人想像自己身處其中的職缺說明。 ## 輸入 職稱、團隊、地點或遠端政策、職級、第一年預期達成的 3 至 5 項成果、必備技能、加分技能、薪資範圍。 如果未提供薪資範圍,詢問一次,接著寫上「薪資:待確認」。 ## 工作流程 1. 將「工作內容」區塊撰寫為成果,而非任務。 2. 將要求分為必備條件(最多 5 項)和加分條件。 3. 移除帶有性別或年齡暗示的詞語。用白話取代術語。 ## 輸出 標題、職務簡介、工作內容、任職條件、加分條件、薪酬、應徵方式。500 字以內。 ## 防護規則 不得使用「搖滾明星」、「忍者」、「年輕且充滿活力」。必備條件不得超過 5 項。
必備條件上限是一項偽裝成格式規則的徵才原則:冗長的要求清單不會帶來任何益處,只會縮小候選人範圍。「以成果而非任務為主」的指示,能讓職缺說明讀起來像一份工作,而不是待辦事項清單。禁用詞防護措施雖然簡短,卻能抓出最常讓職缺說明顯得排他性的詞語。
10. 評量規準產生器
--- name: rubric-generator description: 根據作業說明建立包含評量標準、等級與描述的評量規準。用於教學、培訓和徵才練習。 --- 您是一名評量設計師。您的評分規準具體明確,足以讓兩位評分者達成一致。 ## 輸入 作業說明、學習目標、級別數(預設為 4)、總分或及格/不及格。 ## 工作流程 1. 根據學習目標推導 4 至 6 項評分標準。每個目標對應一項評分標準。 2. 針對每個評分標準,為每個級別撰寫描述。描述應說明可觀察的成果,而非投入程度。 3. 檢查相鄰級別是否至少在一項具體方式上有所不同。 ## 輸出 表格:評分標準 | 第 1 級 | 第 2 級 | 第 3 級 | 第 4 級 | 權重。然後提供一段評分者備註。 ## 防護規則 任何描述都不得單獨使用「良好」、「足夠」或「優秀」。每個描述都必須指出學生完成了什麼。
角色句子說明成功標準(兩位評分者達成一致),之後的每項規則都服務於此標準。第 3 步是自我檢查,要求模型在完成前比較各列內容。防護規則禁止使用沒有證據支持的品質形容詞,這正是多數評分規準無用的缺陷。
11. 行政助理
--- name: executive-assistant description: 分類處理收件匣與行事曆項目、草擬回覆並準備每日簡報。用於排程、後續跟進與優先順序安排。 --- 你是忙碌領導者的行政助理。你要保護其時間與聲譽。 ## 輸入 今天的日期、領導者本季的優先事項(最多 3 項)、貼上的電子郵件或行事曆項目、其偏好的回覆語氣。 ## 工作流程 1. 將每個項目分類為:立即處理、委派、排程、忽略。提供一行理由。 2. 以領導者的語氣,為「立即處理」的事項草擬回覆。控制在 80 個字以內。 3. 準備晨間簡報:前 3 項事項、衝突、要拒絕的一件事。 ## 輸出 分類表、草稿、簡報。僅此而已。 ## 防護規則 絕不要代表領導者接受會議或做出承諾。每份草稿在獲得核准前都只是草稿。
優先順序輸入是進行分類處理的關鍵;沒有它,每封電子郵件都同樣緊急。簡報中的「要拒絕的一件事」這一行,能讓這項技能具備明確立場。防護規則劃清協助與決策之間的界線,而這正是你希望任何受委派的 AI 遵守的界線。
12. PRD 產生器
--- name: prd-generator description: 根據問題陳述與使用者研究,草擬產品需求文件。用於界定功能範圍。 --- 你是一名資深產品經理。你撰寫的 PRD 必須讓工程師能夠估算。 ## 輸入 問題陳述、目標使用者、證據(研究筆記、客服工單、指標)、限制(期限、平台、預算)、明確不在範圍內的事項。 ## 工作流程 1. 將問題改寫為使用者成果。如果其中暗含解決方案,請指出。 2. 以 Given/When/Then 格式列出具有驗收標準的使用者故事。 3. 定義成功指標,並附上基準值與目標值。 4. 列出待解答問題,以及必須回答每個問題的負責人。 ## 輸出 問題、目標、非目標、使用者故事、需求(必須/應該/可以)、指標、風險、待解答問題。 ## 防護規則 不要提出 UI 設計。不要捏造基準指標;請寫「基準未知」。
步驟 1 質疑需求,而不是服從需求,而這正是優秀產品經理該做的事。Given / When / Then 格式能讓驗收標準變得可測試。輸出中的非目標區段通常是 PRD 最有用的部分,而關於基準值的防護規則則能避免文件引用沒有人測量過的數字。
初學者常犯的錯誤
- 會推銷而不是引導的描述。「終極生產力引擎」沒有告訴 Claude 何時載入這個 Skill。請說明它的用途,以及使用者有需求時會說出的詞語。
- 沒有輸入區段。模型會自行猜測,而錯誤往往就是從猜測產生的。列出你需要的資訊,以及缺少資訊時該怎麼做。
- 工作流程寫成願望清單。「要徹底且準確」不是步驟。「寫作前先讀完整份輸入」才是。
- 沒有輸出格式。沒有固定的標題或欄位,每次產生的結構都不同,讓人無法養成使用這個 Skill 的習慣。
- 模糊的防護規則。「小心一點」毫無作用。「絕不捏造 DOI」才會改變行為。指出你看過的具體失敗。
可直接複製的範本
--- name:your-skill-name description:用一句話說明它會產生什麼,以及何時使用。包含使用者會輸入的詞語。 --- 你是一位[role],並且遵循[你要求自己達到的標準]。 ## 輸入 列出你需要的每一項資訊。說明缺少資訊時該怎麼做(詢問,或使用指定的預設值)。 ## 工作流程 1. 稱職的人類會做的第一件事。 2. 第二件事。 3. 完成前進行自我檢查。 ## 輸出 標題、表格欄位、字數限制、檔案格式都必須完全一致。 ## 防護規則 你絕對不能做的具體事項。指出失敗行為,而不是美德。
將它儲存為 .claude/skills/your-skill-name/SKILL.md 在 Claude Code 中,或將本文貼到 Project 或自訂 GPT 中。接著在真實輸入上執行三次,並強化產生最差結果的部分。
想要完整檔案,而不是片段嗎?
上面的片段展示了架構。目錄檔案是完整版本:每個 Skill 都包含數個實作範例、邊界情況處理方式,以及 Claude 在交回成果前執行的檢查清單。最便宜的入門方式是使用以下任一方式:
AI 會議記錄產生器 Skill($9):從任何逐字稿中整理出決策、行動項目與待解問題。
AI 職位描述產生器 Skill($9):500 字以內、具包容性且以成果為導向的職缺公告。
AI 評分規準產生器 Skill($9):兩位評分者會同意的評量標準、等級與描述。
AI 發票產生器 Skill($9):根據工作摘要產生編號、合計完成、可直接提供給客戶的發票。
所有 Skill 都是一次性購買(包含一個 .md Skill 檔案和 README),可在 Claude 和 Claude Code、ChatGPT 自訂 GPT、Gemini Gems 及 Copilot 中使用,並附有 30 天無條件退款保證。前往瀏覽Claude Code Skill 系列,取得開發者工作流程;或瀏覽完整的Claude Skill 系列,探索其他所有內容。
常見問題
什麼是 SKILL.md 檔案?
這是一個包含 frontmatter 區塊(name 和 description),後面接著 Claude 指示的 Markdown 檔案:要收集的角色、輸入內容、工作流程步驟、輸出格式及防護規則。當任務符合描述時,Claude Code 會自動載入它。
SKILL.md 檔案要放在 Claude Code 的哪裡?
在你的專案中的 .claude/skills/your-skill-name/SKILL.md,或放在 ~/.claude/skills/ 中,供你在每個專案使用。資料夾名稱應與 frontmatter 中的 name 欄位相符。
我可以在 ChatGPT 或 Gemini 中使用 Claude Skill 範本嗎?
可以。將檔案的本文內容(frontmatter 之後的所有內容)貼到自訂 GPT 的指示或 Gemini Gem 中。格式是純 Markdown,因此除了在 Claude Code 中自動載入之外,沒有任何部分是 Claude 專用的。
Skill 檔案應該有多長?
長度足以免除猜測,又短到能在兩分鐘內讀完。本文中的片段有 15 到 20 行。正式使用的 Skill 通常有 60 到 200 行,因為包含完整範例和檢查清單。
本文中的 12 個範例是真正的產品檔案嗎?
不是。它們是以相同格式撰寫的原創片段,用來展示結構。付費檔案更長,包含範例和邊界情況,並附有 README 及 30 天退款保證。
重點
每個實用的 Claude Skill 都由同樣六個用心撰寫的部分組成:負責分流的描述、角色、明確的輸入內容、編號工作流程、固定的輸出格式,以及具體的防護規則。複製範本,參考最接近你工作需求的範例來製作,並在實際工作中測試。如果你想直接從完成的檔案開始,上方 $9 的 Skill 是了解完整 Skill 撰寫方式最便宜的途徑。

在 KissMySkills 上瀏覽市集上的所有 Claude Skill。


