skills 是什么?

vercel-labs/skills 是『开放 Agent Skills 生态』的命令行工具——就是本批众多技能项目里反复出现的那个 `npx skills add ...`。它相当于 Agent Skills 的包管理器:从 GitHub(owner/repo 简写或完整 URL)、GitLab、任意 git URL 或本地路径,把 SKILL.md 技能安装到 55+ 个支持的 agent(OpenCode、Claude Code、Codex、Cursor 等)。命令含 add/list/find(fzf 式搜索)/update/init(建 SKILL.md)/remove,支持项目级或全局、符号链接或复制、交互或 CI 友好的非交互模式。TypeScript,配套站点 skills.sh。它不是技能本身,而是装/管/查技能的工具。

⭐ 20,124 Stars 🍴 1,619 Forks TypeScript 作者: vercel-labs
来源:README 顶部/Install a Skill/Other Commands;GitHub desc 查看 GitHub 仓库 →

为什么值得关注

约 1.97 万星,热度因为它是 Agent Skills 生态的事实标准安装器:本批里那么多 skill 项目(pua、geo-seo、claude-scientific-skills 等)的安装说明都是 `npx skills add`,而这个仓库就是该命令的实现。Vercel Labs 出品、跨 55+ agent、一行装任意 git 来源的技能——它把『发现-安装-更新技能』这件事标准化了,是生态的关键基础设施,自然高星。

来源:GitHub 19,725 stars / 1,589 forks,created 2026-01-14;README 顶部

核心功能

从任意来源装技能

支持 GitHub 简写(owner/repo)、完整 GitHub/GitLab URL、仓库内技能的直接路径、任意 git URL、以及本地路径;`npx skills add ` 一行安装。

来源:README Install a Skill/Source Formats
55+ agent 目标

可装到 OpenCode、Claude Code、Codex、Cursor 等 55+ 个支持的 agent,用 -a 指定目标 agent、-s 指定具体技能('*' 装全部)、--all 全装,自动适配各 agent 的技能目录。

来源:README 顶部(55 agents)/Options
完整的技能管理命令

skills add(装)、list(列已装的项目/全局技能、可按 agent 过滤)、find(fzf 式交互/关键词搜索)、update(更新单个/多个/全部,自动判断 scope)、init(在当前目录建 SKILL.md)、remove(交互或指定移除)。

来源:README Other Commands
项目/全局 scope + 符号链接/复制

可装到项目(默认)或用户全局目录(-g);默认符号链接到各 agent 目录、--copy 改为复制文件;-y 跳过确认、非交互安装对 CI/CD 友好。

来源:README Options/Installation Scope/Installation Methods
skills.sh 配套生态

配套网站 skills.sh 提供技能徽章与发现入口,与 Agent Skills 开放标准(SKILL.md 格式)配合,让技能像 npm 包一样被分享、安装、更新。

来源:README 顶部(skills.sh 徽章)

技术架构

TypeScript 实现的 CLI(npm 包,bin/ 提供 skills 命令,src/ 是实现,pnpm + 构建配置)。核心是『来源解析 → 拉取技能 → 适配各 agent 目录 → 装/链/复制 → 管理』:解析 GitHub/GitLab/git/本地多种来源,识别其中的 SKILL.md 技能,按目标 agent(55+,各有自己的技能目录约定)安装到项目或全局,默认符号链接、可复制,并维护已装清单供 list/update/remove。skills/ 放自带技能(含 init 模板等),tests/ 测试,scripts/ 工具。它消费的是 Agent Skills 开放标准(SKILL.md 格式),自己是该格式的『包管理器/分发器』,对上对接 skills.sh 生态。整体是『多源解析 + 多 agent 适配 + 安装/更新/搜索命令』的技能 CLI 工具,无运行时服务,价值在于把技能的分发与管理标准化、跨 agent 通用。

来源:README Install/Other Commands;tree(bin/、src/、skills/、tests/)

项目知识图谱

知识图谱:项目核心节点(中心)+ 核心功能(内环六边形)+ 关键技术依赖(外环 chip) Agent Skills(SKILL.md 格式)Agent Skills(… git(拉取来源) 55+ agent 目录适配(Claude Code/Codex/Cursor/OpenCode 等)55+ agent 目录… fzf 式搜索(find)fzf 式搜索(fin… pnpm 从任意来源装技能 55+ agent 目标 完整的技能管理命令 项目/全局 scope + 符号链接/复制项目/全局 scope + 符… skills.sh 配套生态 skills 项目本体 核心功能 关键依赖

中心为项目本体,内环 = 核心功能模块,外环 = 关键技术依赖;按 deep.json 中的 core_features 与 tech_stack.key_deps 自动生成

技术栈

语言TypeScript (Node.js)框架CLI(npx skills)
Agent Skills(SKILL.md 格式)git(拉取来源)55+ agent 目录适配(Claude Code/Codex/Cur…fzf 式搜索(find)pnpm
本地 CLI(npx 即用);从 GitHub/GitLab/git/本地装到项目或全局;符号链接或复制
来源:README Install/Options;package.json

快速上手

无需安装,直接 `npx skills add <来源>`,来源可以是 owner/repo、完整 GitHub/GitLab URL、仓库内技能路径、任意 git URL 或本地路径。常用:`-l` 先列出仓库里的技能、`-s` 装指定技能('*' 全装)、`-a` 指定目标 agent(如 claude-code codex)、`-g` 装到全局、`--copy` 复制而非链接、`-y/--all` 非交互。其他命令:`skills list`(看已装)、`skills find`(搜索)、`skills update`(更新)、`skills init`(在当前目录建 SKILL.md)、`skills remove`(移除)。
来源:README Install a Skill/Examples/Other Commands

使用场景

适合:①用 Claude Code/Codex/Cursor/OpenCode 等、想一行安装/更新/管理 Agent Skills 的人;②skill 作者,想让用户用 `npx skills add owner/repo` 装自己的技能、或用 `skills init` 起新技能;③要把技能装进 CI/CD(非交互)或同时分发给多个 agent 的团队。不适合:不使用支持 Agent Skills 的 agent 的人;以及想要技能内容本身的人——这是装技能的工具,技能在各自仓库。

来源:README Install/Other Commands,结合定位推断

优势与局限

优势

  • 生态基础设施:是 `npx skills add` 的实现,本批大量技能都靠它安装,地位关键
  • 来源与目标都广:GitHub/GitLab/git/本地多源 × 55+ agent,一行装到位、跨 agent 通用
  • 命令完整:add/list/find/update/init/remove,像 npm 一样管理技能,项目/全局 scope 清晰
  • 工程友好:符号链接或复制、非交互模式适配 CI/CD、Vercel Labs 出品、配 skills.sh 发现
  • 降低生态摩擦:让技能的分享/安装/更新标准化,推动 Agent Skills 普及

局限

  • 本身是工具不是技能,价值靠生态——没有可用技能时它只是个安装器
  • GitHub 未标注 LICENSE(license=null),商用/再分发前需确认条款
  • 技能会带可执行 scripts,安装即引入第三方代码,安全性需用户自行甄别(任意 git 源风险更高)
  • 55+ agent 的适配深浅可能不一,个别 agent 的安装/识别行为有差异
  • 依赖 Agent Skills 标准与各 agent 支持,标准/生态变动会影响它
来源:README Install/Options;license 状态与第三方代码风险推断

最新版本

以 npm 包(npx skills)持续发布,主分支高频更新(最近 push 2026-05-22,创建于 2026-01-14)。支持的 agent 数量随生态扩充(README 标注 55+),配套 skills.sh,是 Agent Skills 生态里活跃维护的核心 CLI。

来源:GitHub pushed_at 2026-05-22;README 顶部(55 agents)

总结评价

vercel-labs/skills 是 Agent Skills 生态的『包管理器』:本批里那么多技能的安装说明都是 `npx skills add`,而这就是它的实现——从 GitHub/GitLab/git/本地一行装技能到 55+ 个 agent,再加 list/find/update/init/remove 一整套像 npm 的命令,把技能的分发与管理标准化、跨 agent 通用,Vercel Labs 出品、近 2 万星,是生态的关键基础设施。要清楚它是工具不是技能——价值依赖生态,且安装技能等于引入第三方(含可执行脚本)代码、任意 git 源需自行甄别安全,许可证也未标注。对在用支持 Skills 的 agent、想方便地装管技能或分发自己技能的人,这基本是默认工具;只想要某个技能内容的人则去对应仓库。

来源:综合 README 定位/命令/生态、tree 工程结构、安全与许可证的事实判断
透明度声明
本页内容由 AI(大语言模型)基于以下公开材料自动生成:GitHub README、代码目录结构、依赖文件、Release 信息。 分析时间: 2026-05-23 17:06. 质量评分: 100/100.

数据来源:README、GitHub API、依赖文件