Claude Skills 教學：10 分鐘打造你的第一個 SKILL.md（2026）
Skills 很可能是你還沒用上的 Claude Code 最重要功能。Claude skill 就是一個包含 SKILL.md 檔案的資料夾，當你的提示詞符合其描述時，Claude 會自動載入它——不用複製貼上提示詞、不用維護臃腫的 CLAUDE.md、也不用記該用哪個範本。我們已在此 repo 的 .claude/skills/agent/ 資料夾中發布了 4 個 skills，隨著 Skills 2.0 與 Anthropic Marketplace 於 2026 年初正式登場，這個格式終於步入正軌。以下是避開常見眉角後，真正可行的做法。
重點整理
- Claude skill 是一個包含
SKILL.md檔案（帶有 YAML frontmatter）的資料夾，Claude 會在相關時自動載入。- Skills 存放在
~/.claude/skills/（個人）或.claude/skills/（專案）中，Claude 啟動時會掃描兩者。- 可重複的流程用 Skills；即時外部資料用 MCP；多步驟規劃用 subagents；確定性事件用 hooks。
- 建立第一個 skill 最快的方式，是請 Claude 呼叫它自己的
skill-creatorskill，它會幫你寫好 SKILL.md。
什麼是 Claude Skills？
Claude skill 是一個資料夾，內含帶有 YAML frontmatter（name、description、選填的 allowed-tools）的 SKILL.md 檔案。當你的提示詞符合該 description 時，Claude Code 會自動將其載入上下文。Skill 能將可複用的工作流程（例如 /commit 或 /explain-code）打包起來，而不會讓你的系統提示詞變得臃腫。
根據 Anthropic 官方文件，每個 skill 資料夾都包含三樣東西：必要的 SKILL.md、選用的隨附腳本（從 Python 輔助程式到 JSON 設定檔皆可），以及選用的參考文件（會與主體內容一併載入）。就是這樣。沒有建置步驟、沒有安裝程序、也沒有 manifest。
巧妙之處在於漸進式揭露（progressive disclosure）。啟動時，Claude 只會掃描每個 skill 的 description 欄位。主體內容——指示、範例、工具呼叫模式——都會留在磁碟上，直到你的提示詞真正符合為止。因此，你可以安裝 50 個 skill，而在任何一個被觸發之前，完全不需要付出 token 成本。
你可以把 skill 想像成食譜書裡的食譜——當 Claude 在你的提示詞中看到「食材」時，就會翻到對應的那一頁。Skill 是 Claude 按需讀取的資料夾，而不是你需要記得貼上的提示詞。這就是它的核心賣點。
一個最精簡的 SKILL.md 長這樣：
---
name: Summarize file
description: Use when the user asks for a 3-sentence summary of a file or function.
---
Read the file at $ARGUMENTS. Summarize purpose, key dependencies, and the
single most surprising thing about it. Three sentences max.十行。真實可用的 skill。隨時待命。
快速開始：10 分鐘打造你的第一個 Skill
要在 10 分鐘內建立你的第一個 Claude skill：(1) 建立 ~/.claude/skills/explain-code/ 資料夾，(2) 新增一個 SKILL.md 檔案，包含 name、description 以及工作流程內容，(3) 重新啟動 Claude Code 讓它掃描新的目錄，(4) 用符合 description 的提示詞來觸發它。
以下是完整流程。
步驟 1：建立目錄
mkdir -p ~/.claude/skills/explain-code個人技能（僅供自己使用）請放在 ~/.claude/skills/ 下。專案技能（透過 git 與團隊共享）則放在儲存庫根目錄的 .claude/skills/ 下。日常工作流程請選用個人技能；若希望儲存庫中的每位貢獻者都能繼承使用，則選用專案技能。
步驟 2：撰寫 SKILL.md
將這個檔案放到 ~/.claude/skills/explain-code/SKILL.md：
---
name: Explain code
description: Use when the user asks for a plain-English walkthrough of a code snippet, function, or file. Use $ARGUMENTS for the path or snippet.
---
You are explaining code to a developer who is new to this codebase.
1. Read the file or snippet at $ARGUMENTS.
2. State the file's purpose in one sentence.
3. Walk through the control flow line by line in plain English.
4. Flag any non-obvious dependencies or side effects.
5. End with one question the reader should ask before changing this code.這就是這個 skill 的全部。frontmatter 是合約，內文則是操作手冊。
步驟 3：重新啟動 Claude Code
即時探索是 Skills 2.0 的功能，舊版 Claude Code 需要重新啟動才能偵測到新目錄。如果不確定你使用的是哪個版本，重新啟動一次也不會有什麼損失。
步驟 4：觸發它
開啟一個專案並輸入提示詞：
walk me through what auth/middleware.ts doesClaude 會將你的提示詞與 description 欄位進行比對，找到 explain-code，然後悄悄將 SKILL.md 的內容載入到上下文之中。你會在工具紀錄中看到「Using skill: explain-code」。大功告成。
專業提示： 懶得自己動手寫檔案嗎？開啟 Claude Code，然後輸入
Use the skill-creator skill to scaffold an explain-code skill for me.。Anthropic 內建的skill-creator是一個後設技能（meta-skill），它會透過問答引導你、挑選適當的allowed-tools，並將 SKILL.md 寫入正確的資料夾。這絕對是打造你第一個技能最快的途徑。
這就是 10 分鐘的承諾：五分鐘打字、一次重新啟動、一個測試提示詞。
SKILL.md 內部結構：Frontmatter 參考
SKILL.md 的 frontmatter 是以 --- 分隔符號包裹的 YAML。其中兩個欄位為必填：name（不超過 64 個字元，作為斜線指令名稱）與 description（Claude 用來比對你的提示詞的觸發文字）。選填欄位則可控制工具存取、模型呼叫、檔案 glob 以及執行環境。
以下是完整參考，內容取自 Anthropic 的 skills 文件：
| 欄位 | 是否必填？ | 類型 | 使用時機 |
|---|---|---|---|
name | 是 | 字串，不超過 64 字元 | 一律需要，會成為斜線指令名稱 |
description | 是 | 字串，不超過 1024 字元 | 一律需要，Claude 會掃描此欄位以判斷該 skill 是否相符 |
allowed-tools | 否 | 工具模式陣列 | 將 skill 鎖定至特定工具（例如 Bash(git *)、Read、Grep） |
disable-model-invocation | 否 | 布林值 | 讓 skill 僅能由使用者呼叫（僅限斜線指令，絕不自動觸發） |
user-invocable | 否 | 布林值 | 標記某個 skill 應以 /skill-name 形式出現在斜線指令選單中 |
argument-hint | 否 | 字串 | 向使用者提示 $ARGUMENTS 應包含的內容 |
model | 否 | 字串 | 將 skill 固定至特定模型（例如 claude-opus-4-7） |
context | 否 | default 或 fork | （Skills 2.0）在分支的環境視窗中執行 skill，避免污染主執行緒 |
globs | 否 | glob 模式陣列 | 當符合 glob 的檔案在作用範圍內時，自動建議該 skill |
references | 否 | 檔案路徑陣列 | 捆綁隨 skill 主體一併載入的參考文件 |
bundled-files | 否 | 檔案路徑陣列 | 捆綁 skill 可執行的腳本 |
tags | 否 | 字串陣列 | 在市集列表中整理 skills |
context: fork 這一列值得特別說明。它是 Skills 2.0 的原生功能，會在獨立的環境視窗中執行 skill，適用於長時間執行的研究類 skill，或任何會產生大量中間 token、而你不想讓其污染主執行緒的作業。如果你不熟悉這個概念，我們的環境工程指南有詳細說明其中的取捨。
一份填入所有欄位的極繁主義 SKILL.md frontmatter：
---
name: Deploy preview
description: Use when the user wants to deploy a preview build of the current branch to staging.
allowed-tools: ["Bash(git status:*)", "Bash(npm run build:*)", "Bash(vercel:*)"]
disable-model-invocation: true
user-invocable: true
argument-hint: <branch-name or 'current'>
model: claude-opus-4-7
context: fork
globs: ["package.json", "vercel.json"]
references: ["./deploy-runbook.md"]
bundled-files: ["./scripts/preflight.sh"]
tags: ["deploy", "vercel", "preview"]
---專業提示：
description的頭號錯誤，就是寫給人類看。要寫給 Claude 看——用具體的觸發短語，而非行銷文案。錯誤示範：「一個強大的 Git 自動化技能。」正確示範：「當使用者想要提交變更、撰寫提交訊息或開啟 PR 時使用。」」
兩種實戰技能，完整走一遍
有兩種技能模式涵蓋了 80% 的實際使用場景：(1) 一個由使用者手動呼叫的 /commit 技能，設定 disable-model-invocation: true 與 allowed-tools: Bash(git *)，用於執行確定性操作；(2) 一個自動觸發的 /explain-code 技能，使用預設 frontmatter，當提示詞符合其描述時，Claude 會自動觸發它。
大多數教學只展示程式碼片段。以下是兩個完整的檔案，你今天就可以直接複製到 ~/.claude/skills/ 中使用。
/commit skill（可由使用者觸發）
---
name: Commit
description: Use when the user wants to stage and commit code changes with an AI-written conventional-commit message.
disable-model-invocation: true
user-invocable: true
allowed-tools:
- "Bash(git status:*)"
- "Bash(git diff:*)"
- "Bash(git add:*)"
- "Bash(git commit:*)"
---
1. Run `git status` and `git diff` to see what's staged and unstaged.
2. Group changes into one logical commit. If there are multiple unrelated
changes, ask the user which to include.
3. Draft a Conventional Commits message: `type(scope): subject` (≤72 chars),
blank line, body explaining *why*, not *what*.
4. Show the message to the user. Ask "Commit this?" Wait for explicit yes.
5. On confirmation, run `git add` for the included files and `git commit -m`.
6. Print the resulting commit hash.測試提示詞：/commit
執行結果：Claude 會檢查 git 狀態、草擬提交訊息、要求你確認，確認後才執行 git commit。disable-model-invocation: true 代表它不會在「儲存我的變更」這類模糊提示時自動觸發，只有在你輸入 /commit 時才會執行。allowed-tools 白名單將其鎖定在 git 子命令；它在機制上就無法執行 rm -rf 或推送到遠端。這是我們在自家管線中實際上線使用的功能。
針對確定性的提交後動作（執行 lint、重新產生型別、發送 Slack webhook 通知），請改用 Claude Code hooks——skill 是機率性的，hook 則每次都會觸發。
/explain-code 技能（可由模型呼叫）
---
name: Explain code
description: Use when the user asks for a plain-English walkthrough of a code snippet, function, or file. Use $ARGUMENTS for the path or snippet.
argument-hint: <file path or pasted snippet>
model: claude-opus-4-7
---
1. Read the file or snippet at $ARGUMENTS. If $ARGUMENTS is empty, ask
the user which file to explain.
2. State the file's purpose in one sentence.
3. Walk through the control flow line by line in plain English.
4. Flag any non-obvious dependencies, side effects, or hidden assumptions.
5. End with one question the reader should ask before modifying this code.測試提示詞：walk me through what auth/middleware.ts does
會發生什麼事：注意使用者並沒有輸入 /explain-code。Claude 會將「walk me through」與 description 欄位進行比對，找到該技能並自動呼叫它。這就是魔術所在——description 欄位負責路由。model: claude-opus-4-7 欄位將此技能固定使用 Opus，無論你預設的模型是什麼，因此深度程式碼解析永遠會使用更聰明的模型。（關於使用不同模型執行 Claude Code 的更多資訊。）
為什麼要有兩種模式？ 技能 #1 由使用者呼叫，且鎖定特定工具——可預期、安全，非常適合 git 或部署操作。技能 #2 則由模型自動呼叫，且用途開放，這正是技能的魔術所在，但請信任你的
description欄位。使用者可呼叫的技能提供可預測性；模型可呼叫的技能提供魔術。 請依每個技能來選擇，而非依每個 repo。
更多實際範例技能，請參考官方 anthropics/skills repo 以及社群維護的 awesome-claude-skills 清單。
Skills、MCP、Subagents 與 Hooks：何時該用什麼
如果你想讓 Claude 自動觸發可重複使用的工作流程，或是以斜線指令手動呼叫，請使用 Skills。當你需要即時的外部資料（資料庫、API、工作目錄以外的檔案系統）時，請使用 MCP 伺服器。對於 Claude 應該委派給全新上下文執行的多步驟計畫，請使用 subagents。對於必須一定會觸發、絕非機率性的確定性事件（pre-commit、post-tool-use），請使用 hooks。
快速定位：skills 是工作流程，Model Context Protocol 是資料，subagents 是計畫，hooks 是事件。它們各自存在於 Claude Code 的不同層級，而用錯層級就是選錯工具。根據 Anthropic 官方的 Skills explained 一文，這正是他們希望你內化的心智框架。
| 問題 | Skills | MCP | Subagents | Hooks |
|---|---|---|---|---|
| 觸發方式 | prompt 比對或 /slashcmd | 模型決定呼叫工具 | 模型委派任務 | Claude Code 事件（pre-tool-use、post-edit） |
| 存放位置 | .claude/skills/ | 外部伺服器（stdio 或 SSE） | .claude/agents/ | settings.json 的 hooks 區塊 |
| 最適合 | 可重複使用的工作流程、帶有邏輯的 prompt 範本 | 即時資料、第三方 API、cwd 以外的檔案系統存取 | 多步驟規劃、平行作業、隔離的上下文 | 必須一定會觸發的確定性事件 |
| 確定性 | 機率性（由 Claude 選擇） | 機率性（由 Claude 選擇） | 機率性（由 Claude 選擇） | 確定性（必定觸發） |
| Token 成本 | 低（掃描時僅載入 description） | 中高（工具定義＋回應內容） | 高（每次委派都建立全新上下文） | 無（帶外 shell 執行） |
| 何時不該使用 | 即時資料、確定性事件 | 靜態工作流程、prompt 邏輯 | 單次性的確定性動作 | 分支邏輯、任何機率性的事物 |
它們可以相互組合。Skill 可以透過 allowed-tools 呼叫 MCP 工具。Hook 可以在 skill 完成後觸發。Subagent 可以使用被授予存取權限的 skills。最乾淨的心智模型是：先選對層級，再讓它們層層堆疊。當你想要一個 Claude 可以自行選擇的工作流程時，Skills 就是你會拿起的上下文工程基本建構單元；當你想要某個 Claude 無法跳過的東西時，就用 hooks 來自動化。
各自最糟的誤用方式：拿 Skills 處理即時資料（應改用 MCP）；拿 MCP 處理單次提示詞範本（應改用 Skills）；拿 subagents 處理確定性的檔案編輯（應改用 hooks）；拿 hooks 處理分支邏輯（應改用 Skills）。Skills 是工作流程，MCP 是資料，subagents 是計畫，hooks 是事件。依層級選擇，別追流行詞。
技能存放位置：個人、專案、外掛、企業
Claude 技能安裝於四種作用域：個人（~/.claude/skills/，僅限你自己）、專案（儲存庫根目錄的 .claude/skills/，透過 git 與團隊共享）、外掛（透過 Anthropic Marketplace 或任意外掛網址散佈）、以及企業（由 IT 透過 MDM/管理政策推送）。Claude 會在啟動時掃描全部四種作用域。
| 作用域 | 路徑 | 共享方式 | 適用情境 |
|---|---|---|---|
| 個人 | ~/.claude/skills/ | 不共享 | 你日常的工作流程（commit、review、撰寫 PR） |
| 專案 | .claude/skills/（儲存庫根目錄） | git，儲存庫的每位貢獻者 | 團隊規範、特定程式碼庫的模式 |
| 外掛 | 透過 /plugin install <url> 安裝 | Anthropic Marketplace 或網址 | 跨儲存庫重用、散佈給社群 |
| 企業 | 由組織管理員推送（受管設定） | 全組織強制套用 | 合規要求的工作流程、安全鎖定的工具 |
| 內建（隨附） | 隨 Claude Code 提供 | 不適用 | 文件技能（pdf、docx、pptx、xlsx）、/debug、/simplify |
內建的文件技能很容易被忽略，Claude Code 開箱即已隨附 pdf、docx、pptx 和 xlsx 技能，外加一小組 /debug、/simplify 等類似內建指令。（姊妹工具 Claude Design 也隨附自己的內建工作流程技能，用於設計生成；同樣的模式，不同的領域。）
什麼時候該透過外掛而非專案來發佈？當同一個工作流程能惠及多個儲存庫時，外掛就是更好的選擇——例如你在五個客戶程式碼庫之間使用的 /release 技能，就應該放在外掛裡，而不是複製貼上到每個儲存庫的 .claude/skills/。專案技能則適合特定程式碼庫的規範（你團隊的 PR 範本、你的自訂測試執行器）。Anthropic Marketplace，加上可從任何網址執行的 /plugin install，讓外掛成為跨儲存庫重用的正確解答。根據外掛文件，探索與更新都會自動處理。
進階模式：$ARGUMENTS、動態 Shell 注入、context: fork
有三種進階 skill 模式最為關鍵：$ARGUMENTS 讓使用者能將參數傳遞給可由使用者叫用的 skill（/translate $ARGUMENTS）；動態 shell 注入（搭配 allowed-tools: Bash(...)）讓 skill 能執行腳本並將輸出導入上下文；而 context: fork（Skills 2.0）則在獨立的上下文視窗中執行 skill。截至 2026 年 5 月，Anthropic 的完整指南白皮書是關於 context: fork 的權威參考資料。
用於參數化技能的 $ARGUMENTS
---
name: Translate
description: Translate the most recent message into the target language.
user-invocable: true
argument-hint: <target-language, e.g. spanish, japanese, brazilian portuguese>
---
Translate the user's previous message into $ARGUMENTS. Preserve tone,
preserve markdown formatting, return only the translation.測試提示詞：/translate spanish。Claude 會在執行時將 spanish 代入 $ARGUMENTS。這是讓單一技能具備多種用途、而不必撰寫多個變體的最簡潔方式。
透過 allowed-tools 進行動態 Shell 注入
---
name: Review last commit
description: Use when the user wants a code review of the last git commit.
allowed-tools: ["Bash(git diff HEAD~1:*)", "Bash(git log -1:*)"]
---
Run `git diff HEAD~1` and `git log -1`. Review the diff for bugs, security
issues, and style violations. Output a 5-bullet review.這個 Skill 會呼叫外部 Shell，將 diff 透過管線送入 context 進行審查。請將 allowed-tools 鎖定為特定指令（如 Bash(git diff HEAD~1:*)），絕不要使用裸 Bash，裸 Bash 權限是這個模式的安全大坑。
context: fork（Skills 2.0）
---
name: Deep research
description: Use when the user wants a multi-source research summary on a topic.
context: fork
---
Research the topic in $ARGUMENTS using available web tools. Produce a
2-page summary with citations. Do not pollute the main thread.Fork 會為該 skill 建立獨立的 context window，讓 50K token 的中間研究筆記不會滲入你的主工作階段。適合長時間研究、大型重構規劃，或任何會產生大量一次性 token 的場景。僅限 Skills 2.0 使用，舊版 Claude Code 會忽略此欄位。
故障排除：為什麼你的 Skill 沒有被觸發
Skill 無法觸發通常是以下四種原因之一：(1) description 寫得太籠統，導致 Claude 無法將它與你的提示詞對應起來，(2) 目錄路徑錯誤（應為 .claude/skills/ 而非 claude/skills/），(3) 新增 skill 後沒有重新啟動 Claude Code（僅限 Skills 2.0 之前的版本），或 (4) skill 名稱與內建或更高優先級的 skill 發生衝突。根據 Claude Code GitHub issues tracker 上最常被搜尋的失敗模式，這四種情況涵蓋了約 95% 的「為什麼沒有作用」相關回報。
失敗模式 1：「我的 skill 完全沒有顯示出來」
頭號原因是路徑錯誤，.claude/skills/（有圓點）和 claude/skills/（沒圓點）是每個人凌晨一點都犯過的打字錯誤。執行 ls -la ~/.claude/skills/ 確認目錄確實存在且帶有圓點。如果目錄在那裡，但 Claude 仍然看不到，請重新啟動 Claude Code 一次。Skills 2.0 之前的版本只會在啟動時掃描。
失敗模式 2：「Claude 沒有自動觸發我的 skill」
description 欄位寫得太模糊，或是寫給人類看的，而不是寫給 Claude 看的。請用具體的觸發短語重寫，讓它反映使用者實際提出需求的方式。在這個 repo 建了 4 個 skill 之後，我踩到的坑是留下像「A helpful skill for SEO.」這種描述。完全沒用。改寫成：「Use when the user wants to add JSON-LD schema, meta tags, or SEO frontmatter to a Markdown post.」觸發準確率從約 30% 提升到約 95%。觸發準確率的成敗，全在 description 欄位。要寫給 Claude 看，而不是寫進你的履歷。
失敗模式 3：「說明文字在斜線指令面板中被截斷了」
不是你的 description 超過 1024 個字元，就是你的 name 超過 64 個字元。兩者都有硬性上限。解法：將技能拆分為兩個範圍更小的技能，或將冗長的細節移入 SKILL.md 內文。frontmatter 是用來做路由的，不是用來寫說明的。
失敗模式 4：「即時變更偵測沒有作用」
在 Skills 2.0 之前的 Claude Code，任何 SKILL.md 的編輯都需要完整重新啟動才能生效。如果你正在反覆修改一個 skill，但變更遲遲沒有套用，那你很可能使用的是較舊的版本。請升級到內建 Skills 2.0（即時探索）的 Claude Code 版本，或者養成每次儲存後都重新啟動的習慣。雖然麻煩，但成本很低。
超越 Claude 的技能：開放式 Agent Skills 標準
沒錯，技能是一套開放標準。agentskills.io 上的 Agent Skills 標準獨立於任何廠商之外，定義了 SKILL.md 格式。OpenAI 的 Codex CLI 與 ChatGPT Desktop 已於 2025 年 12 月採用此標準；你為 Claude Code 撰寫的同一份 SKILL.md，只需微調 frontmatter 即可在 Codex 中運作。
以下是截至 2026 年 5 月的跨工具支援矩陣：Claude Code 完整支援 Agent Skills（作為參考實作）。OpenAI 的 Codex CLI 同樣完整支援。ChatGPT Desktop 為部分支援——name、description 和內文可以運作，但 allowed-tools 的相容性尚未到位。Gemini CLI 於 2026 年初宣布支援，但截至撰文時尚未正式推出。Cursor 則是特例，它使用自己的 Cursor rules 格式，原生並不讀取 SKILL.md，不過社群已有轉接方案。
若要讓你的技能在今年內持續適用，現在該怎麼寫：保持 name 和 description 簡潔且不綁定特定工具。若要跨工具使用，將任何廠商專屬的 frontmatter 隔離在命名空間（claude: 或 codex:）之下。可攜式介面——name、description、內文、$ARGUMENTS——在所有工具上都能運作；而 context: fork 等進階欄位在其他廠商推出對應功能之前，仍屬 Claude 專屬。根據外洩的 Claude Code 路線圖，Anthropic 也在推動更深度的市集整合，因此可攜性只會越來越容易。
尋找技能範例的三個去處：anthropics/skills（官方）、awesome-claude-skills（社群）、以及 agentskills.io（標準規範頁面）。技能不再是 Claude 的專屬功能，而是 Claude 率先推出的開放標準。
常見問題
Claude skill 和 MCP server 有什麼差別？
Claude skill 是一份 SKILL.md 檔案，內含工作流程指示，當你的提示詞符合其描述時，Claude 就會載入該檔案。MCP server 則是一個獨立的處理程序，Claude 會呼叫它來擷取即時資料（資料庫、API，以及工作目錄以外的檔案系統）。工作流程請用 Skills，資料存取請用 MCP。兩者可以組合使用，skill 能夠呼叫 MCP 工具。
Claude 技能需要付費嗎？
不需要，技能（Skills）是 Claude Code 的內建功能，不額外收費。你只需為技能執行時所消耗的模型 token 付費。從 Anthropic Marketplace 安裝的技能可能是付費的（目前相當少見），但官方的 anthropics/skills 儲存庫以及社群維護的 awesome 清單，全部都可以免費複製與使用。
Claude 技能會安裝在哪裡？
個人技能放在 ~/.claude/skills/{skill-name}/，專案技能則放在儲存庫根目錄下的 .claude/skills/{skill-name}/。外掛技能透過 /plugin install <url> 安裝，並存放在你的外掛目錄中。企業技能由組織的 IT 部門透過受管設定推送。Claude Code 會在啟動時掃描這四個範圍。
我該如何從零開始建立 Claude skill？
在 ~/.claude/skills/ 底下建立一個資料夾，加入一個帶有 YAML frontmatter（name、description）的 SKILL.md 檔案，接著寫上工作流程說明，然後重新啟動 Claude Code。最快的方式：開啟 Claude Code，請它呼叫內建的 skill-creator skill，它會在一分鐘內為你自動產生 SKILL.md 的架構。
為什麼我的 Claude skill 沒有觸發？
最常見的四個原因：(1) description 寫得太模糊，Claude 無法與你的提示詞匹配，請改寫並加入具體的觸發用語；(2) skill 放錯了路徑（應為 .claude/skills/，而非 claude/skills/）；(3) 在 Skills 2.0 之前的版本中，Claude Code 需要重新啟動；(4) skill 名稱與內建的 skill 衝突。請執行 ls -la ~/.claude/skills/ 來驗證。
ChatGPT 或 Cursor 可以使用 Claude 技能嗎？
ChatGPT Desktop 和 Codex CLI 支援與 Claude 相同的 Agent Skills 標準，同一份 SKILL.md 只需稍作 frontmatter 調整即可在兩者中運行。Cursor 使用自有的 Cursor rules 格式，原生並不支援讀取 SKILL.md。Gemini CLI 於 2026 年初宣布支援，但截至 2026 年 5 月尚未正式推出。
skill-creator 技能是什麼？
skill-creator 是內建於 anthropics/skills 儲存庫中的一個後設技能（meta-skill），能協助 Claude 為你撰寫新的 SKILL.md 檔案。只要告訴 Claude 你希望這個技能做什麼，skill-creator 就會向你訪談需求描述、挑選合適的 allowed-tools，並將 SKILL.md 寫入正確的資料夾。這是最快速的骨架建立方式。
disable-model-invocation 是做什麼用的？
在 skill 的 frontmatter 中設定 disable-model-invocation: true，可以防止 Claude 根據提示詞匹配自動觸發該 skill。該 skill 將僅限使用者手動呼叫，它會以 /skill-name 的形式出現在斜線命令選單中，只有在明確呼叫時才會執行。適用於 /commit 或 /deploy 這類具有破壞性或確定性的操作。
動手做幾個 skill，放到專案裡實際試用，看看哪些真正派得上用場。如果你的團隊在多個 repo 中頻繁踩到「skill 沒有觸發」這類坑，想找人幫忙檢視一下 .claude/skills/ 的設定，歡迎與我們聯繫，很樂意和你一起逐步排查。