使用手冊

第 05 期 · 開源工程 / Skills CLI 入口

skills CLI： SKILL.md 套件管理器，支援 55+ AI agent。

vercel-labs/skills CLI 實戰手冊。npx skills add 將任何 SKILL.md 倉庫同步進 Claude Code、Cursor、Codex、Copilot 等 55+ agent，以符號連結統一管理，支援 init、find、update、remove 指令，是開源 agent skills 生態的套件管理工具。

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，以符號連結統一維護，一份指令範本可跨多端共用。

vercel-labs/skills
星標
20.8K
分支
1.7K
授權
—
資料截至
閱讀時間
10 分
更新日期
開啟原始報告
GitHub Stars
18.6k
支援 Agent
55+
核心指令
6
開源授權
MIT
本頁章節

01工具定位

skills CLI：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 共用同一份來源，避免各端版本不一致的情況。

  1. npx skills add

  2. 解析 owner/repo

  3. 下載 SKILL.md

  4. 偵測本機 agent

  5. symlink 到目錄

  6. 所有端同步

The CLI for the open agent skills ecosystem. One install, 55+ agents.

— vercel-labs/skills README

02安裝方式

無需全域安裝，以 npx 直接執行。

Skills CLI 不需要預先安裝，直接以 npx skills 執行。入門指令為 npx skills add vercel-labs/agent-skills，執行後將 Vercel Labs 自家策展的 SKILL.md 倉庫裝進本機所有偵測到的 agent。

bash
# 一條指令:裝 Vercel Labs 策展的 skill pack 進所有偵測到的 agent
npx skills add vercel-labs/agent-skills

# 看裝了什麼
npx skills list

只裝特定 agent?

多端共用是預設行為,但你也可以 -a 鎖定特定 agent、-s 鎖定特定 skill。團隊裡有人只用 Claude Code、有人用 Cursor,各自只裝自己要的、共享同一個 source。

bash
# 只裝給 Claude Code,並只挑兩個 skill
npx skills add vercel-labs/agent-skills -a claude-code -s release-notes,pr-review

# 互動式找 skill
npx skills find

# 全域裝到使用者目錄,不只當前 repo
npx skills add vercel-labs/agent-skills -g

寫自己的 skill

skills init 會起一份 SKILL.md 模板,有 YAML frontmatter 與正文骨架。你寫完 push 到 GitHub,任何人就能 npx skills add your/repo 把它接到自家 agent。一份檔案,全網路共享。

bash
npx skills init release-notes-writer

# 編輯生出的 SKILL.md · 加 description / instructions
# push 到 GitHub 後,別人就能裝你的 skill
npx skills add <you>/<repo>

03六大指令 · SKILL.md 規格

skills CLI 的六條核心指令與常用旗標。

Skills CLI 共有六條核心指令，加上數個常用旗標。以下 12 張卡片列出指令、旗標、SKILL.md 規格與重要環境變數，均對應官方 README，無推測內容。

Command · 01

skills add

裝新技能

從任何 GitHub 倉庫拉 SKILL.md 進本機 agent。npx skills add owner/repo,預設掃所有偵測到的 agent。

Command · 02

skills list (ls)

列出已裝

列出本機所有已裝的 skill,以及它們安裝在哪些 agent 的哪個目錄。debug 路徑問題的第一站。

Command · 03

skills find

互動式搜尋

在終端機裡互動搜尋官方策展庫的 skill,挑完按 enter 直接裝。第一次玩、想看有什麼可用就跑這條。

Command · 04

skills remove (rm)

解除安裝

移除某個 skill 或某個 agent 上的所有 skill。symlink 是乾淨被解掉,不會留下殘餘檔案。

Command · 05

skills update

拉最新版

拉本機已裝的所有 skill 最新版。因為是 symlink,一次 update 後所有 agent 都看到新版,沒有複製延遲。

Command · 06

skills init

自製skill

起一份 SKILL.md 模板,內含 YAML frontmatter 與正文骨架。push 到 GitHub 就能讓全世界 add。

Flag · 07

-a / --agent

指定哪個 agent

只裝給特定 agent,例如 -a claude-code、-a cursor。同一台機器多 agent 並存時必用。

Flag · 08

-s / --skill

挑單一 skill

不要整個倉庫一起裝,只挑名單裡的幾個 SKILL.md。-s pr-review,release-notes,用逗號分隔。

Flag · 09

-g / --global

裝到使用者目錄

預設裝到當前 repo 的 agent 目錄。-g 裝到使用者層級,所有專案共用同一份 skill。

Flag · 10

--copy

複製不 symlink

預設用 symlink,加 --copy 改成複製檔案。如果你要客製化 skill 內容、不想跟上游同步,加這條。

Spec · 11

SKILL.md frontmatter

YAML 規格

每個 skill 是一份 SKILL.md,frontmatter 寫 name、description、metadata。description 是 agent 用來判斷該不該觸發這條 skill 的關鍵。

Env · 12

DISABLE_TELEMETRY

關掉遙測

不想 Vercel 蒐集匿名安裝統計?DISABLE_TELEMETRY=1 環境變數加上去。同位另一個常用是 INSTALL_INTERNAL_SKILLS=1。

你想做什麼,跑哪一條?

場景該跑的指令主要旗標
第一次裝官方策展包npx skills add vercel-labs/agent-skills(無)
只想裝給 Claude Codenpx skills add <repo> -a claude-code-a
挑特定幾個 skillnpx 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(無)
自製 skillnpx skills init(無)

04進階用法 · POWER PATTERNS

將 skills CLI 作為套件管理器而非 plugin 使用。

以下六條進階用法均源自 README、CLI 旗標與 SKILL.md 規格，以套件管理器的角度使用 skills CLI 才能發揮這些模式。所有指令均對應官方 README，無推測內容。

用 description 來控制觸發

SKILL.md frontmatter 的 description 是 agent 判斷該不該觸發這個 skill 的決定性字串。寫得越具體、越多動詞與場景關鍵字,agent 越能在對的時機自動拉這個 skill。description 不是說明文,是 trigger query。

來源 · README · SKILL.md spec

團隊共用走 -g 全域

npx skills add ... -g 裝到使用者目錄,所有專案共用同一份。團隊可以維護一份 company/agent-skills 倉庫,新人 onboarding 一條指令裝完所有公司 skill,所有 agent 立刻有公司 voice。

來源 · README · -g flag

symlink 是同步機制,別亂改

預設安裝為 symlink 至本機快取。直接修改 .claude/skills/ 下的檔案等於修改上游快取，下次 update 將覆蓋。若需客製化，請加 --copy 或 fork repo 維護自有版本。

來源 · README · symlink behavior

跨 agent 用 -a 鎖目標

同一台機器同時有 Claude Code 與 Cursor 時，以 -a claude-code、-a cursor 分別安裝同一份 skill。不指定 -a 預設安裝至所有 agent，建議明確指定目標以避免 agent picker 出現預期外的 skill。

來源 · README · -a flag

關掉 telemetry 走 DISABLE_TELEMETRY

Skills CLI 預設會送匿名安裝統計回 Vercel。公司資安規定不允許就在 shell 設 DISABLE_TELEMETRY=1,寫進 .zshrc 或 CI 環境變數,所有後續呼叫都不送資料。

來源 · README · environment variables

用 init 將 prompt 發佈為可共享的 SKILL.md

將現有 prompt 以 npx skills init 建立成 SKILL.md，push 至 GitHub 後，其他使用者即可 add。可配合 git 進行版本控制，與一般程式碼套件管理流程一致。

來源 · README · skills init

05實作範例

從空白專案到三個 agent 共用同一份 skill。

情境：一個 monorepo，本機同時安裝 Claude Code、Cursor、Codex。目標是將「release notes 寫作」這份 skill 一次裝給三個 agent 共用。以下為終端機操作記錄，展示從安裝到自製 skill 的完整流程。

~/repos/acme-monorepo · zsh · skills CLI


$ ~/repos/acme-monorepo ›
  npx skills find


> [skills find · interactive]
  # → 列出策展庫的 skill,鍵盤選 release-notes
  ok: → 已挑選:vercel-labs/agent-skills · release-notes


$ ~/repos/acme-monorepo ›
  npx skills add vercel-labs/agent-skills -s release-notes


> [skills add]
  # → detected agents: claude-code · cursor · codex
  # → install target: ./
  # → symlink: .claude/skills/release-notes/
  # → symlink: .cursor/rules/release-notes.md
  # → symlink: .codex/instructions/release-notes.md
  ok: → done · 1 skill installed across 3 agents


$ ~/repos/acme-monorepo ›
  npx skills list


> [skills list]
  claude-code
    # · release-notes  ← vercel-labs/agent-skills
  cursor
    # · release-notes  ← vercel-labs/agent-skills
  codex
    # · release-notes  ← vercel-labs/agent-skills


$ ~/repos/acme-monorepo ›
  npx skills init internal-pr-template


> [skills init]
  ok: → created ./internal-pr-template/SKILL.md
  # → next: edit description + instructions, then push


$ ~/repos/acme-monorepo ›
  # 編輯 SKILL.md,push 到自家 GitHub
  git add internal-pr-template && git commit -m "feat: PR skill"
  git push


$ ~/repos/acme-monorepo ›
  npx skills add acme/internal-skills


> [skills add · 自家 skill]
  ok: → 同步進 3 個 agent · 公司 PR 模板全員上線

一條指令，三個 agent 同步。一份 SKILL.md，全公司共用。prompt 成為可版本控制的資產。

— Skills CLI 核心使用場景

這條流程值得拆解的點

**偵測 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 風格自動一致。

06使用前須知

使用 skills CLI 前需了解的限制與注意事項。

07進階路徑

以 skills CLI 管理公司 prompt 的五個做法。

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 版本頁，用於鎖定版本與查看發佈頻率。

Skills CLI 將 prompt 轉化為可分享、可版本控制、跨工具共用的資產，管理方式與 npm 套件一致。

— Skills CLI 設計定位