Agent Skills 完全入門 — 手把手從零打造專屬技能

廚師類比	Agent Skill 對應	說明
流程 + 配方	`skill.md`	元資訊（metadata）+ 執行指令
參考材料	`references/`	可被按需載入的補充文件
工具	`scripts/`	可執行腳本（呼叫外部 API）
特殊材料	`assets/`	圖片、Logo 等靜態資源

這四個元素打包成一個資料夾，就是一個完整的 Skill。

第二章：建立第一個 Skill

建立第一個 Skill：環境設置與 skill.md 結構

⏱ 00:01:12 – 00:05:49

00:01:12

2.1 所需工具

00:03:04

Cursor：作為編輯器和檔案管理介面
Claude Code：在 Cursor 的終端機內呼叫，claude 指令啟動

兩個工具的下載方式都在影片說明欄的資料頁面。

2.2 建立 Skill 資料夾結構

00:03:17

Skill 必須放在 Claude Code 規定的路徑下：

.claude/
└── skills/
    └── <你的-skill-名稱>/
        └── skill.md        ← 必填

步驟：

在專案根目錄建立 .claude/skills/ 資料夾
在裡面建立你的 Skill 資料夾（命名即為 Skill 名稱）
在資料夾內建立 skill.md

2.3 skill.md 的兩個區塊

00:04:36

---
name: qz-creative
description: 用於生成符合秋芝餐廳品牌調性的物料創意。當用戶說要做海報、優惠券等物料時觸發。
---

# 指令（Instructions）

你是秋芝輕食餐廳的品牌創意總監...
（具體的提示詞內容）

區塊	用途	AI 什麼時候讀取
`---` 包圍的 metadata	告訴 AI 這個 Skill 叫什麼、何時使用	每次對話都會讀取
metadata 以下的 instruction	具體執行指令（完整提示詞）	只有在決定觸發此 Skill 時才讀取

2.4 測試驗證

00:05:44

建立完成後，在 Claude Code 問「你有哪些 Skill？」，它會列出剛才建立的 qz-creative。接著說「幫我做一個春節促銷海報的創意」，它就會自動載入 Skill 並按格式輸出。

第三章：按需載入原理與 References

為什麼比提示詞強？按需載入原理 + References 進階拆分

⏱ 00:05:49 – 00:10:00

00:05:49

3.1 Skill vs 直接貼提示詞

00:06:01

很多人會問：Skill 不就是提示詞嗎？本質上確實是，但 Skill 的工程優勢在於按需載入（漸進式披露）：

正常對話中，AI 只讀取每個 Skill 的 metadata（兩行短短的說明）
只有當 AI 判斷「這次任務需要這個 Skill」，才會去載入完整的 instruction
所以不管你有幾十個 Skill，平時也不會浪費 Token

3.2 References：第二層按需載入

00:08:24

當 Skill 指令變得複雜（例如物料有十幾種類型，各有不同尺寸和規格），如果全部寫進 skill.md 會造成：

文件過長，AI 每次都要讀完整份
Token 浪費，還可能造成資訊干擾

解法：把不同情境的規格拆成獨立的 .md 檔，放進 references/ 資料夾：

skills/qz-creative/
├── skill.md                        ← 主指令（含載入指引）
└── references/
    ├── 實體物料規格.md              ← 餐盒、杯子、員工服裝
    └── 社交媒體物料規格.md          ← 公眾號封面、微博配圖

然後在 skill.md 的指令裡加上指引：

- 如果用戶要做實體物料 → 讀取 references/實體物料規格.md
- 如果要做社交媒體圖 → 讀取 references/社交媒體物料規格.md

第四章：Scripts 腳本與 Assets 資源

讓 Skill 直接生圖：Scripts 腳本 + Assets 品牌資源

⏱ 00:10:00 – 00:13:37

00:10:00

4.1 Scripts：執行腳本

00:10:16

scripts/ 資料夾放可執行腳本。在案例中，放了一個呼叫生圖 API 的短腳本：

skills/qz-creative/
├── skill.md
├── references/...
└── scripts/
    └── generate-image.py    ← 呼叫生圖 API

在 skill.md 的指令裡補充：

如果用戶要求直接生成圖片：
1. 將創意轉化為生圖提示詞
2. 執行 scripts/generate-image.py，傳入提示詞和 Logo 參考圖

腳本最大的優勢：AI 只執行腳本，不讀取腳本內容。無論腳本有幾千行程式碼，完全不佔用 Token。

4.2 Assets：品牌資源

00:11:21

assets/ 資料夾放靜態資源（圖片、字型等）。把 Logo 圖放進去後，在 skill.md 告訴 AI：

生圖時，把 assets/ 裡的 Logo 圖片一起傳給腳本作為參考圖。

這樣生成出來的圖片就會符合品牌規範、帶有正確 Logo。

4.3 完整形態示範

00:11:52

說「幫我做一張週六飲料免費的實體海報」，AI 的執行流程：

載入 skill.md 主指令
判斷是實體物料 → 讀取 references/實體物料規格.md
判斷需要生圖 → 將創意轉為提示詞
把提示詞 + Logo 圖傳給 scripts/generate-image.py
輸出符合品牌尺寸、配色、帶 Logo 的成品圖

一句話完成，從創意到成圖。

第五章：三層架構總覽

三層按需載入架構完整解說

⏱ 00:13:37 – 00:15:01

00:13:37

Skill 官方定義的「漸進式披露機制（Progressive Disclosure）」分三層：

層級	包含內容	何時載入
第一層：元資訊層	`skill.md` 的 metadata（name + description）	每次對話都載入，讓 AI 知道有哪些技能
第二層：指令層	`skill.md` 的完整 instruction	AI 決定要用這個 Skill 時才載入
第三層：資源層	`references/`、`scripts/`、`assets/`	AI 判斷任務需要時才按需載入；腳本只執行不讀取

這個設計讓你可以同時擁有幾十個 Skill，卻不會因此爆炸 Token 或降低回應品質——因為 AI 平時只看每個 Skill 兩行的摘要。

第六章：Skill 創建器與推薦應用

用 Skill 創建器快速上手 + 推薦必備 Skill

⏱ 00:15:01 – 00:19:19

00:15:01

6.1 QG Skill Creator：免手寫 Skill

00:15:09

影片中的秋芝餐廳案例並非手寫，而是用「QG Skill Creator」生成。這是作者基於社群流行的 Skill 創建器改良的互動版本。

使用方式：

下載 QG Skill Creator，放入 .claude/skills/ 資料夾
開啟 Claude Code，直接說「我想建立一個 Skill」或用斜線指令呼叫
AI 以選擇題的形式逐步追問需求（不需要懂技術）
確認方案後，AI 自動生成所有 Skill 檔案
自動跑測試範例驗證結果

6.2 推薦現成 Skill 資源

00:17:02

不用自己建，網路上已有大量現成 Skill 可直接下載。影片整理了集合網站和倉庫連結（詳見說明欄資料頁）。作者也打包了幾個普通人必備的 Skill：

Skill 類型	效果
PPT / 文件處理（XLS、PDF）	一句話把雜亂表格整理乾淨
前端設計（官方 frontend-design）	讓 Claude Code 生成的網頁品質大幅提升
動畫生成	一段提示詞做出演示動畫

6.3 最適合打造成 Skill 的場景

00:17:47

最有效的 Skill 來自你高頻執行、有明確標準的工作：

你的情況	可以建立的 Skill
上班族每週寫週報	AI 主動採訪你 → 自動輸出週報
老師每節課都要備課	給課題 → 輸出課件 + 習題 + PPT
需要幫文章配圖	給文章 → 按你的風格生成配圖
常常審合同	給合同 → 自動批閱並寫備注