如何逐步建立自訂 Claude Skill:完整實戰指南

在 AI 輔助工作的時代,掌握如何讓 AI 真正為你所用,已經成為專業人士的核心競爭力。Claude Skills 的出現,讓我們終於可以把重複性的專業工作流程「打包」起來,隨時調用、跨平台使用。這不只是寫一次提示詞那麼簡單,而是建立一個可以持續優化、反覆使用的知識體系。

如果你曾經為了每次都要重新解釋同樣的需求而感到疲憊,或是希望團隊成員都能使用統一的工作標準,那麼這篇指南正是為你準備的。讓我們一起深入了解如何建立真正實用的 Claude Skills。

什麼是 Claude Skills?

Claude Skills 本質上是一種可重複使用的工作流程封裝系統。你可以把它想像成一個專門的工具包,裡面包含了詳細的操作說明、參考資料和必要的程式碼。與傳統的一次性提示詞不同,Skills 可以在 Claude.ai、Claude Code 和 API 之間無縫切換使用。

這種設計最大的優勢在於「一次建立,到處使用」。當你在網頁版測試成功的 Skill,可以直接在開發環境中調用,或是透過 API 整合到你的應用程式中。這種統一性大幅降低了維護成本,也讓專業知識的傳承變得更加容易。

開始之前的準備工作

在動手建立 Skill 之前,你需要確保具備以下條件:

Claude Pro 或更高級方案:免費版目前不支援 Skills 功能
文字編輯器:VS Code、Sublime Text 或任何你習慣的編輯器都可以
基礎的 Markdown 和 YAML 知識:不需要精通,但要能看懂基本語法

如果你還不熟悉 Markdown,別擔心。它的語法非常直觀,用 # 表示標題、- 表示列表項目,就是這麼簡單。YAML 則是用來定義 Skill 的基本資訊,格式上更是一目了然。

第一步:在帳戶中啟用 Skills

首先,你需要在 Claude 中啟用 Skills 功能:

開啟 Claude 並進入設定
找到功能區塊
將 Skills 選項切換為啟用狀態

這個步驟完成後,你就可以開始上傳和使用自己建立的 Skills 了。記住,這個功能目前只對付費用戶開放,這也反映了 Anthropic 對這個功能的定位:它是為專業工作場景設計的生產力工具。

第二步:建立 Skill 資料夾結構

每個 Skill 都需要一個清晰的資料夾結構。最基本的架構如下:

my-custom-skill/
├── SKILL.md (必要)
└── resources/ (選擇性)
    ├── templates/
    └── examples/

重要提醒:主檔案必須命名為 SKILL.md,而且要全部大寫。這是系統識別 Skill 的關鍵。資料夾名稱則應該清楚描述 Skill 的用途,例如 brand-voice-guide 或 meeting-notes-formatter。

我在實際使用中發現,即使是簡單的 Skill,也建議建立 resources 資料夾。隨著使用時間增長,你很可能會想要加入範例或模板,預先準備好資料夾結構可以讓後續擴充更加順暢。

第三步:撰寫 SKILL.md 檔案

每個 Skill 的核心是 SKILL.md 檔案,它由兩部分組成:YAML 前置資料和 Markdown 指令。

必要的前置資料欄位

---
name: "內容風格指南"
description: "為部落格文章和行銷內容套用一致的品牌語調與格式規則;適用於建立對外的書面素材時使用。"
---

關鍵要點:

name:易於理解的標題,最多 64 個字元
description:清楚說明功能與使用時機,最多 200 個字元

description 的重要性常被低估。Claude 會根據這段描述判斷何時自動啟用你的 Skill,所以描述越精確,自動觸發的準確度就越高。我建議在描述中明確寫出「當...時使用」這類條件句,幫助系統更好地理解應用場景。

選擇性的前置資料欄位

---
name: "財務報告產生器"
description: "建立標準化的季度財務報告,包含圖表與分析。"
version: "1.0.0"
dependencies: "python>=3.8, pandas>=1.5.0"
---

版本號的加入讓你可以追蹤 Skill 的演進,這在團隊協作時特別有用。當你對 Skill 進行重大更新時,更新版本號可以讓使用者清楚知道有哪些改變。

第四步:加入指令與內容

在前置資料之後,就是 Skill 的主要內容。這裡你可以用 Markdown 格式撰寫詳細的指令:

---
name: "會議記錄格式化工具"
description: "將會議筆記結構化,清楚區分決議事項、行動項目與後續步驟。"
version: "1.0.0"
---

### 會議記錄格式化工具

#### 概述
這個 Skill 將原始的會議記錄轉換為結構化格式,包含清晰的決議、行動項目和後續追蹤。

#### 使用時機
適用於以下情況:
- 轉錄會議錄音
- 整理非結構化的會議筆記
- 建立可分享的會議摘要

#### 輸出格式

##### 會議摘要
- 日期與出席者
- 討論的主要議題
- 達成的關鍵決議

##### 行動項目
每項格式如下:
- [ ] 任務描述 (@負責人, 截止日期)

##### 決議事項
- 列出所有決議及其脈絡

##### 後續步驟
- 已排定的追蹤事項
- 待處理項目

#### 範例

**輸入:** "我們討論了 Q4 的產品發布。Sarah 會在 11 月 15 日前處理行銷事宜。團隊同意將發布日期推遲到 12 月 1 日。"

**輸出:**
##### 決議事項
- 產品發布日期延至 12 月 1 日

##### 行動項目
- [ ] 處理行銷素材 (@Sarah, 11 月 15 日)

##### 後續步驟
- 檢視行銷素材 (11 月 16 日)

第五步:加入參考資源(選擇性)

對於複雜的 AI 工具應用,你可以加入額外的參考檔案:

my-skill/
├── SKILL.md
├── REFERENCE.md
├── templates/
│   └── report-template.md
└── scripts/
    └── data-processor.py

在 SKILL.md 中引用這些資源:

#### 額外資源
詳細指南請參閱 REFERENCE.md。
報告格式請查看 templates/ 資料夾。

這種模組化的設計讓你可以將複雜的 Skill 拆分成易於管理的小塊。當團隊成員需要深入了解某個特定環節時,可以直接參考對應的文件,而不需要在一個超長的檔案中翻找。

第六步:加入可執行程式碼(進階)

Skills 可以包含 Python、JavaScript 或 bash 指令碼:

---
name: "資料分析工具"
description: "分析 CSV 檔案並產生統計摘要。"
dependencies: "python>=3.8, pandas>=1.5.0, matplotlib>=3.5.0"
---

### 資料分析工具

#### 程式碼
```python
import pandas as pd
import matplotlib.pyplot as plt

def analyze_data(file_path):
    df = pd.read_csv(file_path)
    return df.describe()

使用時機

用於分析試算表資料或產生統計報告。


**注意**: Claude 可以自動從 PyPI (Python) 和 npm (JavaScript) 安裝套件,這讓 [開發工具](https://tenten.co/learning/100-web-developer-tool-resources/)的整合變得異常簡單。

在我的實際經驗中,即使是簡單的資料處理任務,有了程式碼的支援也能大幅提升效率。例如,你可以建立一個專門處理客戶資料的 Skill,自動完成清洗、分析和視覺化的全流程。

---

### 第七步:打包你的 Skill

完成後,將資料夾壓縮成 ZIP 檔案:

**正確的結構**:

my-skill.zip
└── my-skill/
├── SKILL.md
└── resources/


**錯誤的結構**:

my-skill.zip
├── SKILL.md
└── resources/


ZIP 檔案必須包含 Skill 資料夾作為根目錄,而不是直接包含檔案。這是一個常見的錯誤點,請特別注意。

---

### 第八步:上傳你的 Skill

#### 方法一:網頁介面

1. 前往 Claude 設定 > 功能
2. 將 ZIP 檔案拖放到上傳區域
3. Claude 會驗證並安裝

#### 方法二:使用內建的 Skill 建立工具

直接詢問 Claude:"幫我建立一個用於[你的任務]的 skill",skill-creator Skill 會互動式地引導你完成整個過程。

我個人偏好第一種方法,因為它讓你對 Skill 的結構有完整的掌控。不過對於快速原型製作,第二種方法確實能節省不少時間。

---

### 第九步:測試你的 Skill

#### 初始測試

1. 在設定 > 功能中**啟用 Skill**
2. **嘗試觸發提示**,看看是否符合描述
3. **檢查 Claude 的思考過程**,確認 Skill 有被載入
4. **調整描述**,如果 Claude 沒有在預期時機使用

#### 測試技巧

- 在提示中重複你的 Skill 名稱:"使用會議記錄格式化工具來整理這些筆記..."
- 明確說明任務以確保正確觸發
- 檢視 Claude 的延伸思考,查看哪些 Skills 被啟用

測試階段最容易被忽略,但它其實是確保 Skill 品質的關鍵。我建議準備 3-5 個不同的測試案例,涵蓋常見情境和邊緣案例。這樣可以更全面地評估 Skill 的實用性。

---

### 第十步:精進與版本管理

隨著 Skill 的改進:

- **更新版本號** (1.0.0 → 1.1.0)
- **測試邊緣案例**再廣泛部署
- **保持描述具體**而非籠統
- **記錄變更**供團隊成員參考

版本管理聽起來很正式,但實際上可以很簡單。我的習慣是在每次重大更新時,在 SKILL.md 的頂部加入一個「更新日誌」區塊,簡短記錄改了什麼、為什麼改。這不僅幫助團隊了解變化,也讓未來的自己能快速回想當時的決策邏輯。

---

### 打造優秀 Skills 的最佳實踐

#### 1. 極度具體化

**不好的例子**: "用於行銷"  
**好的例子**: "用於建立針對年預算超過 10 萬美元的企業技術長的 B2B SaaS 電子郵件活動"

specificity(具體性)是讓 AI 準確理解你意圖的關鍵。當描述越精確,Claude 就越能在正確的時機啟用你的 Skill。這也是為什麼我建議在撰寫 description 時,多花 5 分鐘思考真實的使用場景。

#### 2. 從簡單開始,再擴充

先從基本的 Markdown 指令開始,之後再加入複雜的指令碼。這種漸進式的方法讓你可以在每個階段驗證功能,避免一次性建立太複雜的系統而難以除錯。

#### 3. 專注單一工作流程

為不同任務建立獨立的 Skills,而非一個萬能的 mega-Skill。多個專注的 Skills 組合起來效果更好。這個原則類似於軟體開發中的「單一職責原則」,每個 Skill 只做一件事,但把它做好。

#### 4. 提供範例

展示給 Claude 什麼是好的輸出:

```markdown
#### 範例

**好的範例**: 清楚、具體的行動項目與負責人
**不好的範例**: 模糊的「追蹤那件事」筆記

範例的價值在於它提供了具體的參照點。當 Claude 看到範例時,它能更準確地理解你期望的輸出品質和格式。我建議至少提供一個好的範例和一個需要避免的反例。

5. 運用 Skill 堆疊

Claude 可以自動結合多個 Skills。建立:

品牌語調 Skill
資料分析 Skill
報告結構 Skill

然後詢問:"分析 Q4 資料並建立符合品牌調性的主管報告" — Claude 會同時使用這三個 Skills!

這種組合能力是 Skills 系統最強大的特色之一。你不需要為每個可能的任務組合都建立一個新 Skill,而是讓基礎 Skills 自由組合,創造出無限的可能性。

常見使用案例

應用領域	具體案例
商業應用	品牌指南執行、報告模板、財務模型、會議筆記格式化、銷售流程自動化
開發場景	程式碼審查標準、文件產生、API 整合模式、測試框架
內容創作	風格指南應用、SEO 優化、內容結構模板、社群媒體格式化

這個表格只是冰山一角。實際上,任何需要重複執行且有明確規則的任務,都可以考慮建立對應的 Skill。關鍵是找到你日常工作中最耗時、最需要一致性的環節,那就是最適合建立 Skill 的地方。

安全考量

在建立包含程式碼的 Skills 時:

⚠️ 絕不硬編碼 API 金鑰或密碼
👀 啟用前先檢視下載的 Skills
🔒 使用 MCP 連接外部服務
✅ 先在安全環境中測試

安全性永遠不能妥協。即使是在測試階段,也要養成良好的安全習慣。我建議建立一個專門的測試環境,使用假資料進行驗證,確認沒問題後再在生產環境中使用。

快速疑難排解

Skill 沒有觸發?

讓描述更具體
在提示中明確提到 Skill 名稱
確認在設定中已啟用

遇到錯誤?

驗證 YAML 前置資料語法(正確的破折號、引號)
檢查 ZIP 結構(資料夾應為根目錄)
確保 SKILL.md 檔名全部大寫

需要更多協助?

查看 Anthropic 的範例 Skills: github.com/anthropics/skills
檢視官方文件: docs.claude.com

完整範例:即用型簡單 Skill

以下是一個可以直接使用的範例:

---
name: "主管摘要產生器"
description: "從長篇文件建立簡潔的主管摘要;適用於為領導階層濃縮報告或文章時使用。"
version: "1.0.0"
---

### 主管摘要產生器

#### 目的
將冗長的文件轉換為適合忙碌領導者的摘要,3 分鐘內可讀完。

#### 輸出格式
##### 關鍵要點 (3-5 個重點)
- 只列最關鍵的洞察

##### 建議事項 (2-3 項)
- 可執行的後續步驟,標註優先順序

##### 財務影響(如適用)
- 營收/成本影響
- ROI 或時程

##### 風險評估
- 前 2 項風險與因應措施

#### 語調指南
- 直接且有信心
- 盡可能以資料支持
- 行動導向的語言
- 避免術語或技術細節

#### 使用時機
- 董事會簡報
- 投資人更新
- 主管簡報
- 利害關係人報告

將這個儲存為資料夾中的 SKILL.md,壓縮後上傳即可!

讓 AI 成為你的專業夥伴

建立 Claude Skills 的過程,其實就是將你的專業知識系統化、模組化的過程。透過 Skills,你不只是在使用 AI 編碼工具,更是在建立一個可以不斷學習、持續優化的智慧系統。

從簡單的指令開始,徹底測試,並根據實際使用情況持續迭代。記住,Skill 的觸發描述和範例越具體,Claude 就越能在你需要的時候精準地應用它們。這種「一次建立,隨處使用」的工作方式,正在改變我們與 AI 協作的模式。

開始你的數位轉型之旅

在 Tenten,我們深知 AI 工具的導入不僅僅是技術問題,更是組織流程與思維方式的革新。無論你是想要建立專屬的 AI 工作流程、優化團隊協作效率,或是尋求全方位的數位轉型解決方案,我們都能提供專業的諮詢與技術支援。準備好開始了嗎?立即預約諮詢,讓 Tenten 成為你數位轉型路上的最佳夥伴。

I'm a Full Stack Developer with expertise in building modern web applications that fast, secure, and scalable. Crafting seamless user experiences with a passion for headless CMS, Vercel and Cloudflare