Claude Code Skills：安裝現成技能與撰寫自訂指令

Claude Code Skills 工作原理

Claude Code 本身已經很強，但它的強大之處在於可以根據你的工作流做延伸。Skills 是這個擴充機制——把常用流程、寫作風格、審查標準包成可重複使用的指令模組，用 /skill-name 在任何對話中呼叫。

Skills 是什麼

Skills 是存放在 .agents/skills/ 目錄的 Markdown 檔案。每個 Skill 就是一份說明文件，告訴 Claude Code「當你被這個 Skill 呼叫時，要做什麼、要遵守什麼規則」。

這和一般的系統提示不同。Skill 是模組化的：你可以安裝社群分享的 Skill、在不同專案共用，或自己寫一個只屬於這個專案的 Skill。

常見用途： - 程式碼審查標準（/code-review） - commit message 格式規範（/commit） - 前端設計規範（/frontend-design） - SEO 審查流程（/seo-audit） - 專案特定的部署流程（/deploy）

安裝現成 Skills

社群有許多現成的 Skills 可以直接安裝。

安裝指令

npx skills add <github-url> --skill <skill-name>

範例：安裝前端設計 Skill

npx skills add https://github.com/anthropics/skills --skill frontend-design

範例：安裝 SEO 審查 Skill

npx skills add https://github.com/coreyhaines31/marketingskills --skill seo-audit

安裝位置

Skills 預設安裝在專案層級（.agents/skills/），只對當前專案有效。

如果想讓所有專案都能用，安裝到全域：

npx skills add <url> --skill <name> --global

確認安裝

安裝後在 Claude Code 裡輸入 /，就能看到所有可用的 Skills 列表。

使用 Skills

安裝後，在 Claude Code 的對話中直接輸入 /skill-name 即可：

/code-review

Claude Code 會讀取這個 Skill 的說明，按照 Skill 定義的流程執行。

有些 Skill 可以加上描述：

/frontend-design 幫我設計一個登入頁

撰寫自訂 Skill

現成的 Skills 不一定符合你的需求。自己寫一個才能真正對應你的工作流。

Skill 檔案結構

在專案的 .agents/skills/ 目錄新增一個 Markdown 檔案：

.agents/
└── skills/
    └── my-skill.md

Skill 檔案格式

---
name: my-skill
description: 說明這個 Skill 做什麼（一行）
---

# My Skill 的說明

當這個 Skill 被呼叫時，Claude Code 會讀取這份文件並按照說明執行。

## 執行步驟

1. 檢查 XXX
2. 確認 YYY
3. 輸出 ZZZ 格式

## 規則

- 規則一
- 規則二

實際範例：程式碼審查 Skill

---
name: code-review
description: 按照專案標準審查 git diff 的程式碼變更
---

# Code Review 標準

審查目前的 git 變更。

## 審查重點

1. **功能正確性** — 邏輯有沒有明顯錯誤
2. **安全性** — SQL injection、XSS、敏感資料外洩
3. **效能** — N+1 查詢、不必要的迴圈
4. **可讀性** — 命名清楚、邏輯不過度複雜

## 輸出格式

用表格列出問題，欄位：檔案 / 行號 / 嚴重程度（高/中/低）/ 說明 / 建議修法。

嚴重程度：
- 高：安全問題、會 crash 的 bug
- 中：邏輯錯誤、效能問題
- 低：可讀性、風格問題

實際範例：部落格文章寫作 Skill

---
name: blog-post
description: 按照 Dairny Lab 風格撰寫技術文章
---

# Dairny Lab 文章規範

## 風格

- 繁體中文，台灣用詞
- 直接進重點，不用「當然！」開場
- 技術術語保留英文（Docker、NAS 不翻譯）
- 每個概念配實際步驟，不只說原理

## 結構

1. 開頭說明「這篇解決什麼問題」
2. 核心概念用 H2 分節
3. 步驟用數字清單
4. 結尾有延伸閱讀

## 長度

一般教學文：1,500–3,000 字。太短說不清楚，太長讀者跑掉。

Skills vs CLAUDE.md

兩者都能給 Claude Code 持久的上下文，但用途不同：

	Skills	CLAUDE.md
用途	特定任務的執行流程	專案全局說明
觸發方式	手動呼叫 `/skill-name`	每次對話自動載入
可重用	可跨專案安裝	只在當前專案
適合放	審查標準、部署步驟、寫作規範	架構說明、技術棧、協作偏好

簡單說：CLAUDE.md 是背景知識，Skills 是工具。

常見問題

Q：Skills 和一般的 / 指令（如 /help、/clear）有什麼不同？ /help、/clear 是 Claude Code 的內建指令，Skills 是你自己定義的。兩者都用 / 呼叫，但 Skills 是可以自訂和安裝的。

Q：Skill 可以呼叫其他 Skill 嗎？ 可以。在 Skill 文件裡說明「執行完後呼叫 /other-skill」，Claude Code 會按順序執行。

Q：如果同名的 Skill 同時存在全域和專案層級，哪個優先？ 專案層級優先，讓你可以針對特定專案覆蓋全域預設值。

小結

Skills 的核心價值是把重複的工作流編碼化： - 安裝社群 Skill：npx skills add <url> --skill <name> - 使用：/skill-name - 自訂：在 .agents/skills/ 寫 Markdown 文件

第一個值得自訂的 Skill，通常是你最常要求 Claude Code 做的那件事。

🔗 延伸閱讀

這篇有幫助嗎？ 常用流程包成 Skill，/skill-name 一鍵執行。

—