Claude Code skill 推薦：官方 skill 怎麼挑、成本多少

我電腦上的 ~/.claude/skills 資料夾裡有 20 個 skill，每次開 Claude Code，它們的名稱和描述就一起被放進對話裡。我用官方工具估算了一下，這 20 個加起來每次對話要先吃掉約 3,713 個 token，還什麼事都沒做。

這是我寫這篇的起點。網路上的 skill 推薦清單很多，但很少人講裝了之後要付什麼。這篇會先解釋 skill 是什麼、怎麼被載入，再用實際估算的數字，一個個看 Anthropic 官方 skill 倉庫裡值得裝的那幾個。

先交代我的素材：那 20 個 skill 裡，17 個出自 Anthropic 的 anthropics/skills 倉庫，3 個是本站作者自己寫的，不在推薦範圍內。我今天再看 GitHub，這個倉庫的 skills 資料夾已經有 19 個，多出來的 academy-guide 和 discernment-nudge 不在我電腦上的副本裡，我沒讀過，這篇不談。另外，這個部落格的專案資料夾裡還有 3 個專案 skill，後面會拿來當寫 skill 的實例。這篇我讀了這 23 個 SKILL.md、估算了成本，但沒有為了寫這篇去新安裝或執行任何 skill。

skill 到底是什麼？一個有說明書的資料夾

一個 skill 就是一個資料夾，裡面一定有一個 SKILL.md。這個檔案開頭是 YAML 格式的設定，接著是用 Markdown 寫給 Claude 看的指示。資料夾裡也可以放參考文件、腳本、範本。

圖 1：anthropics/skills 倉庫的說明與免責聲明（來源：GitHub）

我打開 anthropics/skills 的 README，有三件事值得先知道：

• 授權分兩種。 多數 skill 是 Apache 2.0 開源；但 docx、pdf、pptx、xlsx 這四個文件 skill，README 明寫是「source-available，不是開源」，它們是 Claude 本身處理文件功能背後在用的東西，公開出來當作複雜 skill 的參考。我電腦上的副本也對得上：這四個的 LICENSE 開頭寫的是「© 2025 Anthropic, PBC. All rights reserved.」，其他有附 LICENSE 的則是 Apache License。
• 免責聲明。 這些 skill 僅供示範和教育用途，你從 Claude 實際得到的行為可能跟這裡不同，用在重要工作前要自己測過。
• 安裝方式。 在 Claude Code 裡執行 /plugin marketplace add anthropics/skills，再裝 document-skills 或 example-skills 這兩個 plugin。也可以把單一 skill 資料夾直接複製到 ~/.claude/skills/。

skill 放在哪裡，決定了誰能用。官方文件列了幾個位置：個人的在 ~/.claude/skills/<名稱>/SKILL.md，對你所有專案有效；專案的在專案裡的 .claude/skills/，提交後整個團隊都有；plugin 帶的 skill 則用 /plugin名稱:skill名稱 的格式呼叫。名稱撞到時，企業設定蓋過個人，個人蓋過專案；plugin 的 skill 因為有命名空間，會跟同名的 skill 同時存在。

另外，以前 .claude/commands/ 裡的自訂斜線指令，現在已經併進 skill。文件說 .claude/commands/deploy.md 和 .claude/skills/deploy/SKILL.md 都會建立 /deploy，舊的指令檔照樣能用，但 skill 多了附帶檔案、控制誰能呼叫、自動載入這些能力。

skill 怎麼被載入？三層，用到才讀

這是理解 skill 成本的關鍵。Anthropic 工程部落格 2025 年 10 月 16 日那篇介紹 Agent Skills 的文章，把它叫做漸進式揭露（progressive disclosure）。

圖 2：skill 的三層載入（資料來源：Anthropic 工程部落格、Claude Code skills 文件）

• 第 1 層：啟動時，每個已安裝 skill 的名稱和描述會先放進系統提示。Claude 就是靠這段描述判斷什麼時候該用它。
• 第 2 層：Claude 判斷這個 skill 跟目前的工作有關，或你直接打 /skill名稱，才載入 SKILL.md 的完整內容。官方文件特別對比：CLAUDE.md 每次都整份載入，skill 的本文則只在用到時才載入。
• 第 3 層：skill 資料夾裡的其他檔案，Claude 需要時才去讀；腳本可以直接執行，執行結果才進 context，腳本本身不用。

還有一個比較少人注意的細節：對話太長被壓縮時，Claude Code 會把每個用過的 skill 最近一次的內容重新附上，但每個只保留前 5,000 token，全部合計上限 25,000，從最近用過的開始放。很久以前用過的 skill，壓縮後可能整個不見。

所以第 1 層是你一定要付的錢，第 2、3 層是用到才付。

裝了 skill 要付多少？我估算了一下

Claude Code 有個指令 claude plugin details，可以估算 plugin 的 token 成本。它不能直接量個人 skill 資料夾，所以我把每個 SKILL.md 複製到一個暫時的假 plugin 資料夾裡，再對它執行這個指令。要注意兩點：這是工具的估計值，它自己也寫了可能跟實際用量不同；「觸發時」只計算 SKILL.md 本文，不含附帶的參考檔。

圖 3：我估算的官方 skill 成本，2026 年 10 月 27 日（數字為工具的估計值）

20 個個人 skill 合計常駐約 3,713 token。扣掉本站作者寫的 3 個（四捨五入後合計約 880），官方的 17 個大約 2,800 多。

幾個值得注意的地方：

• 常駐成本跟描述長度直接相關。 claude-api 的描述列了一長串觸發條件和略過條件，常駐約 400，是 17 個裡最貴的。xlsx、docx 的描述也很長，因為它們要讓 Claude 在你提到「報表」「備忘錄」這類字眼時也能想到它。
• 觸發時的差距更大。 claude-api 約 15.2k、skill-creator 約 12.3k，一次用下去就是一大段 context。internal-comms 只要約 410，theme-factory 約 1.1k。
• 資料夾大小不等於 context 成本。 docx 資料夾裡有 61 個檔案，大多是 XML schema 和 Python 腳本，但它們只在需要時才被讀或執行，不會自動進 context。

我的結論是：17 個全裝，每次對話先付將近 3,000 token，對大多數人來說不划算。挑你真的會用到的就好。

值得裝的官方 skill：一個個看

文件四件組：docx、xlsx、pptx、pdf

如果你要 Claude 產出 Word、Excel、PowerPoint 或 PDF 檔案，這四個是最實用的。它們不只是寫給 Claude 的指示，還附了大量 Python 腳本：docx 有 15 支、xlsx 有 13 支、pptx 有 16 支、pdf 有 8 支，處理拆包、驗證、填 PDF 表單這類 Claude 自己寫容易出錯的事。

裝之前要知道相依套件。docx 的 SKILL.md 列了 pandoc（擷取文字）、docx 這個 npm 套件（建新文件）、LibreOffice（轉 PDF）、Poppler 的 pdftoppm（轉圖片）。xlsx 則規定只要用到公式，就必須用 LibreOffice 跑它的 recalc.py 重新計算。我查了自己的電腦：soffice、pandoc、pdftoppm 一個都沒有。這不代表 skill 不能用，基本的讀寫走 Python 函式庫，但轉 PDF、公式重算這些功能會卡住。

授權方面，再提醒一次：這四個是 source-available，你可以看、可以用，但不能把它當開源專案改了再散布。

skill-creator：寫 skill 的 skill

如果你打算自己寫 skill，這個值得先裝。它描述的流程是：決定 skill 要做什麼、寫草稿、建立幾個測試提示、讓帶著這個 skill 的 Claude 跑一遍、和你一起看結果、改寫，重複到滿意為止。

它附了 10 支 Python 腳本，包含跑評測、彙整基準測試、產生報告，以及一支專門優化描述的 improve_description.py。最後這支對應到前面說的第 1 層：描述寫得好不好，直接決定 Claude 會不會在對的時機想到你的 skill。

代價是觸發時約 12.3k token。官方 plugin 市集裡也有一個同名的 skill-creator plugin。

frontend-design：讓 AI 做的畫面不要長得都一樣

這個 skill 的目標，是讓 Claude 做出來的介面不要一看就是 AI 預設樣式。我電腦上這份的段落是：從主題本身出發、設計原則、腦力激盪到實作再自我檢討的流程、克制與自我批評。常駐只要約 90 token。

有個有趣的發現：它在 plugin 市集也有一份。我比對兩份 SKILL.md，描述完全相同，但 plugin 市集那份 71 行，我個人資料夾這份 55 行。官方市集的 plugin 預設會自動更新；直接複製到 ~/.claude/skills 的副本不會，所以你可能一直在用舊版而不自知。

webapp-testing：用 Playwright 測本機網頁

它用 Python 版的 Playwright 操作瀏覽器，測你本機正在開發的網頁。附了一支 with_server.py，負責啟動和關閉開發伺服器（可以同時管好幾個），讓 Claude 不用自己處理伺服器的生命週期。SKILL.md 建議的做法是「先偵查再動手」：先打開頁面、等網路請求都停下來，看清楚頁面上有什麼，再決定要點哪裡。常駐約 90、觸發時約 1.4k，算輕的。

如果你看過我寫的 plugin 推薦，那篇提到的 playwright plugin 是 MCP 形式，這個則是 skill 加腳本。兩者都能操作瀏覽器，差別在一個常駐工具定義，一個用到才載入。

mcp-builder：寫 MCP server 的指南

如果你要把某個 API 包成 MCP server 給 Claude 用，這個 skill 涵蓋 Python（FastMCP）和 Node/TypeScript（官方 MCP SDK）兩條路。資料夾裡有最佳實務、Python 與 Node 各自的實作指南，還有一支評測腳本和範例評測檔，讓你驗證寫出來的工具 Claude 用不用得好。

doc-coauthoring：寫規格、提案的流程

它把共同撰寫文件分成三個階段：蒐集脈絡、整理結構並反覆修改、讀者測試，最後再做一次總檢查。其中讀者測試這步我覺得最有價值：寫完之後，用一個沒看過前面討論的角度去讀，確認文件對真正的讀者來說說得通。這個資料夾只有一個 SKILL.md，觸發時約 5.8k。

claude-api：要寫 Claude API 程式時

這是 17 個裡常駐最貴的（約 400），觸發時也最大（約 15.2k）。它涵蓋模型 ID、價格、參數、串流、工具使用、快取等，資料夾裡按程式語言分了 C#、Go、Java、PHP、Python 等子資料夾。

有一點要留意：它的 SKILL.md 裡有一節標題寫著「Current Models (cached: 2026-06-04)」。skill 是靜態檔案，內容停在寫下的那天；模型和價格變得很快，我電腦上這份副本的模型清單快取日期是 6 月 4 日。用它的時候，價格這類數字還是要回官方頁面確認。

自己寫 skill：最常用的欄位和最容易踩的坑

官方 skill 最大的價值，其實是當範本。真正好用的 skill，往往是你自己針對工作流程寫的。

圖 4：SKILL.md 最常用的欄位（資料來源：Claude Code skills 文件）

anthropics/skills 的 README 說，開頭的設定其實只需要 name 和 description 兩個欄位。但官方文件裡有幾條規則，值得寫之前先知道：

• description 要把最重要的用途放前面。 description 加上 when_to_use 在 skill 清單裡超過 1,536 個字元會被截斷。
• 有副作用的 skill 加 disable-model-invocation: true。 設了之後 Claude 不能自己決定呼叫它，只能由你打指令觸發。文件舉的例子是 /commit、/deploy、/send-slack-message。
• SKILL.md 控制在 500 行內。 詳細的參考資料拆到別的檔案，利用第 3 層「用到才讀」的特性。
• 改了馬上生效。 在 ~/.claude/skills/ 或專案的 .claude/skills/ 裡新增、修改、刪除 skill，目前的工作階段就會偵測到，不用重開。

拿這個部落格自己的專案 skill 當例子。本站的文章就是靠 3 個專案 skill 產出、審查、發布的，我也用同樣的方法估算了它們：

圖 5：本站 .claude/skills 裡的三個 skill，2026 年 10 月 27 日估算

write-article 有 606 行，超過官方建議的 500 行，觸發時約 13.8k token，跟 claude-api 差不多大。照官方的建議，它應該把詳細規則拆到另外的參考檔。我這麼寫出來，是因為它是個很典型的情況：一個 skill 需求一多就一直加規則，最後長成一大份。官方文件說的壓縮規則在這裡也有實際影響：壓縮後每個 skill 只保留前 5,000 token，一份 13.8k 的 skill，如果長對話被壓縮，後面大約三分之二不會被重新附上。

安全：allowed-tools 不是你想的那樣

skill 看起來只是一份 Markdown，好像很安全。但官方文件裡有一段，我認為每個會從網路上抓 skill 的人都該讀。

圖 6：官方文件對 allowed-tools 的說明（來源：code.claude.com）

我打開這一節，它講了兩件事。第一，allowed-tools 的作用是在呼叫 skill 的那個回合，讓列出來的工具不用再問你就能執行；它不會限制其他工具，下一則訊息送出後這個授權就清掉。第二，工作區信任不管控這個欄位：就算是你從沒信任過的資料夾，Claude Code 也會套用專案 skill 的 allowed-tools，即使是 -p 這種非互動模式。文件的原話是，skill 可以給自己很大的工具權限，所以在一個倉庫裡執行 Claude Code 之前，先看看它附的 skill 寫了什麼 allowed-tools。

這跟 提示注入 是同一類問題：skill 的內容就是寫給 Claude 的指示，誰寫的 skill，就等於誰在對你的 Claude 下指令。Anthropic 工程部落格的建議很直接：只從可信任的來源安裝 skill；來源不那麼可信時，用之前要徹底檢查，包括附帶的程式、相依套件，以及會連到外部網路的指示。

我讀的兩篇第三方推薦文，Composio（6 月 15 日）和 Krater，都是賣自家產品的廠商寫的，各自把自己的 skill 排在前面。Composio 那篇倒是說了句實話：大多數 skill 沒什麼用，除了汙染你的 context window，還可能帶來安全風險。這句我同意。

怎麼挑？依你要做的事

圖 7：我依前面的分析整理的挑選建議

我的建議跟 plugin 那篇一樣：一次只裝你這週真的會用到的。skill 的常駐成本雖然比 plugin 小，但累積起來一樣可觀，我自己的 20 個就是例子。

如果你只想裝一個，我會選 skill-creator。官方的 skill 終究是別人的工作流程，用 skill-creator 把你自己反覆在做的事寫成 skill，回報通常比任何現成的都大。寫的時候記得三件事：描述把最重要的用途寫在前面、有副作用的加 disable-model-invocation、超過 500 行就拆檔。