Vercel Labs 出品的 skills CLI，定位為「The CLI for the open agent skills ecosystem」。執行 npx skills add 將 GitHub 上的 SKILL.md 倉庫同步進 Claude Code、Cursor、Codex、Copilot、Windsurf、Cline 等 agent，以符號連結統一維護，一份指令範本可跨多端共用。
Claude Code、Cursor、Codex、Copilot、Windsurf 等每家 agent 都有自己存「指令範本」的目錄，各家結構不同、各家手動維護。vercel-labs/skills 是一條 CLI 工具，把 GitHub 上任何寫了 SKILL.md 的倉庫同步進你所有 agent 的指定位置。一次安裝後，所有 agent 共用同一份能力清單，修改一份即全端同步。
skills CLI 是指令範本的套件管理器，不是 skill 本身。npm 管 JS 套件、pip 管 Python 套件、skills CLI 管 agent 的指令範本。執行 npx skills add vercel-labs/agent-skills 安裝的是 Vercel Labs 另一個倉庫 vercel-labs/agent-skills 裡的 SKILL.md。CLI 倉庫與 skills 倉庫是兩個不同的 repo，請勿混淆。
Skills CLI 以 symlink 解決了跨 agent 維護 prompt 的同步問題：同一份 prompt 過去需要複製進每個 agent 的目錄並各自更新。Skills CLI 改為維護一份 SKILL.md，以符號連結讓所有 agent 共用同一份來源，避免各端版本不一致的情況。
Skills CLI 不需要預先安裝，直接以 npx skills 執行。入門指令為 npx skills add vercel-labs/agent-skills，執行後將 Vercel Labs 自家策展的 SKILL.md 倉庫裝進本機所有偵測到的 agent。
多端共用是預設行為,但你也可以 -a 鎖定特定 agent、-s 鎖定特定 skill。團隊裡有人只用 Claude Code、有人用 Cursor,各自只裝自己要的、共享同一個 source。
skills init 會起一份 SKILL.md 模板,有 YAML frontmatter 與正文骨架。你寫完 push 到 GitHub,任何人就能 npx skills add your/repo 把它接到自家 agent。一份檔案,全網路共享。
npx skills update 拉取新版時，所有 agent 同步看到更新版本。這是「一份 source，多端共用」的機制核心。若需客製化 skill 內容，加 --copy 強制複製檔案。
Skills CLI 共有六條核心指令，加上數個常用旗標。以下 12 張卡片列出指令、旗標、SKILL.md 規格與重要環境變數，均對應官方 README，無推測內容。
npx skills add owner/repo,預設掃所有偵測到的 agent。-a claude-code、-a cursor。同一台機器多 agent 並存時必用。-s pr-review,release-notes,用逗號分隔。-g 裝到使用者層級,所有專案共用同一份 skill。--copy 改成複製檔案。如果你要客製化 skill 內容、不想跟上游同步,加這條。name、description、metadata。description 是 agent 用來判斷該不該觸發這條 skill 的關鍵。DISABLE_TELEMETRY=1 環境變數加上去。同位另一個常用是 INSTALL_INTERNAL_SKILLS=1。| 場景 | 該跑的指令 | 主要旗標 |
|---|---|---|
| 第一次裝官方策展包 | npx skills add vercel-labs/agent-skills |
(無) |
| 只想裝給 Claude Code | npx skills add <repo> -a claude-code |
-a |
| 挑特定幾個 skill | npx skills add <repo> -s a,b,c |
-s |
| 跨專案共用 | npx skills add <repo> -g |
-g |
| 不想 symlink、要客製化 | npx skills add <repo> --copy |
--copy |
| 看裝了什麼 | npx skills list |
(無) |
| 同步最新版 | npx skills update |
(無) |
| 自製 skill | npx skills init |
(無) |
以下六條進階用法均源自 README、CLI 旗標與 SKILL.md 規格，以套件管理器的角度使用 skills CLI 才能發揮這些模式。所有指令均對應官方 README，無推測內容。
SKILL.md frontmatter 的 description 是 agent 判斷該不該觸發這個 skill 的決定性字串。寫得越具體、越多動詞與場景關鍵字,agent 越能在對的時機自動拉這個 skill。description 不是說明文,是 trigger query。
npx skills add ... -g 裝到使用者目錄,所有專案共用同一份。團隊可以維護一份 company/agent-skills 倉庫,新人 onboarding 一條指令裝完所有公司 skill,所有 agent 立刻有公司 voice。
預設安裝為 symlink 至本機快取。直接修改 .claude/skills/ 下的檔案等於修改上游快取，下次 update 將覆蓋。若需客製化，請加 --copy 或 fork repo 維護自有版本。
同一台機器同時有 Claude Code 與 Cursor 時，以 -a claude-code、-a cursor 分別安裝同一份 skill。不指定 -a 預設安裝至所有 agent，建議明確指定目標以避免 agent picker 出現預期外的 skill。
Skills CLI 預設會送匿名安裝統計回 Vercel。公司資安規定不允許就在 shell 設 DISABLE_TELEMETRY=1,寫進 .zshrc 或 CI 環境變數,所有後續呼叫都不送資料。
將現有 prompt 以 npx skills init 建立成 SKILL.md，push 至 GitHub 後，其他使用者即可 add。可配合 git 進行版本控制，與一般程式碼套件管理流程一致。
情境：一個 monorepo，本機同時安裝 Claude Code、Cursor、Codex。目標是將「release notes 寫作」這份 skill 一次裝給三個 agent 共用。以下為終端機操作記錄，展示從安裝到自製 skill 的完整流程。
偵測 agent 是自動的。你不用告訴 CLI 本機裝了哪些 agent,它會掃 .claude/、.cursor/、.codex/ 之類的目錄。新加 agent 也只要重跑一次 skills add,新 agent 自動跟上。
symlink 讓 update 變成一條指令。跑 npx skills update 拉最新版,所有 agent 立刻看到新版。沒有「我這台 Cursor 還在用舊版」這種尷尬狀況。
init 把 prompt 變成可分享資產。你公司私有的 PR 模板、release notes 規格、code review 風格,通通可以 init 成 skill repo,所有專案 add 一次就有,大家寫的 PR 風格自動一致。
npx skills add vercel-labs/agent-skills 安裝的是後者，請注意區分。
--copy 跳過 symlink。
.claude/、.cursor/ 等目錄存在來判斷哪個 agent 裝著。新 agent 沒被官方 CLI 認得就要等 PR、或 fork 自己加。 55+ 是一個會持續變動的數字。
npx skills update 不會自己跑。如果上游 skill 有 bug 修正或安全更新,你不主動 update 就拿不到。寫進團隊 onboarding 與週會 checklist。
.claude/skills/... 下的檔案等於修改本機快取，下次 update 將直接覆蓋。若需客製化，請加 --copy，或 fork 整個 repo 維護自有版本。
DISABLE_TELEMETRY=1 環境變數;團隊 CI 跑的時候也記得加上。
Skills CLI 將 prompt 轉化為可版本控制、可跨 agent 共用、可透過 GitHub 分享的資產。其核心價值在於為公司 prompt 提供一個標準化、跨 agent、社群相容的發佈管道，而非僅限於安裝官方策展包。
1. 維護一份 company/agent-skills。把公司專屬的 PR 模板、release notes 規格、code review 風格、品牌 voice 寫成 SKILL.md。新人 onboarding 一條 skills add 拿到全公司 prompt 資產。
2. 跑兩層 skill repo:外層 + 內層。外層裝 vercel-labs/agent-skills 拿社群通用 skill,內層裝 your-org/skills 拿公司專屬。兩個 GitHub repo、兩個 update 節奏、互不干擾。
3. 用 CI 自動 update。GitHub Actions 每週執行一次 npx skills update，結果開 PR。Team 透過 PR diff 確認上游 skill 的變更內容再決定是否 merge，將 prompt 維護納入正常 review 流程。
4. 發佈 skill 至 GitHub。將自製的 prompt 以 skills init 封裝成 SKILL.md 並 push 至 GitHub。skills ecosystem 仍處於早期，公開發佈的 skill 有機會被社群採用。
5. 鎖版本走 git tag。長期 production 環境建議不要永遠拉 HEAD，將上游 skill repo 鎖定在特定 git tag。skills add owner/repo@v1.2 可指定版本。重大升級請先人工審查再合併。
① github.com/vercel-labs/skills：CLI 本身的 README，完整指令與旗標說明。
② github.com/vercel-labs/agent-skills：Vercel Labs 自家策展的 skill 集合，可作為 SKILL.md 撰寫範本。
③ npmjs.com/package/skills：npm 版本頁，用於鎖定版本與查看發佈頻率。