vercel-labs/skills 官方入口：Agent Skills 安装与管理指南

找 Agent Skills 安装入口时，最怕点进一个“看起来像教程”的页面，命令却已经过期。vercel-labs/skills 的官方入口要从两个信号确认：仓库主体是 `vercel-labs/skills`，README 里明确写着 open agent skills tool 和 `npx skills`；Vercel 发布页也把 skills 说明为安装和管理 skill packages 的 CLI。入口对了，后面的安装才有意义。

先看仓库是不是工具本体

容易混淆的是 `vercel-labs/skills` 和 `vercel-labs/agent-skills`。前者是 CLI 工具，负责 `add`、`use`、`find`、`update` 等管理动作；后者更像技能包集合，用来被安装或引用。写教程时如果把两者混成一个入口，读者会以为 `agent-skills` 本身就是命令行工具。失败场景很常见：复制了安装包仓库地址，却找不到 CLI 的参数说明。

入口页要能回答三个问题

一个合格入口页至少要回答：怎么安装一个 Skill，支持哪些来源格式，装完后怎么管理。skills README 覆盖了这些点：GitHub shorthand、完整 GitHub URL、仓库内具体 Skill 路径、GitLab URL、任意 git URL、本地路径都能作为来源。这个信息很关键，因为很多团队的 Skill 不一定放在公开仓库根目录，也可能在 monorepo 的某个子目录里。

不要只收藏一条命令

`npx skills add vercel-labs/agent-skills` 是上手命令，但不是完整入口。真正要收藏的是仓库 README 和 Vercel 发布说明，因为它们会告诉你命令变化、支持 Agent 范围、发现技能的方式。Vercel changelog 里还提到旧的 `npx add-skill` 已被新版 `npx skills` 接口替代。只记旧命令的人，后面排错会浪费时间。

入口页和教程页分开看

入口页负责确认项目身份，教程页负责解释怎么用。两者混在一起，最容易出现“标题写官方入口，正文却直接教安装”的问题。入口类文章应该先讲清 CLI 仓库、技能包集合、发布说明三者关系，再给安装命令。读者看到这里，至少能判断自己该打开哪个页面，而不是把搜索结果里的任何 `skills` 都当成同一个项目。

还有一个实用判断：入口页要有维护痕迹。仓库里能看到 release、commit、issues、README 更新，发布页能看到日期和功能变化，这些比宣传语更有用。失败场景是收藏到第三方搬运页，命令看起来一样，但缺少版本变化说明，等 `find`、`update` 或 agent 参数变化时，很难知道该跟哪边走。

入口核验清单

• CLI 仓库认准 `vercel-labs/skills`，技能包集合另看 `vercel-labs/agent-skills`。
• 安装命令优先以 README 当前内容为准。
• 需要搜索技能时看 `find`，需要刷新技能时看 `update`。
• 团队内使用前先决定项目级还是全局级安装。

入口确认这一步不复杂，但能挡掉很多后续误会。把 CLI、技能包集合和发布说明分清楚，再谈安装与管理，文章和实际操作都更稳。实际写稿或发给同事时，我会把“CLI 仓库”和“可安装技能包集合”分成两行写，避免读者复制错对象。遇到页面信息冲突时，以当前 README 和 Vercel 发布页的命令为准，不引用第三方搬运页里的旧写法，这也是入口类文章最该守住的底线。