Vercel Skills CLI 使用指南
vercel-labs/skills 是管理 Agent Skills 的命令列工具，可搜尋、安裝、列出、更新與移除 skills，供 Claude Code、Codex、Cursor 等 AI coding agents 使用。Skill 通常以 SKILL.md 定義工作指引，讓 agent 在相關任務中套用。
- CLI 專案：vercel-labs/skills
- Skills 目錄：skills.sh
- 本文範例來源：mattpocock 的 skills
1. 使用前準備
依目前官方 README，需使用 Node.js 22.20 以上版本。先在終端機確認環境：
node --version
npm --version
git --version
本文使用 npx 執行，不必先全域安裝 skills 套件。第一次執行時，npm 可能詢問是否下載套件。
npx skills --help
若要安裝至某個專案，請先切換到該專案的根目錄。以下指令可在 PowerShell、macOS 或 Linux 終端機使用。
來源：官方 README。
2. 常用語法
基本格式：
npx skills <command> [參數與選項]
| 用途 | 指令 |
|---|---|
| 查看說明 | npx skills --help |
| 互動搜尋 | npx skills find |
| 關鍵字搜尋 | npx skills find retro --owner mattpocock |
| 列出來源提供的 skills | npx skills add mattpocock/skills --list |
| 互動選擇安裝 | npx skills add mattpocock/skills |
| 安裝全部 skills 至 Codex | npx skills add mattpocock/skills --skill '*' -a codex |
| 安裝指定 skill | npx skills add mattpocock/skills --skill retro |
| 查看專案已安裝 skills | npx skills list |
| 查看全域已安裝 skills | npx skills list -g |
| 檢查可用更新 | npx skills check |
| 更新已安裝 skills | npx skills update |
| 移除指定 skill | npx skills remove retro |
| 建立自己的 skill 範本 | npx skills init my-skill |
安裝時常用選項：
| 選項 | 說明 |
|---|---|
--skill <名稱>、-s <名稱> |
指定要安裝的 skill |
--agent <名稱>、-a <名稱> |
指定 agent，例如 codex、claude-code |
--global、-g |
安裝至使用者範圍，供不同專案使用；預設是目前專案 |
--list、-l |
僅列出來源內的 skills，不安裝 |
--yes、-y |
略過安裝確認 |
--copy |
使用複製方式安裝，適用於無法建立符號連結的環境 |
來源可以寫成 owner/repo，也能使用完整 GitHub URL：
npx skills add https://github.com/mattpocock/skills
指令與選項依據：官方 CLI reference。
3. mattpocock 範例：安裝整個集合或只安裝 retro
步驟一：搜尋或查看集合清單
搜尋 retro，並限定作者為 mattpocock：
npx skills@latest find retro --owner mattpocock
find mattpocock 是關鍵字搜尋，不會列出該作者的全部 skills；再接 grep retro，也只能篩選已回傳的結果。若已知道 repository，直接查看集合清單更適合：
npx skills@latest add mattpocock/skills --list
find 搜尋 skills 目錄；add <來源> --list 查看指定 repository 的可安裝內容。目錄搜尋沒有找到時，仍可直接從 repository 安裝。
方式一：安裝集合內所有 skills
安裝全部 skills 至目前專案的 Codex：
npx skills@latest add mattpocock/skills --skill '*' -a codex
若要跨專案使用，改為全域安裝：
npx skills@latest add mattpocock/skills --skill '*' -a codex -g
--skill '*' 選取來源內全部 skills，-a codex 限定目標 agent。請保留 '*' 的引號，避免 shell 將星號展開為檔名。
不要將這裡的 --skill '*' 直接換成 --all：--all 會安裝全部 skills 到全部 agents，並略過確認。
方式二：只安裝 retro
只安裝 retro 至目前專案的 Codex：
npx skills@latest add mattpocock/skills --skill retro -a codex
若要跨專案使用，改為全域安裝：
npx skills@latest add mattpocock/skills --skill retro -a codex -g
retro 用於工作階段結束後，檢視 agent 的工作環境，提出導覽、檢查流程、規範與工具等改善建議。
上述兩種方式擇一使用即可。若使用 Claude Code，將 -a codex 改為 -a claude-code；若希望互動選擇目標 agent，可省略 -a codex。加上 -y 則略過安裝確認。
步驟二：確認安裝
查看目前專案的安裝結果：
npx skills@latest list
若安裝時使用 -g，則查看全域結果：
npx skills@latest list -g
來源：mattpocock 的 skills、CLI 安裝選項。
4. 怎麼更新
更新已安裝的 skills
先檢查是否有更新：
npx skills check
執行更新，依提示選擇範圍：
npx skills update
也能明確指定範圍：
# 只更新目前專案
npx skills update -p
# 只更新全域安裝
npx skills update -g
只更新指定的 skill：
# 更新專案中的 retro
npx skills update retro -p
# 更新全域的 retro
npx skills update retro -g
更新後可用 list 或 list -g 查看安裝項目，再執行 check 檢查更新狀態。
來源：官方 update 說明。
使用最新版 CLI
skills update 更新的是已安裝的 skills。若要明確使用 npm 上最新版的 CLI，將套件名稱寫成 skills@latest：
npx skills@latest --help
npx skills@latest check
npx skills@latest update
若新版官方文件中的選項無法使用，可先改用 npx skills@latest，並查看該版本的 --help。
5. 日常操作速查
# 搜尋
npx skills find retro --owner mattpocock
# 查看集合清單
npx skills add mattpocock/skills --list
# 安裝全部 skills 至目前專案的 Codex
npx skills add mattpocock/skills --skill '*' -a codex
# 或只安裝 retro
npx skills add mattpocock/skills --skill retro -a codex
# 查看安裝結果
npx skills list
# 檢查與更新
npx skills check
npx skills update retro -p
# 不再需要時移除
npx skills remove retro
若安裝時使用 -g，查看、更新與移除時也應選擇全域範圍，例如 npx skills remove retro -g。
參考資料
本文依撰寫時讀取的官方文件整理；指令與 skill 清單可能持續更新，請以最新版 --help 及官方文件為準。
沒有留言:
張貼留言