vercel-labs/skills · 上手攻略

仓库：vercel-labs/skills
链接：https://github.com/vercel-labs/skills
分类：Agent 工具链
作者：Tom
更新：2026-08-07

这是什么

vercel-labs/skills 是 Vercel Labs 出品的开源 Agent Skills 工具链：一个统一的 CLI + 生态系统，让 AI Coding Agent（Claude Code、Codex、Cursor 等 72+ 种）可以像装 npm 包一样发现、安装、管理 Skills——即那种定义在 SKILL.md 文件里的可复用指令集。

Skills.sh（skills.sh）是其配套的开放技能市场。

解决什么问题

AI Agent 天然被局限在"它训练时见过的东西"里。Skills 将专业领域的 SOP、工具调用约定、领域知识打包成 SKILL.md，让 Agent 在遇到特定任务时自动触发对应的 Skill——无需每次手动喂 Prompt，也无需把专业知识塞进系统 Prompt 导致上下文爆炸。

快速安装

# 安装 CLI（Node.js ≥18）
npx skills --version          # 快速验版本

# 添加一个技能库（skills 是一组 SKILL.md 的集合）
npx skills add vercel-labs/agent-skills

# 全局安装（跨项目可用）
npx skills add vercel-labs/agent-skills -g

# 非交互式 / CI 友好
npx skills add vercel-labs/agent-skills --skill frontend-design -g -a claude-code -y

安装时选择 Symlink（推荐）或 Copy 模式；Symlink 更新源文件后所有 Agent 自动生效。

核心用法

发现与安装

# 列出某仓库所有可用 Skills
npx skills add vercel-labs/agent-skills --list

# 安装指定 Skill
npx skills add vercel-labs/agent-skills --skill web-design-guidelines --skill frontend-design

# 安装到特定 Agent（支持 claude-code / opencode / cursor 等）
npx skills add vercel-labs/agent-skills -a claude-code -a opencode

# 安装到所有 Agent
npx skills add vercel-labs/agent-skills --all

# 从 GitHub 路径直接安装
npx skills add https://github.com/vercel-labs/agent-skills/tree/main/skills/web-design-guidelines

运行时使用

# 不安装，直接在 stdout 输出 Skill 内容（可 pipe 给 Agent）
npx skills use vercel-labs/agent-skills@web-design-guidelines | claude

# 指定 Agent 启动交互式会话
npx skills use vercel-labs/agent-skills --skill web-design-guidelines --agent claude-code

管理已安装 Skills

npx skills list              # 列出已安装（项目 + 全局）
npx skills ls -g            # 只看全局
npx skills ls -a claude-code -a cursor   # 按 Agent 过滤

npx skills find typescript   # 交互式模糊搜索（或关键词搜索）
npx skills find react --owner vercel     # 搜指定组织

npx skills update            # 更新全部（交互式选择范围）
npx skills update -g        # 只更全局
npx skills update my-skill  # 更新单个

npx skills rm web-design-guidelines     # 移除
npx skills rm --global my-skill        # 从全局移除

创建新 Skill

npx skills init              # 在当前目录生成 SKILL.md 模板
npx skills init my-skill     # 在子目录

典型适用场景

场景	推荐 Skill 类型
新项目初始化 + 团队代码规范	`skill-creator` / 自定义规范 Skill
快速上手陌生代码库	`brainstorming` / `find-skills`
持续维护多 Agent 工具链	全局安装 + `skills update` 批量管理
CI/CD 中验证 Agent 行为一致性	`--yes` 非交互式安装 + `skills list` 检查
团队共享 Prompt 工程经验	内部 Git 仓库 → `skills add` 地址分发

坑与注意

安装路径决定作用域：不加 -g 默认装在 ./<agent>/skills/（项目级），需提交到 Git 才能团队共享；-g 装在 ~/<agent>/skills/，仅本地有效。
Symlink vs Copy：Copy 模式下更新 Skill 后 Agent 不会自动感知，需要重新安装；推荐 Symlink。
Agent 对 Skill 文件的触发方式：各 Agent 解析 SKILL.md 的时机和触发词匹配逻辑不同（非标准化），同个 Skill 在不同 Agent 里可能行为差异，需要实测。
Skill 来源信任：Skills.sh 上传 Skill 无需审核，使用前建议读一遍 SKILL.md 内容，防止恶意 Prompt 注入。
国内网络：npx 依赖 npm 官方 registry，国内可能慢，可配置 npm config set registry https://registry.npmmirror.com。

与同类对比

方案	定位	优势	劣势
`vercel-labs/skills`（本文）	通用 Agent Skill 包管理器	72+ Agent 支持、npx 即装、Skills.sh 市场	Skill 格式各家不统一，体验碎片化
Anthropic 官方 `skill-creator`	Skill 创作规范	权威格式定义，Claude Code 原生支持	仅限 Claude，无市场无分发
`iflytek/skillhub`	企业私有 Skill 注册表	自托管 + RBAC + 版本管理，适合企业内网	需额外部署，不支持跨公网团队
OpenClaw 技能系统	自家 Agent 能力扩展	与 OpenClaw 原生集成	非通用，仅限 OpenClaw 实例

一句话推荐结论

如果你在使用任何主流 Coding Agent（尤其是 Claude Code / Codex / Cursor），vercel-labs/skills 是零成本扩展其能力的首选工具——装上 skill-creator + brainstorming + find-skills 三个核心 Skill，Agent 马上变得更专业、更可控。

原始来源：GitHub README · agenticskills.io/skills · 同步时间参考：2026-08-07