跳到主要內容
Foxyko
Claude

Claude Skills 怎麼用？建立、上傳與使用技能包的完整教學

Claude Skills 是什麼、怎麼運作、怎麼寫 SKILL.md，以及在 claude.ai、API 與 Claude Code 的使用差異。附完整範例、常見錯誤與安全注意事項。

Foxyko4 分鐘

作者：Foxyko　最後更新：2026 年 10 月 30 日。內容已對照 Anthropic 官方開發者文件與支援頁面核對（截至 2026 年 10 月 30 日）。設定畫面與方案限制可能調整，操作前請再確認官方說明。

本文重點

  • Skill 是「資料夾 + SKILL.md」，Claude 依名稱與描述判斷這次任務要不要載入它。
  • 平常每個 Skill 只佔約 100 個 token 的描述，被觸發後才載入本文，所以多裝幾個也不會拖慢每次對話。
  • description 欄位決定觸發準確度，必須同時寫「做什麼」和「什麼時候用」。
  • claude.ai、API、Claude Code 三個平台的 Skill 各自獨立，不會自動同步。
  • Skill 等同可執行的指示與程式，只安裝自己寫的或來自可信來源的。

Claude Skills 是什麼？

Claude Skills 是讓你把重複性的工作流程，打包成 Claude 可以隨時取用的技能。如果你常在對話開頭重複輸入「照這個格式整理」「照公司規則檢查」，就適合改寫成 Skill。

Skill 和單純存一個文字檔不同。文字檔要你自己記得貼、自己判斷這次用不用得到；Skill 則由 Claude 比對任務內容，相符才載入，不相符時它完全不出現在對話裡。Anthropic 也提供預先建好的 Skill，目前涵蓋 PowerPoint、Excel、Word 與 PDF。

Claude Skills 和提示詞、Projects、MCP 有什麼差別？

四者解決的是不同層的問題：提示詞管單次指示，Projects 管固定的資料與背景，Skills 管可重複的做法，MCP 管連接外部系統。它們互補，不是取代關係。

工具解決什麼問題什麼時候用上
一般提示詞單次任務的指示你每次手動輸入
Projects把常用資料與指示固定在一個專案空間在該專案內的對話
Skills可重複套用的流程與做法Claude 判斷任務相符時才載入
MCP連接外部系統與資料需要存取外部工具時

想了解另外兩者，可以看 Claude Projects 教學 與 MCP 完整解析。

Claude Skills 怎麼運作？為什麼不會佔滿對話空間？

Skills 採用分層載入：啟動時只讀名稱與描述，被觸發才讀本文，需要時才讀附帶資源。這樣即使安裝很多 Skill，平常的上下文負擔也很小。

層級何時載入大約成本內容
1 描述啟動時一律載入每個 Skill 約 100 tokenSKILL.md 開頭的 name 與 description
2 本文Skill 被觸發時官方指出低於 5,000 tokenSKILL.md 的完整指示
3 資源需要時才讀取讀取前不佔用參考檔、範本；腳本只有輸出進入上下文

怎麼建立一個 Claude Skill？

建立 Skill 的做法是新增一個資料夾、寫好 SKILL.md、再實際測試。不需要寫程式，會把步驟講清楚就能做。

步驟 1：先選一個重複出現、步驟固定的任務

適合的例子有週報整理、文案審稿標準、程式碼風格規範。只做一次的任務，直接講清楚比寫 Skill 更快。

步驟 2：建立資料夾與 SKILL.md，寫好 name 和 description

SKILL.md 開頭有兩個必填欄位。name 最多 64 個字元，只能用小寫字母、數字與連字號，不可含保留字 anthropic 或 claude。description 最多 1,024 個字元，要同時寫明做什麼和何時使用，因為 Claude 就是靠這段文字判斷要不要觸發。

步驟 3：在本文寫清楚流程、格式與要避免的事

把它想成在教新同事：他不知道你公司的慣例，你得從頭講。步驟有先後順序就編號，有例外狀況就明寫，不要為了簡潔而省略。

步驟 4：需要時附上範本、範例輸出或腳本

把檔案放在同一個資料夾，並在 SKILL.md 裡說明何時該讀哪個檔案。這些資源讀取前不佔用上下文。

步驟 5：拿真實情境測試，再回頭修 description

檢查三件事：該觸發時有沒有觸發、不該觸發時有沒有誤觸發、產出是否符合預期。前兩者多半是 description 的問題，第三者多半是本文指示不夠清楚。

SKILL.md 範例（週報整理）
---
name: weekly-report
description: 把零碎的工作紀錄整理成給主管看的週報。當使用者要求寫週報、整理本週進度時使用。
---
請依序輸出：本週完成、進行中、風險與卡關、下週計畫、需要的支援。每一項不超過三點，只根據使用者提供的紀錄撰寫，不要自行補充沒有出現的內容。資料不足的欄位請標示「待補」。

在 claude.ai、API 和 Claude Code 怎麼使用 Skills？

三個平台的 Skill 做法各自獨立：claude.ai 以壓縮檔上傳，API 透過 container 參數與 /v1/skills 端點，Claude Code 則直接放在資料夾。Skills 不會跨平台同步，同一份內容要在每個平台各設定一次。

平台怎麼放進去注意事項
claude.ai在設定中開啟程式碼執行與檔案建立，再於 Skills 區塊上傳 ZIP；內建的文件類 Skill 不用設定需要 Pro、Max、Team 或 Enterprise 方案；自訂 Skill 預設只屬於你的帳號
Claude API內建 Skill 用 skill_id（pptx、xlsx、docx、pdf）放進 container 參數；自訂 Skill 經 /v1/skills 上傳需啟用程式碼執行工具；沒有網路存取，也不能在執行時安裝套件；整個 workspace 共用
Claude Code放在 ~/.claude/skills/（個人）或 .claude/skills/（專案），不用上傳有完整網路存取；也可透過外掛分發

安裝或使用 Claude Skills 有哪些安全風險？

最大風險是惡意指示與資料外洩，所以安裝別人的 Skill 要像安裝軟體一樣謹慎。官方建議只使用自己建立或來自 Anthropic 的 Skill。

Claude Skills 常見錯誤與疑難排解

多數問題出在 description 太籠統，或上傳格式不符。先檢查這兩處，通常就能解決。

  • Skill 該觸發卻沒觸發：把 description 改成貼近實際說法，例如「當使用者要求把會議記錄整理成待辦清單時使用」，取代「處理文件相關任務」。
  • Skill 到處誤觸發：描述太籠統或和其他 Skill 重疊，把範圍縮窄，並刪掉用不到的 Skill。
  • 上傳失敗：官方列出的常見原因有檔案超過大小限制、資料夾名稱與 Skill 名稱不一致、缺少 Skill.md，以及名稱或描述含不合法字元。
  • 產出不如預期：通常是本文指示不夠清楚，補上格式範例與例外狀況比換模型更有效。

什麼時候不該用 Claude Skills？有哪些替代做法？

需要每次結果完全一致的工作，不適合只靠 Skill，因為 Skill 提供的是指示，不是保證一致的機制，這類工作應交給真正的程式。只做一次的任務直接說明即可。如果問題是「連不上外部系統」，該用 MCP，再用 Skill 說明連上之後怎麼做。

相關文章與資料來源

延伸閱讀：Claude Code 教學、提示詞框架。

常見問題

Claude Skills 要付費才能用嗎？
依官方支援頁面，claude.ai 上的 Skills 提供給 Pro、Max、Team 與 Enterprise 方案，且需要開啟程式碼執行功能，列出的方案不含免費版。Claude Code 與 API 另有各自的使用方式，詳細限制請以官方最新說明為準。
SKILL.md 的 name 和 description 有什麼限制？
name 最多 64 個字元，只能用小寫字母、數字與連字號，且不能包含保留字 anthropic 或 claude。description 不能空白、最多 1,024 個字元，必須同時寫明這個 Skill 做什麼，以及 Claude 該在什麼情況下使用它。
在 claude.ai 上傳的 Skill，API 或 Claude Code 也能直接用嗎？
不能。官方文件指出 Skills 不會跨平台同步：上傳到 claude.ai 的 Skill 要在 API 重新上傳，Claude Code 的 Skill 也是獨立放在自己的資料夾。同一份內容需要在每個平台各自設定一次。
Skill 會佔用多少上下文？
每個 Skill 平時只佔名稱與描述，約 100 個 token；被觸發時才載入 SKILL.md 本文，官方指出少於 5,000 個 token。附帶的參考檔要被讀取才計入，腳本則只有執行結果會進入上下文。
可以安裝別人寫的 Skill 嗎？
技術上可以，但風險等同安裝軟體。官方建議只使用自己建立或來自 Anthropic 等可信來源的 Skill，並在使用前檢查 SKILL.md、腳本與資源檔，留意不明的網路呼叫或與用途不符的檔案存取。
主題標籤ClaudeSkillsClaude Code工具整合

延伸閱讀