npx skills add 怎麼用：從 GitHub 安裝 Skill、skills.sh 是什麼與常用命令

本文根據開源項目 vercel-labs/skills 的官方 README 整理，資料核對於 2026-10-11。skills 是 Vercel 實驗室發佈的一個命令行工具，不屬於任何一家模型廠商；各工具自帶的安裝方式（如 Claude Code 的插件市場、Gemini CLI 的 gemini skills install）仍然可用。

適用於誰

• 搜「npx skills add」「skills.sh 如何使用」「skills.sh 是什麼」「find skills 安裝」的人；
• 在某個 Skill 倉庫的 README 裏看到一行 npx skills add 某某/某某，想知道它會做什麼的人；
• 同時用 Claude Code、Codex、Cursor 等多個工具，想一次把技能裝到所有工具裏的人。

結論先說

1. skills 是一個跨工具的技能管理命令行：安裝、列出、更新、刪除 SKILL.md 技能，自動識別你機器上裝了哪些編程智能體。
2. 最常用的一條：npx skills add owner/repo，從 GitHub 倉庫安裝技能。
3. 預設裝到當前項目；加 -g 裝到用戶主目錄，對所有項目生效。
4. 預設用軟連結，各工具的技能目錄都指向同一份；不支持軟連結時加 --copy。
5. 先看再裝：--list 可以只列出倉庫裏有哪些技能而不安裝。

一、安裝技能

bash
npx skills add vercel-labs/agent-skills

add 接受的來源寫法（官方 README 示例）：

bash
# GitHub 簡寫（owner/repo）
npx skills add vercel-labs/agent-skills

# 完整的 GitHub 地址
npx skills add https://github.com/vercel-labs/agent-skills

# 指向倉庫裏某一個技能的路徑
npx skills add https://github.com/vercel-labs/agent-skills/tree/main/skills/web-design-guidelines

# GitLab 地址
npx skills add https://gitlab.com/org/repo

# 任意 git 地址
npx skills add [email protected]:vercel-labs/agent-skills.git

# 本地路徑
npx skills add ./my-local-skills

私有倉庫用同樣的命令，工具使用你已經配置好的倉庫認證方式（Git 憑據助手、GitHub CLI 或 SSH）。

二、add 的常用參數

官方示例：

bash
# 先看倉庫裏有哪些技能
npx skills add vercel-labs/agent-skills --list

# 只裝其中兩個
npx skills add vercel-labs/agent-skills --skill frontend-design --skill skill-creator

# 只裝給指定的工具
npx skills add vercel-labs/agent-skills -a claude-code -a opencode

# 非交互安裝（CI 裏用）
npx skills add vercel-labs/agent-skills --skill frontend-design -g -a claude-code -y

建議的順序是先 --list，再用 --skill 點名安裝需要的那幾個。--all 和 -y 會跳過所有確認，裝第三方倉庫時不要用。

三、裝到哪去了

<agent> 因工具而異。官方表格裏的部分行（核對於 2026-10-11）：

工具會自動檢測你裝了哪些智能體；一個都沒檢測到時會讓你選。

兩種安裝方式

• 軟連結（推薦）：各工具的目錄都連結到同一份規範副本，只有一個數據源，更新方便；
• 複製：每個工具各有一份獨立副本，用在不支持軟連結的環境裏，命令行加 --copy。

所在環境不支持軟連結、創建失敗時，加 --copy 改為複製。

四、其他命令

幾個示例：

bash
npx skills find typescript
npx skills ls -g
npx skills update my-skill
npx skills remove web-design-guidelines
npx skills init my-skill

use 的用法：不帶 --agent 時把生成的提示詞輸出到標準輸出，可以用管道交給某個工具；帶 --agent 時直接啟動那個工具並帶上提示詞。

bash
npx skills use vercel-labs/agent-skills@web-design-guidelines | claude

五、它怎麼在倉庫裏找技能

工具會在倉庫裏的這些位置查找：

• 倉庫根目錄（如果根目錄就有 SKILL.md）；
• skills/ 目錄及其下的幾個約定子目錄；
• 各工具專屬的目錄，如 .claude/skills/、.agents/skills/ 等；
• .claude-plugin/marketplace.json 或 .claude-plugin/plugin.json 裏聲明的技能。

標準位置裏什麼都沒找到時，會做一次遞歸搜尋。提示「No skills found」時，官方給的檢查方向是：確認倉庫裏有合法的 SKILL.md，並且 frontmatter 裏有 name 和 description。

六、跨工具的兼容性

官方 README 的說明：技能遵循共同的 Agent Skills 規範，所以大多數可以跨工具使用，但有些特性是工具專有的：

• allowed-tools：多數列出的工具支持，個別不支持；
• context: fork：只有 Claude Code 支持；
• Hooks：只有少數幾個工具支持。

也就是說，這個命令行能把文件放到正確的位置，但不保證技能裏的每個特性在每個工具裏都生效。

七、遙測與環境變量

官方說明：命令行會收集匿名的使用數據，不收集個人資料；只有當 GitHub 確認倉庫是公開的，才會發送倉庫和技能的標識。

在公司內網或處理私有倉庫時，設 DISABLE_TELEMETRY=1 再使用。

八、skills.sh 是什麼

skills.sh 是和這個命令行配套的技能目錄網站，官方 README 對它的介紹只有一句：在那裏發現可以安裝的技能。上面的條目來自各個作者自己的倉庫。

被收錄、排名靠前都不代表安全。技能可以帶腳本，也可以在說明裏指示智能體執行命令，安裝前把 SKILL.md 和腳本讀一遍，見《Skill 安全嗎：安裝前檢查什麼》。本站也整理了一批討論和使用較多的技能庫，見 Skill 庫。

常見問題

Q：必須用這個工具才能裝技能嗎？

不是。技能就是文件夾，手動複製到對應目錄效果一樣。這個工具省的是「同一份技能裝給多個工具」和「後續更新」的功夫。

Q：裝好了但工具裏看不到？

官方的三個檢查方向：安裝路徑對不對、那個工具自己的技能加載文檔怎麼說、YAML frontmatter 是否合法。各工具的目錄見《Claude Code Skills 安裝在哪裏》、《Codex Skills 怎麼用》、《Cursor Skills 使用教學》。

Q：提示沒有寫入權限？

確認對目標目錄有寫權限；項目範圍裝在當前目錄下，全局範圍裝在用戶主目錄下。

Q：怎麼卸載乾淨？

npx skills remove 技能名 刪除指定技能，加 -g 針對全局範圍，加 -a 針對指定工具。

參考資料

• vercel-labs/skills（官方倉庫與 README）：https://github.com/vercel-labs/skills
• Specification（Agent Skills 官方規範）：https://agentskills.io/specification