安裝 Claude Skill 並不存在一個“到處都能用”的萬能命令。正確方法取決於你使用的是 Claude 網頁版或桌面聊天應用、Claude Code、外掛市場，還是第三方跨 Agent 安裝器。本指南會把這些路徑徹底分開，提供經過來源核驗的命令，並說明安裝前如何稽核一個 Skill。
最後核驗：2026 年 7 月 16 日。 產品選單和 CLI 變化很快。本文命令已對照文末列出的 Anthropic、Agent Skills、Vercel Labs 與 GitHub 官方資料檢查。
快速答案：先選擇正確的 Claude Skill 安裝方式
複製任何命令前，先看這張表。
| 你的使用環境 | 推薦起點 | Skill 的位置 |
|---|---|---|
| Claude.ai 或 Claude Desktop 聊天應用 | 將完整 Skill 資料夾打成 ZIP 後上傳 | Claude 帳號的 Customize > Skills |
| Claude Code，希望所有專案可用 | 個人 Skill | ~/.claude/skills/<skill-name>/SKILL.md |
| Claude Code，只供一個倉庫使用 | 專案 Skill | .claude/skills/<skill-name>/SKILL.md |
| 以可維護擴充套件包形式分發 Claude Code 能力 | Plugin Marketplace | Claude 外掛快取與所選作用域 |
| 同時使用 Claude Code、Codex、Cursor 等 | npx skills add 或 gh skill install |
各 Agent 的專案或使用者目錄 |
| 希望最大程度稽核與控制版本 | 手動從 GitHub 複製或克隆 | 由你檢查並放置的目錄 |
Anthropic 當前沒有一個可以安裝任意倉庫 slug 的萬能 Skill 命令。特別要注意：claude install 用於安裝或遷移 Claude Code 本體，不是通用 Skill 安裝器。如果某個頁面讓你執行 claude install owner-repo、claude skills install <slug> 或 claude skill add，卻沒有連結到特定工具的當前文件，它很可能混淆了產品或複製了過時命令。
安裝前先確認：你用的是哪一種 Claude
“Claude”現在包含多個使用介面，它們的儲存方式和安全模型並不相同。
Claude.ai 與 Claude Desktop 聊天應用
普通 Claude 聊天體驗通過 Customize > Skills 管理 Skills。自定義 Skill 需要以包含完整 Skill 資料夾的 ZIP 包上傳，並在介面中啟用或停用。Free、Pro、Max 使用者需要開啟 Code execution and file creation；Team 和 Enterprise 還可能受組織設定控制。
這裡不需要把檔案複製到 ~/.claude/skills。這個本地路徑屬於 Claude Code。
Claude Code CLI 與 Claude Code Desktop
Claude Code 會從個人目錄、專案目錄發現本地 Skills，也可以通過外掛獲得 Skills。本地 Skill 是一個資料夾，必需入口檔案必須準確命名為 SKILL.md。Claude 先載入名稱和描述用於發現，在任務相關或使用者明確呼叫時再讀取完整說明。
Claude Code Desktop 是 Claude Code 專案的圖形介面，可以使用同一專案的 Skills 和已安裝外掛。它不能和普通 Claude Desktop 聊天應用混為一談；後者通過帳號介面上傳自定義 Skill。
Claude API
Claude API 可以通過程式碼執行環境使用預構建或自定義 Skills，但那屬於 API 上傳與容器工作流，不是本地安裝。本指南聚焦普通使用者和開發者安裝；API 使用者應使用 Anthropic 當前的 Skills API 文件，不能照搬 Claude Code 路徑。
Skill、Plugin、MCP Server 與專案說明不是同一件事
| 擴充套件方式 | 主要作用 | 是否可能包含可執行行為 |
|---|---|---|
| Skill | 按需載入的可複用指令、領域知識和工作流 | 可以，Skill 可帶指令碼並指導 Claude 使用工具 |
| Plugin | 可分發的 Claude Code 擴充套件包，可包含 Skills、Agents、Hooks、MCP、LSP | 可以，應視為高信任軟體 |
| MCP Server | 讓 Claude 訪問外部工具或資料 | 可以，以服務或程序方式執行 |
| CLAUDE.md | 廣泛載入的專案常駐上下文 | 會影響工具使用，但不是可安裝 Skill 包 |
因此，Skill 不一定只是“無害的 Markdown 提示詞”。開放的 Agent Skills 規範 允許在 SKILL.md 旁附帶指令碼、參考資料和資源。
方法一：向 Claude.ai 或 Claude Desktop 上傳自定義 Skill
這是不使用終端的使用者最簡單的路徑。
第一步：打包前先檢查 Skill
開啟下載的資料夾。它至少應包含可讀的 SKILL.md，其中有 YAML Frontmatter 與正文指令。完整 Skill 還可能包含 scripts/、references/、assets/、模板或示例。上傳前逐項檢視，不要因為 ZIP 來自某個目錄網站就預設安全。
基礎結構如下：
my-skill/
├── SKILL.md
├── scripts/ # 可選
├── references/ # 可選
└── assets/ # 可選
Frontmatter 至少要標識 Skill，並說明什麼時候使用：
---
name: my-skill
description: 執行某個明確工作流。當用戶要求……時使用。
---
第二步：正確建立 ZIP
壓縮完整的 my-skill 資料夾，不要把包含多個無關倉庫的上層目錄一起打包。保持支援檔案與 SKILL.md 的相對路徑不變。不要把金鑰、環境檔案、本地快取或私人文件放進壓縮包。
第三步：上傳並啟用
- 開啟 Claude；如果你的套餐要求，先啟用 Code execution and file creation。
- 進入 Customize > Skills。
- 點選加號，依次選擇 Create skill 和 Upload a skill。
- 選擇 ZIP 檔案。
- 如果出現校驗錯誤，閱讀錯誤內容，不要盲目反覆打包。
- Skill 出現在列表後，確認開關已經啟用。
Anthropic 在 Use skills in Claude 中記錄了這套流程。
第四步：驗證、更新或刪除
先點名讓 Claude 在無風險樣例上使用該 Skill，再發送一條應該自然匹配描述的請求。檢查輸出是否遵循承諾的工作流，而不只是生成一段看似合理的普通回答。
更新個人上傳 Skill 時，應先稽核新版本，再按當前 Claude 介面重新上傳。暫時不用可以關閉開關；完全刪除則開啟 Skill 詳情，通過選單選擇 Delete。Team 和 Enterprise 管理員可以為組織配置 Skills；共享 Skill 會受組織策略控制，接收者可能自動獲得更新。
方法二：在 Claude Code 中手動安裝 Skill
手動安裝透明、不依賴第三方包管理器，適合希望檢查每個檔案並完全控制存放位置的使用者。
選擇個人作用域或專案作用域
個人 Skill 在所有專案中可用：
~/.claude/skills/my-skill/SKILL.md
專案 Skill 只對一個倉庫生效，並可提交給團隊：
.claude/skills/my-skill/SKILL.md
個人偏好和跨專案工作流放在個人作用域；倉庫專用的構建、測試、審查、釋出流程放在專案作用域並納入版本控制。兩種位置都不應儲存組織金鑰。
從 GitHub 複製經過稽核的 Skill
先把來源克隆或下載到臨時位置，檢查後再放入 Claude 的發現路徑：
git clone https://github.com/OWNER/REPOSITORY.git /tmp/review-skill
find /tmp/review-skill -maxdepth 3 -type f
確認準確的 Skill 目錄並稽核內容後，複製到目標作用域：
mkdir -p ~/.claude/skills/my-skill
cp -R /tmp/review-skill/path/to/my-skill/. ~/.claude/skills/my-skill/
專案作用域則把目標改為 .claude/skills/my-skill/。如果指令引用指令碼、模板或其他資源，必須複製整個 Skill 資料夾，而不是隻複製 SKILL.md。
驗證手動安裝
先檢查準確檔名和路徑：
test -f ~/.claude/skills/my-skill/SKILL.md && echo "Skill entry point found"
在 Claude Code 中，如果 Skill 允許使用者呼叫，可直接輸入 /my-skill；也可以提出與 description 高度匹配的請求。Claude Code 會監控已經存在的 Skills 目錄，所以在其中新增或修改 Skill 通常可在當前會話生效。如果啟動會話時頂層 Skills 目錄尚不存在，首次建立後可能需要重啟。Plugin 元件有單獨的重新載入規則。
權威路徑、優先順序和即時檢測行為見 Extend Claude with skills。
方法三：使用 npx skills add 安裝
Vercel Labs skills CLI 是面向 Agent Skills 生態的第三方開源安裝器，支援 Claude Code 以及許多其他 Agent。它不是 Anthropic 命令。
因為 npx 會下載並執行 npm 包，所以本機需要 Node.js 與 npm。面對陌生倉庫，先列出其中的 Skills：
npx skills add vercel-labs/agent-skills --list
互動式安裝倉庫中的 Skill：
npx skills add vercel-labs/agent-skills
只為 Claude Code 安裝一個指定 Skill：
npx skills add vercel-labs/agent-skills --skill frontend-design --agent claude-code
只有在需要跨專案的使用者作用域時才加 --global 或 -g。專案作用域更適合團隊工作流，因為配置與倉庫繫結。CLI 支援複製或符號連結：符號連結便於維護單一副本，複製則更易隔離和稽核。
常用生命週期命令：
npx skills list
npx skills find typescript
npx skills update
npx skills remove frontend-design
首次從陌生來源安裝時不要使用 --yes。跳過所有確認雖然更快，卻也失去了檢查 Skill、目標 Agent 和作用域的機會。還要記住：執行 npx 本身就在本機執行包程式碼，使用前應核對 npm 包身份與程式碼倉庫。
方法四：使用 GitHub CLI gh skill install
GitHub CLI 現在提供面向 Agent Skills 的 GitHub 官方命令。來源是 GitHub 倉庫、且你希望跟蹤來源或鎖定 Git 版本時，它很合適。它支援 Claude Code，但預設值可能指向其他 Agent，因此應明確指定目標。
在使用者作用域為 Claude Code 安裝指定 Skill：
gh skill install OWNER/REPOSITORY SKILL_NAME --agent claude-code --scope user
不寫 --scope user 時使用專案作用域。只有稽核完整倉庫後才使用 --all。需要可復現安裝時，鎖定 Tag 或 Commit：
gh skill install OWNER/REPOSITORY SKILL_NAME --agent claude-code --scope project --pin COMMIT_OR_TAG
該命令會注入來源追蹤後設資料，讓 gh skill update 能發現上游變化。來源後設資料有助於審計，但更新仍需檢查：接受新版指令或指令碼前先比較差異。
當前語法與支援的 Agent 見 GitHub CLI gh skill install 手冊。
方法五：通過 Claude Plugin Marketplace 安裝 Skills
當 Claude Code 擴充套件不只包含一個 Skill 時，Plugin 是原生分發方式。一個 Plugin 可以同時包含多個 Skills、Agents、Hooks、MCP Server、LSP 配置等可執行元件。
當前 Claude Code 已內建 Anthropic 官方 Marketplace。執行 /plugin，在 Discover 中瀏覽並檢查外掛，然後選擇作用域。直接安裝示例：
/plugin install github@claude-plugins-official
Anthropic 公開 Skills 倉庫提供以下 Marketplace 安裝方式：
/plugin marketplace add anthropics/skills
/plugin install example-skills@anthropic-agent-skills
會話中安裝或修改外掛後，重新載入：
/reload-plugins
Plugin Skills 使用名稱空間，例如 /plugin-name:skill-name。通過 Installed 標籤頁或官方命令啟用、停用、解除安裝外掛。官方 Marketplace 可能自動更新；第三方 Marketplace 通常需要單獨作出信任與更新決定。
新增 Marketplace 不等於自動安裝其中全部外掛，但 Marketplace 與外掛本身仍是高信任輸入。Anthropic 明確提醒，外掛可能以當前使用者許可權執行任意程式碼。應檢查釋出者、原始碼、Manifest、MCP、Hooks 與依賴。詳見 Discover and install prebuilt plugins。
Claude Skill 各種安裝方式對比
| 方法 | 最適合 | 更新與刪除 | 主要代價 |
|---|---|---|---|
| Claude ZIP 上傳 | Claude.ai 與普通 Claude Desktop 使用者 | 在 Customize > Skills 管理 | 簡單，但不是本地 Git 工作流 |
| Claude Code 手動目錄 | 最大透明度與專案控制 | 手動複製、Git Diff 或刪除目錄 | 版本需要自己維護 |
npx skills add |
在多個 Agent 中發現和安裝 | 內建 list、update、remove | 會執行第三方 npm 包 |
gh skill install |
GitHub 來源、版本鎖定與可追溯性 | 能按來源更新 | 需要新版 GitHub CLI，並明確選擇 Agent |
| Claude Plugin Marketplace | 打包的 Claude Code 擴充套件和團隊分發 | 外掛 UI、命令與 Marketplace 更新 | Plugin 的執行與信任面更大 |
第一次安裝個人 Claude Code Skill 時，手動專案安裝最便於稽核；需要多個 Agent 共用時，npx skills add 更方便；需要可復現的 GitHub 安裝時，gh skill install 提供版本鎖定和來源追蹤；需要 Hooks 或 MCP 的維護型擴充套件應使用 Plugin，而不是假裝成單一 Skill。
去哪裡尋找 Claude Skills：發現不等於信任
目錄網站用於發現候選項，原始倉庫才決定你實際安裝了什麼。
- AI Agent Skills 按使用場景組織 Skills，並連結到原始倉庫。
- skills.sh 是與
npx skills生態相關的公開 Agent Skills 目錄。 - Anthropic Skills 倉庫 提供官方示例和文件類 Skills。
- Claude 官方 Plugin Marketplace 可通過
/plugin和公開外掛目錄訪問。 - GitHub 搜尋可以直接找到 Skills，但搜尋位置和 Stars 不是安全審查。
安裝前應開啟原始倉庫，確認所有者與準確 Skill 路徑，檢視許可證，並把目錄網站展示的安裝命令與專案自己的最新文件對照。映象內容可能落後於來源。
安裝第三方 Skill 前的安全檢查清單
即使主要內容是文字，也要把 Skill 當作操作程式碼審查。
- 完整閱讀 SKILL.md。 確認 description 與正文行為一致，沒有要求 Agent 忽略使用者意圖或隱藏操作。
- 檢查指令碼和二進位制。 檢視
scripts/、包清單、編譯檔案、安裝 Hook 與下載的執行檔。 - 檢查工具許可權。 Claude Code Skill 可宣告
allowed-tools；信任工作區後，專案 Skill 可以獲得這些許可權。廣泛 Shell、網路或檔案許可權必須有明確理由。 - 尋找動態命令。 Claude Code 允許 Skill 用 Shell 結果生成上下文，信任前應理解每條命令。
- 追蹤網路訪問。 找出外部 URL、Telemetry、包登錄檔、遠端 API 和上傳目標。
- 保護金鑰。 Skill 不應要求把 API Key、Cookie、SSH Key 或生產憑證寫入 Skill 檔案或聊天輸出。
- 核查來源。 檢查倉庫所有者、提交歷史、可用的簽名 Release、Issue 質量，以及 Skill 是否從別處重新發布。
- 重要安裝鎖定版本。 Tag 或 Commit SHA 能限制意外變化。鎖定不等於安全，但能讓稽核可復現。
- 把更新當作新程式碼審查。 更新前比較指令、指令碼、依賴和許可權差異。
- 低風險測試。 使用臨時專案、無害樣例資料、受限憑證，以及結果可驗證的任務。
GitHub Stars 與下載量只能反映維護和流行度，不能證明安全。Anthropic 把 Prompt Injection 和資料外洩列為主要 Skill 風險，並建議只安裝可信來源。
如何驗證 Claude Skill 真的安裝成功
驗證應分為四層。
第一層：發現
確認 Skill 出現在 Claude 的 Skills 介面、Claude Code 的 Slash Command 選單（如果允許使用者呼叫），或安裝器列表中。同時確認實際作用域是專案、個人、Plugin 還是組織。
第二層：明確呼叫
在支援時直接按名稱呼叫，或說“使用 [名稱] Skill 完成……”並提供無害樣例。這能在不依賴自動匹配的情況下測試載入。
第三層：自動觸發
新建一條符合 description、但不點名 Skill 的請求。如果 Claude 從不選擇它，檢查或改進 description；如果它幾乎總是觸發，則應縮窄使用條件。
第四層：行為正確
檢查可觀察結果：是否用了指定模板？是否只執行文件宣告的工具？檔案是否寫到承諾位置？破壞性操作前是否停下來請求確認？一段普通但合理的回答不能證明 Skill 正確執行。
Claude Skills 常見疑難排解
| 問題 | 常見原因 | 檢查方法 |
|---|---|---|
| 看不到 Customize > Skills | Code execution 或組織 Skills 被停用 | 帳號能力與管理員設定 |
| ZIP 上傳失敗 | 壓縮根目錄錯誤、缺少 SKILL.md、名稱/Frontmatter 無效或超限 |
在本地解壓並檢查準確目錄樹 |
| Claude Code 找不到 Skill | 作用域錯誤、檔名大小寫錯誤或目錄巢狀錯誤 | 路徑必須以 <skill-name>/SKILL.md 結束 |
| Skill 存在但從不觸發 | Description 沒寫清何時使用 | 先明確呼叫，再修改描述 |
| Skill 觸發過度 | Description 太寬泛 | 加入具體場景和排除條件 |
| 修改沒有被檢測 | 會話啟動後才建立頂層目錄 | 首次重啟；已有目錄一般即時更新 |
| Plugin Skill 不顯示 | 需要 Reload、有載入錯誤或使用名稱空間 | 執行 /reload-plugins 並檢視 Errors |
| 安裝到錯誤 Agent | 預設 Agent 或作用域被誤用 | 用明確的 --agent claude-code 和 Scope 重灌 |
| 團隊行為不同 | 個人 Skill 覆蓋專案 Skill，或版本不同 | 檢查優先順序、來源和鎖定版本 |
| Windows/WSL 路徑或許可權錯誤 | Shell、WSL、Home 路徑或檔案許可權不同 | 確認真實 Home 與寫許可權 |
不要通過把同一個 Skill 複製到所有可能目錄來“修復”發現問題。重複副本會產生優先順序衝突，也讓更新難以審計。
更新、共享或解除安裝 Claude Skills
手動安裝的個人 Skill 應在稽核後替換檔案；解除安裝則刪除準確資料夾。專案 Skill 應使用 Git，讓更改像其他倉庫配置一樣經過審查和共享。
Vercel Labs CLI 使用 npx skills update 與 npx skills remove <name>。GitHub CLI 使用當前版本文件中的 gh skill update 和 list 命令。Plugin 通過 /plugin 或 enable、disable、uninstall 命令管理。Claude.ai 則在 Customize > Skills 中管理。
Team 與 Enterprise 應使用組織配置、共享 Skill、專案 Skill 或受控 Plugin Marketplace，不要通過郵件分發無法追蹤的 ZIP。每個業務關鍵 Skill 都應記錄所有者、版本、審查日期和回滾說明。
常見問題
安裝 Claude Skill 的正確命令是什麼？
沒有適用於所有 Claude 產品的單一命令。Claude.ai 使用 ZIP 上傳；Claude Code 支援 ~/.claude/skills、.claude/skills、Plugin 和相容的第三方安裝器。應根據產品與作用域選擇。
claude install 能安裝 Skills 嗎？
不能。Anthropic 把 claude install 記錄為 Claude Code 本體的安裝或遷移命令。不要在後面追加倉庫 slug 並假設它會安裝 Skill。
Claude Code Skills 存在哪裡？
個人 Skill 位於 ~/.claude/skills/<skill-name>/SKILL.md；專案 Skill 位於 .claude/skills/<skill-name>/SKILL.md；Plugin Skill 位於外掛包中並使用名稱空間。
可以從 GitHub 安裝 Claude Skill 嗎？
可以。你可以稽核後手動複製 Skill 資料夾，使用 npx skills add、gh skill install，或在倉庫提供 Claude Plugin Marketplace 時通過 Plugin 安裝。可用方法由倉庫結構決定。
Claude Skills 能在 Claude Desktop 使用嗎？
在支援的套餐和設定中，可以通過 Claude 的 Customize > Skills 上傳自定義 Skills。Claude Code Desktop 是另一個開發者介面，使用 Claude Code 專案 Skills 和 Plugins。
安裝 Skill 後必須重啟 Claude Code 嗎？
如果是在已經被監控的目錄中新增或修改 Skill，通常不需要。會話啟動後才建立頂層 Skills 目錄時，或舊版本排錯時才需要重啟。Plugin 可以用 /reload-plugins 重新整理。
一個 Skill 能同時用於 Claude Code、Codex 和 Cursor 嗎？
基礎 Agent Skills 遵循開放格式，通常能在相容 Agent 之間複用。但 Agent 專用欄位、工具名、Hooks、動態命令和許可權模型不一定可移植，必須逐個目標測試。
第三方 Claude Skills 安全嗎？
不能預設安全。Skill 可以影響工具呼叫、執行指令碼、安裝依賴或訪問網路。應稽核來源、許可權、指令碼、依賴和更新路徑，並使用低風險資料測試。
Skill 和 Plugin 有什麼區別？
Skill 是一個按需載入的工作流包。Claude Code Plugin 是分發容器，可以包含多個 Skills，以及 Hooks、Agents、MCP Server、LSP 等更強元件。
如何徹底解除安裝 Claude Skill？
在 Customize > Skills 刪除、移除準確的本地 Skill 目錄、執行安裝器的 Remove 命令，或解除安裝包含它的 Plugin。之後還要確認更高優先順序作用域沒有同名副本。
資料來源與下一步
本文主要參考：
- Claude Help Center：Use skills in Claude
- Claude Code：Extend Claude with skills
- Claude Code：Discover and install plugins
- Agent Skills 規範
- Anthropic Skills 倉庫
- Vercel Labs skills CLI
- GitHub CLI：gh skill install
確認自己的 Claude 使用環境和安裝方式後，可以瀏覽 AI Agent Skills，開啟候選 Skill 的原始倉庫，完成安全檢查，並且只安裝真正需要的那一個 Skill。