學習中心/術語一次搞懂·15 分鐘

Skill 是什麼?跟提示詞、斜線指令、MCP 差在哪

一句話回答

Skill(Agent Skills)是一個資料夾,裡面至少要有一份 SKILL.md,寫著「這件事怎麼做」,還可以附參考檔案與可執行腳本。跟提示詞最大的差別是:提示詞講完就沒了,Skill 放一次就長期存在,而且你不用主動叫它,AI 會看你要做什麼、自己判斷要不要拿出來用。它靠「漸進式揭露」控制成本,沒被用到的 Skill 只佔約 100 個 token。

先講結論:Skill 就是一個資料夾

這個詞聽起來很玄,但它的本體非常樸素。Anthropic 官方在公告裡的原話是:「Skill 是包含指示、腳本與資源的資料夾,Claude 需要時可以載入」

文件裡的定義更完整一點:「Agent Skills 是擴充 Claude 功能的模組化能力。每個 Skill 包裝了指示、後設資料,以及選用的資源(腳本、範本),Claude 在相關時會自動使用」

所以它不是一個外掛市集、不是一種模型能力,就是你放在檔案系統上的一疊文件

它解決什麼問題

如果你常用 AI 做同一類工作,會遇到一件很煩的事:每次開新對話,你都要重新交代一遍。

「我們公司的報價單格式是這樣」「數字要這樣四捨五入」「客戶名稱一律去識別化」。講一次它照做,下次開新視窗它又不知道了。

官方文件把這個差別講得很直接:提示詞是「對話層級、一次性任務的指示」,而 Skill 是按需載入的,所以你不必在每一場對話裡重複同樣的交代

一個 Skill 長什麼樣

只有 SKILL.md 是必要的,其他都是選配。官方用的比喻是「你幫新同事準備的上手手冊」,先有目錄,再有章節,最後才是附錄。

pdf-processing/├─SKILL.md主檔。上面是 name 與 description,下面是做法必要├─FORMS.md補充說明,需要時才讀├─REFERENCE.md查表用的參考資料└─scripts/fill.py可執行腳本。只有輸出進脈絡,程式碼不進SKILL.md 最上面那段就決定它會不會被叫出來---name:pdf-processing 小寫、數字、連字號,最多 64 字description:做什麼+什麼時候用,最多 1024 字
只有 SKILL.md 是必要的,其他都可選。官方的比喻是「你幫新同事準備的上手手冊」。

漸進式揭露:為什麼裝很多也不會吃掉額度

這是 Skill 設計上最聰明的一點,也是它跟「把所有規矩寫進一份超長指示」的根本差別。

它把內容分三層,每一層在不同時間才進到脈絡裡。沒被叫到的 Skill,只有名稱與說明佔位置,官方給的數字是每個 Skill 約 100 個 token

第一層 名稱與說明一開機就載入每個 Skill 約 100 個 token第二層 SKILL.md 內文被觸發時才讀5k token 以內第三層 其他檔案與腳本用到才讀沒用到就是 0腳本有個額外的好處Claude 是用 bash 去跑它,只有執行結果進脈絡,程式碼本身不進。所以包一堆腳本也不佔額度。
這就是為什麼裝了幾十個 Skill 也不會把脈絡吃光。沒被叫到的,只佔名稱與說明那一點點。

description 那一欄是整個 Skill 最重要的地方

很多人把時間花在寫內文,結果 Skill 從來沒被觸發過。原因幾乎都出在 description。

因為 Claude 是拿你的請求去比對 description,決定要不要把這個 Skill 叫出來。官方文件寫得很明白:description「必須同時說明這個 Skill 做什麼、以及什麼時候該用它」。

看官方自己的範例就懂了。它不只寫功能,後半段直接列出觸發情境:

  • 只寫做什麼(容易不被觸發):「從 PDF 抽取文字與表格」
  • 做什麼+什麼時候用(官方寫法):「從 PDF 抽取文字與表格、填表單、合併文件。當你在處理 PDF 檔案、或使用者提到 PDF、表單、文件抽取時使用
  • 格式限制name 只能小寫字母、數字與連字號,最多 64 字,而且不能含 anthropic 或 claude 這兩個保留字。description 最多 1024 字

Skill、提示詞、斜線指令、MCP 的分工

這幾個很容易混。它們不是互相取代,是負責不同的事。

最關鍵的一條分界是誰決定什麼時候用:斜線指令是你打 /xxx 主動叫,Skill 是它看你要做什麼、自己判斷要不要拿出來。

是什麼內容誰決定什麼時候用提示詞這一次對話講的話講完就沒了,下次要重講專案指示/記憶這個專案的長期規矩一直都在,不分任務斜線指令你打 /xxx 才跑的固定流程你決定什麼時候用Skill一包做法+檔案+腳本它看你要做什麼,自己決定要不要拿出來MCP接到外部系統的管道給的是「能連到什麼」,不是「怎麼做」
最關鍵的一條:斜線指令是你主動叫,Skill 是它自己判斷要不要用。兩者不衝突,常常一起用。

Skill 跟 MCP 不是二選一

這是最常被問的一組。用一句話分:MCP 給的是「連得到什麼」,Skill 給的是「怎麼做」。

MCP 讓 AI 接得到你的資料庫、行事曆、公司系統(詳見 MCP 是什麼)。但接得到不等於會用得好。它不知道你們公司的報表口徑,也不知道哪些欄位不能動。那些「怎麼做」的知識就是 Skill 的內容。

Anthropic 的工程部落格也是這樣定位的,原話是 Skill 「可以補足 MCP 伺服器,教會代理更複雜的、涉及外部工具與軟體的工作流程」。所以實務上常常是兩個一起用:MCP 接通管道,Skill 教它規矩。

三個地方都能用,但不會互相同步

Skill 的格式三邊通用,官方的說法是「Build once, use across Claude apps, Claude Code, and API」。但格式通用不等於檔案會同步,這點很多人踩到。

claude.ai怎麼放設定裡上傳 zip誰看得到只有你自己看得到看設定,可能沒網路Claude Code怎麼放放進資料夾就好誰看得到個人或專案,可隨 repo 分享跟你電腦上其他程式一樣Claude API怎麼放透過 Skills API 上傳誰看得到整個工作區共用沙箱,沒有對外網路⚠️ 官方明講:自訂 Skill 不會跨平台同步另外 claude.ai 的自訂 Skill 是「每個人自己上傳」,管理員沒辦法統一發給全公司。要給團隊共用,Claude Code 放進專案 repo、或走 API 的工作區共用,這兩條比較實際。
同一份 Skill 的格式三邊通用,但上傳到一邊不會自動出現在另一邊。要用哪裡就各自放一份。

什麼東西適合做成 Skill

判斷標準很簡單:你是不是已經重複交代過三次以上? 是的話就值得寫下來。

  • 有固定做法的產出:報價單、月報、貼文、簡報的格式與語氣規範
  • 你們公司的口徑:毛利怎麼算、哪個欄位才是真相、哪些數字不能對外
  • 踩過的雷:「這個表的日期欄是民國年」「匯出前要先關掉自動篩選」這種只有你知道的事
  • 需要精準、不能讓它自由發揮的步驟:包成腳本放進 Skill,讓它去執行而不是每次重新寫一份

什麼東西不該做成 Skill

這段官方文件沒有明講,是我自己用下來的判斷,寫出來給你當參考:

  • 只做一次的事:直接在對話裡講就好,寫成 Skill 是多做工
  • 全域性的規矩:「回我中文」「不要用破折號」這種每次都適用的,放專案指示或記憶比較對。Skill 是「特定任務才拿出來」的東西
  • 會一直變的資訊:價目表、庫存這類,塞進 Skill 會過期。那是 MCP 或 API 該做的事
  • 你自己都講不清楚的流程:Skill 只是把你的做法寫下來。如果那件事你本來就沒有穩定做法,先把它做穩再寫

安全:裝 Skill 等於裝軟體

這段一定要看。Skill 裡面可以放可執行腳本,而 Claude 會用 bash 去跑它。

官方的警告寫得很重:「只使用來自可信來源的 Skill,也就是你自己寫的、或從 Anthropic 取得的」。因為「Skill 透過指示與程式碼賦予 Claude 新能力,這也意味著惡意的 Skill 可以指揮 Claude 以不符合其宣稱用途的方式呼叫工具或執行程式碼」。

官方特別點名幾個風險,值得逐條記住:

  • 要逐檔審過:SKILL.md、腳本、圖片、其他資源全部看,找有沒有不符合用途的網路呼叫或檔案操作
  • 會去外部抓資料的 Skill 風險特別高:抓回來的內容可能含惡意指示,而且就算今天可信,它的外部依賴以後可能被換掉
  • 當成裝軟體看待:接進有敏感資料或關鍵操作的正式系統時要格外小心
  • ⚠️ 另外一個容易忽略的點:官方文件明載 Agent Skills 不在零資料留存(ZDR)的涵蓋範圍內,Skill 定義與執行資料依標準政策留存。放公司機密進去前要想清楚

我自己怎麼用

我把重複的工作流程都寫成 Skill,放在專案的 .claude/skills/ 裡跟著 repo 走,換電腦 pull 下來就在。

最有感的是那些「我知道但每次都要重講」的事。例如某個產出一定要先轉成圖片親眼看過才算完成、某個系統的排程不能設太密否則會咬到費用。這些以前只存在我腦袋裡,寫進 Skill 之後,它自己就會照做。

另一個意外的好處是:寫 Skill 的過程會逼你把自己的流程講清楚。 有幾次我寫到一半發現「原來我這步是憑感覺做的」,那本身就是個值得處理的問題。

怎麼寫出真的會被用到的 Skill

把上面的東西收成一份可以照做的順序:

  • 先找出你重複交代最多次的那一件事,不要一次想把所有流程都寫完。官方的建議也是「從已經發現的能力缺口開始,而不是預先設想需求」
  • description 寫兩段:做什麼、什麼時候用。後半段直接寫出使用者可能說的詞
  • 內文寫成步驟,不要寫成說明書。它是拿來執行的,不是拿來讀的
  • 內文控制在 5k token 以內,細節往外拆成獨立檔案,讓它需要時再讀
  • 能寫死的就寫成腳本。腳本的程式碼不進脈絡,只有輸出進,又快又準
  • 寫完真的去用一次,看它有沒有被觸發。沒被觸發九成是 description 的問題,不是內文

常見問題

Skill 跟提示詞到底差在哪?

提示詞是這一次對話講的話,講完就沒了,下次開新視窗要重講。Skill 是放在檔案系統上的一份說明,長期存在,而且 AI 會自己判斷什麼時候該拿出來用。官方的說法是提示詞屬於「對話層級、一次性任務」,Skill 則是「按需載入,不必在每場對話重複同樣的交代」。

裝很多 Skill 會不會把脈絡吃光?

不會,這是它特意設計的。靠「漸進式揭露」分三層:沒被觸發的 Skill 只有名稱與說明進脈絡,官方給的數字是每個約 100 個 token。被觸發才讀內文(5k token 以內)。附帶的檔案與腳本用到才讀,沒用到就是 0。

我不會寫程式,能自己做 Skill 嗎?

可以。SKILL.md 就是一份 Markdown 文字檔,上面加兩行 name 與 description。腳本是選配,不放也完全能用。真正的門檻不是技術,是「你能不能把自己的做法講清楚」。

我在 claude.ai 上傳的 Skill,Claude Code 會吃到嗎?

不會。官方明載自訂 Skill 不會跨平台同步:上傳到 claude.ai 的不會出現在 API,API 上傳的不會出現在 claude.ai,Claude Code 是走檔案系統、跟兩者都分開。要用哪裡就各自放一份。

Skill 跟 MCP 該選哪一個?

不用選,它們解決不同問題。MCP 讓 AI 連得到你的系統,Skill 教它「連上之後該怎麼做」。實務上常常一起用:MCP 接通管道,Skill 補上你們公司的規矩與口徑。

Skill 跟斜線指令差在哪?

誰決定什麼時候用。斜線指令是你打 /xxx 主動叫它跑,Skill 則是它看你這次要做什麼、自己判斷要不要拿出來。兩者不衝突,很多人同時用:常用流程做成斜線指令自己叫,背景知識做成 Skill 讓它自己取用。

從網路上下載別人的 Skill 安全嗎?

要很小心。Skill 裡可以放可執行腳本,Claude 會用 bash 去跑。官方的建議是「只使用你自己寫的、或從 Anthropic 取得的」,來源不明的要逐檔審過,特別留意會去外部抓資料的那種。把它當成在電腦上裝軟體來看待,不要當成裝瀏覽器外掛。

團隊要怎麼共用 Skill?

看你們用哪個平台。Claude Code 放進專案的 .claude/skills/ 跟著 repo 走是最實際的,pull 下來就有。API 那邊是整個工作區共用。claude.ai 反而最不適合團隊,因為自訂 Skill 是每個人自己上傳、管理員沒辦法統一發給全公司。

資料來源

每一筆都實際打開確認過。日期是該來源標示的發布日,這類規格會變動, 需要最新狀況請直接看原始出處。

  1. 01
    Agent Skills
    Anthropic 官方文件·2026-09-21官方一手

    本文絕大部分的技術細節出自這裡:Agent Skills 的定義、SKILL.md 的必要欄位與格式限制(name 最多 64 字、只能小寫數字連字號、不可含 anthropic 與 claude,description 最多 1024 字)、漸進式揭露三層與各層的 token 成本、description 必須同時寫「做什麼」與「什麼時候用」、三個平台的放法與分享範圍差異、自訂 Skill 不跨平台同步、安全警告全文、以及 Agent Skills 不在 ZDR 涵蓋範圍內。日期為本文查證當日。

  2. 02
    Introducing Agent Skills
    Anthropic 官方公告·2025-10-16官方一手

    「Skill 是包含指示、腳本與資源的資料夾,Claude 需要時可以載入」這句定義、「Skills stack together」的可組合性、以及「同一份格式在 Claude apps、Claude Code、API 三處通用」的說法。該頁另註明 Agent Skills 已於 2025-12-18 以開放標準形式發布。

  3. 03
    Equipping agents for the real world with Agent Skills
    Anthropic 工程部落格(Barry Zhang、Keith Lazuka、Mahesh Murag)·2025-10-16官方一手

    Skill 存在的理由(真實工作需要程序性知識與組織脈絡)、漸進式揭露的「目錄→章節→附錄」比喻與「可打包的脈絡量實際上無上限」、Skill 與 MCP 互補的定位,以及「從已發現的能力缺口開始,而不是預先設想需求」這個建議。⚠️ 該頁並未給出「什麼時候不該用 Skill」的指引,所以本文那一段明確標示為我自己的判斷。

  4. 04
    anthropics/skills
    Anthropic 官方 GitHub·2026-09-21官方一手

    Anthropic 公開的開源 Skill 倉庫,可以直接看官方怎麼寫 SKILL.md。想動手前先讀這裡的範例比看教學快。日期為本文查證當日。

延伸閱讀

想讓整個團隊真的會用 AI?

我把自己經營公司在用的 AI 實戰,做成企業內訓 —— 帶團隊用真實任務當場做出成果。

看企業 AI 內訓