Claude Code Skills 安裝指南

// 01

什麼是 Skill？

Skill 讓你可以教 Claude 做特定的事，例如自訂提交格式、自動部署、產生文件。

一個 Markdown 檔案

本質上就是一個 SKILL.md 檔案，放到對的資料夾就自動生效，不需要任何安裝程序。

斜線指令觸發

安裝後可以用 /skill-name 直接呼叫，或讓 Claude 根據對話內容自動判斷是否載入。

CLI 專屬功能

Skills 只屬於 Claude Code CLI（終端機版本），不影響也不共用 claude.ai 網頁版。

// SKILL.md 基本結構

---
name: my-skill
description: 這個 Skill 做什麼，以及什麼時候使用它
---

## 說明

在這裡寫給 Claude 的指示...

// 02

兩種範圍

Skill 分為「全域」和「專案」兩種範圍，概念與 CLAUDE.md 的分層設計一致。

全域（個人）推薦

~/.claude/skills/<skill-name>/SKILL.md

你所有的專案都可以使用這個 Skill，適合放個人習慣的通用工具。

適合放

/commit /review /explain

專案

./.claude/skills/<skill-name>/SKILL.md

只有這個專案目錄才能使用，適合放該專案特有的指令。

適合放

/deploy-staging /run-tests

同名 Skill 的優先順序

Enterprise 管理 > 個人全域 > 專案

// 03

五種安裝方式

選一種最適合你的情境就好。

1

GitHub Repo 連結

最方便

直接把 GitHub URL 貼給 Claude，Claude 會自動 Clone 並安裝。

// 你說：

「https://github.com/someone/my-skill 幫我安裝這個 Skill」

// Claude 執行：

git clone https://github.com/someone/my-skill \
  ~/.claude/skills/my-skill

2

提供 ZIP 檔案路徑

把 ZIP 下載到本地後，把路徑告訴 Claude。

// 你說：

「ZIP 在 ~/Downloads/my-skill.zip，幫我安裝」

// Claude 執行：

unzip ~/Downloads/my-skill.zip -d ~/.claude/skills/

3

手動 Clone 再複製

適合只需要 Repo 中某個 Skill 的情況。

# 1. Clone 到暫存位置
git clone https://github.com/someone/repo ~/Downloads/repo

# 2. 複製需要的 Skill 資料夾
cp -r ~/Downloads/repo/my-skill ~/.claude/skills/

4

直接貼上 SKILL.md 內容

如果只有單一 SKILL.md 的內容（例如從文章複製），貼給 Claude，由 Claude 幫你建立檔案。

// 你說：「幫我建立這個 Skill：」然後貼上 SKILL.md 內容

5

手動建立（自己寫 Skill）

從頭自己撰寫，完全客製化。

# 建立資料夾
mkdir -p ~/.claude/skills/my-skill

# 建立 SKILL.md（內容如下）

---
name: my-skill
description: 這個 Skill 做什麼，以及什麼時候使用它
---

## 說明

在這裡寫給 Claude 的指示...

確認安裝成功

安裝後在 Claude Code 中執行以下指令，在 Skills 區塊確認是否出現：

/context

/my-skill

// 04

Frontmatter 設定參考

SKILL.md 最上方的設定區塊，控制 Skill 的行為。

欄位	說明	範例
`name`	Skill 名稱，也是 `/斜線指令` 的名字	`my-skill`
`description`	描述用途（Claude 靠這個判斷何時自動觸發）	`Helps with commit messages`
`disable-model-invocation`	設為 `true` 後只允許手動呼叫，Claude 不會自動觸發	`true`
`allowed-tools`	限制 Skill 可以使用哪些工具	`Read, Grep, Bash`
`argument-hint`	呼叫時的參數提示（顯示在自動補全）	`[filename]`
`user-invocable`	設為 `false` 則不出現在 `/` 選單，只能 Claude 自動觸發	`false`

Claude Code Skills 完整指南