用 skill-creator 建立 Skill：Claude Code 自訂技能完整教學
skill-creator 是 Anthropic 官方 skills 專案中的一個 Skill 開發助手，可以協助使用者建立 Claude Code 可使用的自訂 Skill，透過 Skill，你可以把固定工作流程、專業知識、工具使用方式、文件格式與腳本包裝成可重複使用的能力，讓 Claude 在特定任務上更穩定、更一致，也更符合你的實際工作需求。
什麼是 Skill？
在 Claude Code 的使用情境中，Skill 可以理解成「給 AI 使用的操作說明書」。
它不是單純的一段 prompt，而是一個可重複使用的能力包。通常一個 Skill 會包含：
skill-name/ ├── SKILL.md # 核心說明文件，必要 ├── scripts/ # 可執行腳本，選用 ├── references/ # 參考文件或知識資料，選用 ├── assets/ # 圖片、範本、範例檔案等資源，選用
其中最重要的是 SKILL.md。
這個檔案會告訴 Claude：
- 這個 Skill 是做什麼的
- 什麼情境下應該使用
- 要遵守哪些流程
- 輸出格式是什麼
- 是否需要使用特定工具、腳本或範本
簡單來說，Skill 的目標是讓 Claude 不只是「聽懂一次指令」，而是能長期穩定地執行某一類工作。
skill-creator 是什麼？
skill-creator 是 Anthropic 官方提供的 Skill 建立助手，收錄在官方 skills 專案中。
它的作用是協助你從零開始建立一個 Skill，包含：
- 釐清 Skill 的用途
- 設計觸發情境
- 撰寫
SKILL.md - 建立參考文件
- 設計測試案例
- 評估 Skill 使用前後的效果
- 最後打包成
.skill檔案
如果你只是手動寫 SKILL.md，很容易漏掉使用情境、輸出格式、邊界條件或測試流程。
而 skill-creator 的價值就在於，它會像一個 Skill 顧問一樣，逐步問你問題，幫你把需求整理成可以實際使用的 Skill。
官方網頁與下載連結
官方 GitHub 專案：
https://github.com/anthropics/skills/tree/main
skill-creator 官方目錄：
https://github.com/anthropics/skills/tree/main/skills/skill-creator
下載 Anthropic skills 專案 ZIP：
https://github.com/anthropics/skills/archive/refs/heads/main.zip
安裝 skill-creator
如果你已經在使用 Claude Code，可以透過以下方式安裝 skill-creator。
方法一：使用 npx skills add
npx skills add https://github.com/anthropics/skills --skill skill-creator
方法二：使用 claude install
claude install anthropics/skills/skill-creator
安裝完成後，就可以在 Claude Code 中呼叫：
/skill-creator
接著 Claude 會開始引導你建立 Skill。
用 skill-creator 建立 Skill 的基本流程
使用 skill-creator 建立 Skill，通常可以分成以下幾個階段。
1. 說明你想建立的 Skill
一開始，你可以用自然語言描述需求，例如：
我想建立一個 Skill，用來把會議逐字稿整理成結構化會議紀要。
或是：
我想建立一個 Skill，用來分析 WordPress 網站錯誤訊息，並提供排查步驟。
這時候不需要一次寫得非常完整，因為 skill-creator 會繼續追問細節。
2. 回答 skill-creator 的需求問題
skill-creator 通常會確認幾個重點：
- 這個 Skill 主要要完成什麼任務？
- 使用者在什麼情境下會觸發它？
- 輸入資料可能是文字、檔案、程式碼還是圖片？
- 輸出格式要用 Markdown、表格、JSON、Word 文件，還是其他格式？
- 是否有固定流程、固定語氣或固定檢查清單？
- 是否需要使用特定工具、腳本或外部文件？
這一步非常重要。
如果需求沒有講清楚，後面 Skill 產生的結果就可能不穩定。
3. 自動產生 SKILL.md 草稿
確認需求後，skill-creator 會協助產生 SKILL.md。
一個基本的 SKILL.md 會長得像這樣：
--- name: meeting-minutes description: Convert meeting transcripts into structured meeting minutes with decisions and action items. --- # Meeting Minutes Skill Use this skill when the user provides a meeting transcript and wants a structured meeting summary. ## Output Format Include the following sections: 1. Meeting topic 2. Date and time 3. Participants 4. Key discussion points 5. Decisions 6. Action items with owner and deadline ## Guidelines - Keep the summary concise. - Preserve important decisions. - Do not invent missing attendees or dates. - If information is missing, mark it as "未提供".
這份 SKILL.md 就是 Claude 之後使用 Skill 時會讀取的核心說明。
4. 加入參考資料與範本
如果你的 Skill 需要固定格式，可以把範本放進 references/ 或 assets/。
例如：
meeting-minutes/ ├── SKILL.md ├── references/ │ └── meeting-template.md ├── assets/ │ └── company-style-guide.pdf
常見的參考資料包括：
- 公司品牌規範
- 文件格式範本
- 常用表格
- API 使用說明
- 程式碼規範
- 工作流程 SOP
- 檢查清單
這樣 Claude 在執行任務時，不只會依照 prompt 回答，也會參考 Skill 內部的固定資料。
5. 設計測試案例
建立 Skill 後，最好不要馬上投入正式工作，而是先做測試。
你可以準備幾組測試資料，例如：
測試一：正常格式的會議逐字稿 測試二：缺少參與人資訊的會議紀錄 測試三：內容很長、決議很多的會議 測試四：只有零散重點，沒有完整逐字稿
測試的目的不是只看 Claude 有沒有回答，而是要比較：
- 有使用 Skill 時，結果是否更穩定？
- 輸出格式是否一致？
- 是否遵守你指定的規則？
- 是否能處理邊界情況？
- 是否有少編造、少漏項？
6. 根據測試結果修改 Skill
第一次產生的 Skill 通常不會完美。
常見需要調整的地方包括：
- 描述太模糊，導致 Claude 不知道何時使用
- 輸出格式不夠明確
- 邊界條件沒有寫清楚
- 範例太少
- 沒有說明錯誤情況要怎麼處理
- 沒有限制 Claude 不要自行補資料
建議你把 Skill 當成一份「可持續最佳化的 SOP」。
每次遇到輸出不符合預期，就回頭修改 SKILL.md。
7. 打包成 .skill 檔案
當 Skill 測試穩定後，就可以打包成 .skill 檔案，方便匯入、分享或部署。
打包後的 Skill 就像一個可攜式能力包，可以用在支援 Skill 的 Claude 環境中。
skill-creator 適合用在哪些情境？
skill-creator 很適合用來建立以下類型的 Skill：
文件處理類
例如：
- 會議紀要整理
- 合約摘要
- 報告格式化
- WordPress 部落格文章產生
- SEO 文章檢查
- 論文格式整理
開發工作類
例如：
- Code Review
- 安全檢查
- API 文件產生
- Git commit message 規範
- Docker 部署檢查
- WordPress 錯誤排查
企業流程類
例如：
- 客服回覆 SOP
- 品牌語氣檢查
- 行銷企劃產生
- 業務提案格式
- 專案週報整理
個人自動化類
例如：
- 每週工作回顧
- 讀書筆記整理
- 投資研究筆記格式化
- 學習計畫產生
- 旅遊規劃模板
建立 Skill 時的實用建議
1. description 要寫清楚
description 不只是說明文字，它會影響 Claude 判斷什麼時候該使用這個 Skill。
不建議這樣寫：
description: 幫我整理資料
建議改成：
description: Use this skill when the user provides meeting transcripts and wants structured meeting minutes with decisions, discussion points, and action items.
越清楚，Claude 越容易正確觸發。
2. 輸出格式要固定
如果你想要表格，就直接指定表格欄位。
如果你想要 Markdown，就明確寫出標題層級。
如果你想要 JSON，就提供完整 schema。
例如：
## Output Format Return the result in Markdown with the following sections: # 會議紀要 ## 一、會議基本資訊 ## 二、討論重點 ## 三、決議事項 ## 四、待辦事項
3. 明確說明不要編造資料
這一點很重要，尤其是處理會議、合約、財務、法律或客戶資料時。
可以在 Skill 中加入：
## Accuracy Rules - Do not invent missing information. - If a field is not provided, write "未提供". - Preserve names, dates, numbers, and deadlines exactly as given.
4. 加入好範例與壞範例
Skill 裡面可以放 Examples，讓 Claude 更容易理解你要的品質。
例如：
## Examples Good: - Clear action item with owner and deadline. - Concise summary without unnecessary commentary. Bad: - Inventing a deadline that was not mentioned. - Mixing discussion points with final decisions.
常用指令整理
安裝 skill-creator
npx skills add https://github.com/anthropics/skills --skill skill-creator
使用 claude install 安裝
claude install anthropics/skills/skill-creator
呼叫 skill-creator
/skill-creator
從官方 GitHub 下載 skills 專案
git clone https://github.com/anthropics/skills.git
或直接下載 ZIP：
https://github.com/anthropics/skills/archive/refs/heads/main.zip
做好 Skill 後，如何移植到其他系統？
建立好 Skill 之後，不一定只能放在 Claude Code 裡使用。
如果 Skill 的設計夠清楚，也可以移植到其他 Agent 系統，例如 Hermes Agent、Codex，或是你自己架設的本地 AI Agent 平台。
不過要注意一件事：
Skill 的核心不是某一個平台的格式，而是裡面的工作流程、判斷規則、輸出格式、參考資料與可執行腳本。
也就是說，真正有價值的是這些內容：
SKILL.md references/ scripts/ assets/ examples/
只要把這些內容轉成目標 Agent 系統可以讀懂的格式，就可以完成移植。
Skill 移植的核心概念
一個 Skill 通常可以拆成五個部分：
1. 任務說明：這個 Skill 是做什麼的 2. 觸發條件：什麼情況下應該使用 3. 操作流程：執行任務時要照什麼步驟 4. 輸出格式：最後要產生什麼格式 5. 工具資源：是否需要腳本、範本、參考文件或 API
不同 Agent 系統的格式可能不同，但這五個部分通常都可以保留下來。
因此，移植 Skill 的重點不是「直接複製檔案」，而是把原本的 SKILL.md 改寫成目標系統的規則檔、角色設定、工具說明或 system prompt。
建議的 Skill 通用資料夾結構
為了方便未來移植，建議你在建立 Skill 時，就使用比較通用的結構：
my-skill/ ├── SKILL.md ├── README.md ├── references/ │ └── knowledge-base.md ├── examples/ │ ├── input-1.md │ └── output-1.md ├── scripts/ │ └── helper.py ├── assets/ │ └── template.md └── manifest.json
其中：
SKILL.md：給 Claude 或支援 Skill 的 Agent 使用README.md：給人類維護者閱讀references/：放背景知識、規則、範本examples/：放輸入與輸出範例scripts/：放可執行工具assets/：放模板、圖片、表格等資源manifest.json：給其他 Agent 系統讀取的設定檔
如果你未來要移植到 Hermes Agent 或 Codex，這種結構會比較容易轉換。
範例：建立一個通用 manifest.json
可以在 Skill 裡面額外放一個 manifest.json，用來描述這個 Skill 的基本資訊。
{
"name": "wordpress-seo-writer",
"version": "1.0.0",
"description": "Generate Traditional Chinese WordPress blog posts with SEO title, tags, meta description, and structured article format.",
"language": "zh-TW",
"entry": "SKILL.md",
"references": [
"references/seo-guidelines.md"
],
"examples": [
"examples/input-1.md",
"examples/output-1.md"
],
"tools": [
{
"name": "keyword_checker",
"type": "script",
"path": "scripts/keyword_checker.py"
}
]
}
這個檔案不一定是 Claude Code 必要的，但它很適合給自建 Agent 系統使用。
例如 Hermes Agent 可以讀取 manifest.json，知道這個 Skill 的名稱、用途、入口檔案、參考資料與可用工具。
移植到 Hermes Agent
如果你使用的是自建的 Hermes Agent，建議把 Skill 當成一個「Agent 能力模組」來管理。
可以設計成以下結構：
hermes-agent/ ├── agents/ │ └── writer-agent/ │ ├── system.md │ ├── tools.json │ └── skills/ │ └── wordpress-seo-writer/ │ ├── SKILL.md │ ├── manifest.json │ ├── references/ │ ├── examples/ │ └── scripts/
Hermes Agent 在執行任務時，可以做三件事：
1. 根據使用者輸入，判斷是否需要啟用某個 Skill 2. 讀取該 Skill 的 SKILL.md 與 references/ 3. 將 Skill 內容合併進 Agent 的 system prompt 或 task prompt
例如使用者輸入：
請幫我寫一篇 WordPress SEO 文章，主題是 skill-creator。
Hermes Agent 可以比對 Skill 的 description，找到 wordpress-seo-writer，然後載入：
skills/wordpress-seo-writer/SKILL.md skills/wordpress-seo-writer/references/seo-guidelines.md skills/wordpress-seo-writer/examples/output-1.md
接著再讓模型依照這些規則產生文章。
Hermes Agent 的 Skill 載入邏輯範例
如果是自己開發 Hermes Agent，可以用簡單的流程實作：
User Request
↓
Intent Router
↓
Skill Matcher
↓
Load SKILL.md
↓
Load references / examples / scripts
↓
Compose Agent Prompt
↓
Run Model
↓
Return Result
也可以設計一個簡單的 Skill Registry：
{
"skills": [
{
"name": "wordpress-seo-writer",
"description": "Write Traditional Chinese WordPress SEO articles.",
"path": "./skills/wordpress-seo-writer",
"trigger_keywords": [
"WordPress",
"SEO文章",
"部落格文章",
"中繼描述",
"標籤"
]
},
{
"name": "code-review-security",
"description": "Review code for security, maintainability, and deployment risks.",
"path": "./skills/code-review-security",
"trigger_keywords": [
"code review",
"安全檢查",
"漏洞",
"重構"
]
}
]
}
這樣 Hermes Agent 就可以根據關鍵字、語意比對或任務分類，自動決定要不要載入某個 Skill。
移植到 Codex
如果要移植到 Codex，建議分成兩層處理：
1. 專案層級規則：放進 AGENTS.md 2. 任務型 Skill：保留成獨立 Skill 資料夾
Codex 會讀取專案中的 AGENTS.md，因此可以把與專案相關的固定規則放在這裡，例如：
# AGENTS.md ## Project Rules - Use Traditional Chinese when writing user-facing documentation. - Do not modify database schema unless explicitly requested. - Before changing code, inspect the existing architecture. - Prefer small, reviewable changes. - When writing WordPress articles, use the wordpress-seo-writer skill.
而真正的 Skill 內容則可以保留在專案目錄中：
project/ ├── AGENTS.md ├── skills/ │ └── wordpress-seo-writer/ │ ├── SKILL.md │ ├── references/ │ ├── examples/ │ └── scripts/
這樣做的好處是：
AGENTS.md負責專案整體規則SKILL.md負責特定任務流程references/保存知識與格式scripts/保存可重複使用的工具
Codex 使用 Skill 的建議方式
如果 Skill 是用來處理開發工作，例如 Code Review、安全檢查、部署檢查，建議把 Skill 寫得更像工程 SOP。
例如：
# Code Review Security Skill Use this skill when reviewing code changes for security, maintainability, and deployment risks. ## Review Checklist 1. Authentication and authorization 2. Input validation 3. SQL injection risk 4. Secrets and environment variables 5. File upload handling 6. Error handling 7. Logging and privacy 8. Deployment risk ## Output Format Return the review in this format: # Code Review Report ## Summary ## Critical Issues ## Medium Issues ## Low Risk Suggestions ## Recommended Patch ## Test Plan
然後在 AGENTS.md 裡加入：
## Skills When the task involves security review, load: skills/code-review-security/SKILL.md
這樣 Codex 在處理程式碼任務時，就可以依照固定流程執行，而不是每次都靠臨時 prompt。
Claude Skill、Hermes Agent、Codex 的對應關係
| Skill 內容 | Claude Code | Hermes Agent | Codex |
|---|---|---|---|
| 任務說明 | SKILL.md description | manifest.json description | AGENTS.md 或 Skill description |
| 操作流程 | SKILL.md | system prompt / task prompt | AGENTS.md / Skill |
| 參考資料 | references/ | knowledge base / RAG | project docs / references/ |
| 腳本工具 | scripts/ | tools / function calling | scripts / shell tools |
| 輸出格式 | SKILL.md | response schema | AGENTS.md / task instruction |
| 測試案例 | examples/ | evaluation set | test prompts / eval cases |
移植時最容易出問題的地方
1. Skill 觸發條件不清楚
如果 description 寫得太模糊，Agent 不知道什麼時候該使用。
不建議：
幫我處理文章
建議：
當使用者要求撰寫 WordPress SEO 部落格文章，且需要標題、標籤、中繼描述與繁體中文內容時，使用此 Skill。
2. 原本依賴 Claude 的功能，其他系統沒有
有些 Skill 可能假設 Claude Code 可以讀檔、執行 script 或打包 .skill。
移植到其他系統時，要確認目標平台是否支援：
- 讀取本地檔案
- 執行 shell 指令
- 呼叫 Python 腳本
- 使用 MCP server
- 使用 function calling
- 存取 Git repo
- 存取外部 API
如果不支援，就要改成純文字流程，或另外做工具橋接。
3. references 太大，模型上下文放不下
如果參考文件很多，不建議一次全部塞進 prompt。
比較好的方式是：
1. 先用 Skill description 判斷要不要使用 2. 再根據任務讀取必要 references 3. 只載入與當前任務相關的段落
這樣可以避免上下文太長，也能提升回答品質。
4. 腳本路徑與執行環境不同
例如你在 Claude Code 裡用的是：
python scripts/check.py
但移植到 Hermes Agent 的 Docker 環境後，可能要改成：
python /app/skills/wordpress-seo-writer/scripts/check.py
因此建議在 manifest.json 中明確寫出腳本路徑、執行方式與依賴套件。
建議：把 Skill 設計成可攜式能力包
如果你一開始就希望 Skill 可以移植到 Claude Code、Hermes Agent、Codex 或其他 Agent 系統，建議遵守以下原則：
1. SKILL.md 不要寫死特定平台專用語法 2. 把平台相關設定放到 adapters/ 目錄 3. 把核心流程寫在 core.md 4. 把範例輸入輸出放到 examples/ 5. 把工具設定放到 manifest.json
可以設計成：
portable-skill/ ├── core.md ├── SKILL.md ├── manifest.json ├── adapters/ │ ├── claude-code.md │ ├── hermes-agent.md │ └── codex-agents.md ├── references/ ├── examples/ └── scripts/
其中：
core.md：保存跨平台共用的核心流程SKILL.md：給 Claude Code 使用manifest.json：給自建 Agent 系統使用adapters/claude-code.md：Claude Code 專用說明adapters/hermes-agent.md：Hermes Agent 專用說明adapters/codex-agents.md：Codex 專用說明
這樣同一個 Skill 就不會被綁死在單一平台上。
移植檢查清單
在把 Skill 移到其他 Agent 系統前，可以用這份清單檢查：
□ Skill 的用途是否明確？ □ description 是否能讓 Agent 判斷何時使用？ □ 輸入格式是否定義清楚？ □ 輸出格式是否固定？ □ 是否有 examples？ □ 是否有 references？ □ references 是否可以被目標系統讀取？ □ scripts 是否能在目標環境執行？ □ 是否需要 API key 或環境變數？ □ 是否有測試案例？ □ 是否有平台專用 adapter？ □ 是否避免把敏感資訊寫進 Skill？
Skill 應該被設計成 Agent 的可攜式 SOP
skill-creator 產生的 Skill，最好不要只當成 Claude Code 的專用檔案。
更好的做法，是把它設計成一個「可攜式 AI 工作流程」。
Claude Code 可以使用 SKILL.md。
Hermes Agent 可以使用 manifest.json、references/ 與自訂 router。
Codex 可以透過 AGENTS.md、專案規則與 Skill 資料夾來載入任務流程。
只要核心流程設計清楚，Skill 就可以成為跨 Agent 系統共用的能力包，讓同一套工作方法在不同 AI 工具之間延續使用。
近期留言