加 LINE

Claude Skill 是什麼?怎麼做?3 步做法、資料夾結構與放置位置一次看懂

施文凱拿著打勾清單板比讚,旁邊寫著什麼是 Skill?怎麼做,給 AI 的 SOP 三步做出來

Claude Skill 是給 AI 看的 SOP:一個資料夾,裡面寫好做事的步驟,Claude 需要時才讀進來用。我是 AI 家教施文凱,幫客戶做過一個影片模板的 Skill,這篇把我在影片裡講的 3 步做法,加上官方文件查到的資料夾結構、放置位置和載入方式整理在一起。可以直接照做的內容放在第一段,官方內容的最後核對日期是 2026 年 10 月 30 日。

這篇屬於 Claude 系列,想照順序學,從Claude 教學入口開始。

Claude Skill 是什麼?怎麼做?結構、3 步做法和放在哪

Claude Skill 是給 AI 的 SOP:讓 AI 照著一套方法一步一步做,得到你預期的結果。依Anthropic 官方文件,Skill 是可重複使用、以檔案為基礎的資源,把某個領域的做法與背景交給 Claude。跟一次性的提示詞不同,官方原文是「Skills load on demand, so you don’t have to repeat the same guidance across conversations」,意思是 Skill 需要時才載入,你不用每次對話重講一遍。

Skill 就是給 AI 操作的 SOP,所以讓 AI 照著這個方法一步一步做,得到我們預期想要的結果。

施文凱,IG 短影片

Skill 長什麼樣子?

一個 Skill 就是一個資料夾,裡面至少要有一個 SKILL.md。其他參考檔、範例和腳本都是選用,需要才放。

my-skill/
├── SKILL.md      ← 必要:說明與步驟
├── reference.md  ← 選用:參考資料,需要時才讀
├── examples.md   ← 選用:範例
└── scripts/
    └── helper.py ← 選用:腳本,執行它,不用把程式碼讀進對話

SKILL.md 最上面是一段設定(frontmatter),下面寫給 AI 看的步驟:

---
name: your-skill-name
description: 這個 Skill 做什麼、什麼時候該用
---

# 步驟
(一步一步寫給 AI 看的說明)
  • name:只用小寫英文、數字、連字號,長度限制見常見問答。
  • description:要同時寫這個 Skill 做什麼和什麼時候該用,因為 Claude 靠這句話判斷要不要用它。
Agent Skills 官方文件的 Skill 結構說明,SKILL.md 開頭要有 name 和 description 兩個欄位
SKILL.md 最上面要有 name 和 description。圖片來源:Claude Platform Docs。

一個 Skill 底下可以放很多參考檔和腳本。官方文件沒有「子 Skill」這個詞,影片裡說的很多子 Skill,實際做法就是把不同能力寫成同一個 Skill 底下的參考檔或腳本,Claude 只在需要時才讀,沒用到的檔案不會被讀進對話。

Skill 怎麼做?3 個步驟

  1. 先了解自己的流程:不了解也可以,請 AI 幫你分析,模擬出這個流程。
  2. 照流程試跑,跑出一個你滿意的結果,讓 AI 知道你要的就是這件事。
  3. 請 AI 把它做成 Skill,然後不斷測試、疊代。

這 3 步是我在影片裡講的做法。第 3 步的測試,Claude 說明中心的建議是先檢查 description 有沒有寫清楚什麼時候該用,再用幾個範例提示詞測試 Claude 有沒有叫出這個 Skill;沒有在該用的時候被用到,就回頭改 description。

我幫客戶做影片模板 Skill 的過程

我幫一個客戶做過影片模板的 Skill,他有 10 個模板,我就是照上面 3 步做。

我先讓 AI 用 Watch 這個 Skill 去看客戶的影片,分析他做了什麼動作、跑出什麼字卡、動效和特效,還有轉場、音樂等等。AI 盡量模仿之後,把 10 個模板都做出來,我再逐一檢查對不對,疊代到客戶滿意的程度。

去哪裡找這些影片來下載的技能,我也一起放進同一個 Skill。要完成一件事常常需要很多種能力,所以一個 Skill 裡面會放進很多能力。Skill 要叫外部工具時,用 MCP 還是 CLI 接,比較表在MCP 跟 CLI 怎麼選。

Skill 要放在哪?

放哪裡看你用哪一邊的 Claude:Claude Code 的 Skill 放在你電腦的資料夾,不用上傳;網頁版 Claude 要把資料夾壓成 zip 上傳。Claude Code 的放置位置查自Claude Code 官方文件,有 2 種最常用:

範圍位置
個人(所有專案都能用)~/.claude/skills/<skill 名稱>/SKILL.md
專案(跟著專案共用).claude/skills/<skill 名稱>/SKILL.md
  1. 建一個資料夾,例如 ~/.claude/skills/summarize-changes/。
  2. 在裡面放 SKILL.md,開頭寫 name 與 description,下面寫步驟。
  3. 使用時輸入 /summarize-changes(斜線加 Skill 名稱)直接叫它,或照平常講需求,Claude 覺得符合 description 時會自己載入。
  4. 有參考檔或腳本,就放在同一個資料夾,並在 SKILL.md 裡寫明什麼時候該讀哪一份。

官方建議 SKILL.md 控制在 500 行以內,其他內容拆成參考檔。還沒用過 Claude 的話,可以先看Claude 是什麼。

Claude Code 官方文件的 Choose where skills load 段落,表格列出 Skill 依位置分成個人、專案等路徑
Claude Code 官方文件說明 Skill 放在哪裡的段落,個人 Skill 放在 ~/.claude/skills 底下。截圖日期 2026 年 10 月 30 日。

網頁版 Claude 的做法是把 Skill 資料夾壓成 zip 再上傳,Claude 說明中心寫明 zip 要以 Skill 資料夾當根目錄,檔案不能直接放在 zip 最外層。Claude Code、網頁版、API 各自獨立,在一邊做的 Skill 不會自動出現在另一邊。

Claude 說明中心的 Skill 壓縮檔結構,zip 裡要以 Skill 資料夾當根目錄
zip 裡要放 Skill 資料夾,不是把檔案直接丟在最外層。圖片來源:Claude 說明中心。

裝別人的 Skill 要注意什麼?

只裝自己做的、或來源可信的 Skill。官方提醒 Skill 裡有指令和程式,惡意的 Skill 可能叫 Claude 做出跟說明不符的事,安裝前要檢查裡面所有檔案。

Claude 怎麼讀 Skill?3 層載入,沒用到的檔案不佔空間

Claude 讀 Skill 分 3 層,用到哪一層才載入哪一層。依官方文件,啟動時只載入每個 Skill 的名稱和描述,你的需求符合描述才讀 SKILL.md 本文,參考檔與腳本則是引用到才讀。

層級什麼時候載入
第 1 層:name 與 description啟動時就載入,放進系統提示
第 2 層:SKILL.md 本文你的需求符合 description 時才載入
第 3 層:參考檔與腳本用到才讀;腳本直接執行,程式碼不用讀進對話
Agent Skills 官方文件說明 Skill 第 1 層 metadata 啟動時載入,第 2 層本文觸發時才載入
name 與 description 一直載入,本文和參考檔用到才載入。圖片來源:Claude Platform Docs。

這就是 description 要同時寫做什麼、什麼時候用的原因:Claude 拿你的需求去比對這句話,決定要不要用這個 Skill。官方也說明,沒觸發之前只有名稱和描述佔用 context,所以可以裝很多 Skill。

不想從零做?官方現成的 4 個 Skill 和開源範例

官方預建的 Skill 有 4 個:PowerPoint、Excel、Word 和 PDF,可以在 Claude API、Claude Platform on AWS、Microsoft Foundry 和 claude.ai 使用。

  • PowerPoint(pptx):建立簡報、編輯投影片、分析簡報內容。
  • Excel(xlsx):建立試算表、分析資料、產生含圖表的報告。
  • Word(docx):建立文件、編輯內容、調整文字格式。
  • PDF(pdf):產生格式化的 PDF 文件和報告。

Anthropic 也在 GitHub 的 skills 儲存庫發布開源的 Skill,例如 Claude API skill,它內建在 Claude Code,也能從儲存庫安裝。官方預建的 Skill 適合先拿來用,要做出符合自己流程的,才需要照上面的 3 步自己做。

常見問答

Claude Skill 跟一般提示詞差在哪?

提示詞是一次對話裡的指示,適合一次性的任務;Skill 存成資料夾,需要時才載入,不用每次重貼。官方文件的說法是 Skills load on demand。

Claude Skill 做好之後可以一直更新嗎?

可以。我在影片裡的說法是,隨著你對流程的認知一直往上,Skill 就可以一直更新。改完 SKILL.md 或參考檔,照第 3 步再測一次,確認該被叫出來的時候有被叫出來。

在 Claude Code 做的 Skill,網頁版和 API 也能用嗎?

不會自動出現。官方說明 Claude Code、claude.ai 和 API 的 Skill 各自獨立,在一邊做的要到另一邊分別上傳或放置。

SKILL.md 的 name 怎麼取?

官方規定 name 最多 64 字元,只能用小寫英文、數字和連字號,不能含 XML 標籤,也不能用保留字 anthropic 和 claude。官方範例的 name 是 pdf-processing。

Claude Skill 是什麼、怎麼做?想有人帶你做自己的 Skill,可以找 AI 家教施文凱

整篇的重點只有三步:先搞懂自己的流程,照流程試跑出滿意的結果,再請 AI 做成 Skill,並不斷測試、疊代。想知道你的工作流程適合做成哪些 Skill,或想把團隊的做法寫成 Skill,可以直接問我。

這篇的短影片版在這裡:IG 影片:什麼是 Skill、怎麼做。在影片留言「Skill」,會私訊你這一頁;想直接問我,可以加我的 LINE:官方 LINE。我陪學員一對一做過的例子,整理在AI 教學案例。

延伸閱讀:CLAUDE.md 是什麼,介紹另一份給 Claude 讀的設定檔該放在哪、該寫什麼。

本文依 Anthropic 官方文件與說明中心整理,最後核對日期為 2026 年 10 月 30 日,功能與介面以官方頁面為準。

參考資料來源

施文凱

施文凱

AI 家教/AI 講師施文凱,天羽新創有限公司創辦人,數位簡報室與智谷網路 AI 顧問、台灣 Manus 推廣大使。為老闆與主管做 AI 一對一家教與企業培訓,也開發 AI 系統、LINE 客服機器人與自動化工作流,累積培訓學生超過 100 人。

加 LINE 問問題

發佈留言