ByteNoteByteNote
字

字节笔记本

2026年3月13日

Vercel Skills：开放代理技能生态系统 CLI

#Skills
API中转
¥120

本文介绍 Vercel Skills CLI，一个为开放代理技能生态系统设计的命令行工具。该项目由 Vercel Labs 开发，支持 40+ 种 AI 代理（包括 OpenCode、Claude Code、Codex、Cursor 等），提供了统一的技能安装、管理和分发能力，是 AI 代理技能的标准包管理器。

项目简介

Vercel Skills CLI 是一个开源的命令行工具，类似于 npm 用于 JavaScript 包，但专门用于 AI 代理技能。项目遵循开放代理技能生态系统标准，让开发者能够轻松地发现、安装、管理和分享 AI 技能。

核心特性

  • 多代理支持：支持 40+ 种 AI 代理
  • 统一接口：标准的技能安装和管理命令
  • 多种来源：支持 GitHub、GitLab、本地路径等
  • 灵活配置：支持全局和项目级安装
  • 技能列表：查看和管理已安装技能
  • 开放生态：遵循开放标准，社区驱动

支持的代理

项目支持以下 AI 代理（部分列表）：

  • OpenCode：OpenAI 的代码生成代理
  • Claude Code：Anthropic 的 Claude 编程助手
  • Codex：OpenAI Codex 代码生成
  • Cursor：AI 代码编辑器
  • 以及 37+ 更多代理

安装指南

基本使用

bash
# 安装技能到项目
npx skills add vercel-labs/agent-skills

# 全局安装
npx skills add vercel-labs/agent-skills --global

# 安装到特定代理
npx skills add vercel-labs/agent-skills --agent claude-code

来源格式

bash
# GitHub 简写
npx skills add vercel-labs/agent-skills

# 完整 GitHub URL
npx skills add https://github.com/vercel-labs/agent-skills

# 仓库中的特定技能
npx skills add https://github.com/vercel-labs/agent-skills/tree/main/skills/web-design-guidelines

# GitLab URL
npx skills add https://gitlab.com/org/repo

# 任何 git URL
npx skills add git@github.com:vercel-labs/agent-skills.git

# 本地路径
npx skills add ./my-local-skills

命令选项

选项说明
-g, --global安装到用户目录而非项目
-a, --agent目标特定代理（如 claude-code、codex）
-s, --skill安装特定技能（使用 '*' 安装所有）
-l, --list列出可用技能而不安装
--copy复制文件而非创建符号链接
-y, --yes跳过所有确认提示
--all安装所有技能到所有代理

使用示例

列出技能

bash
# 列出仓库中的技能
npx skills add vercel-labs/agent-skills --list

# 输出示例：
# react-best-practices
# web-design-guidelines
# react-native-guidelines
# composition-patterns

安装特定技能

bash
# 安装特定技能
npx skills add vercel-labs/agent-skills --skill frontend-design --skill skill-creator

# 安装带空格的技能（必须引号）
npx skills add owner/repo --skill "Convex Best Practices"

全局安装

bash
# 全局安装技能
npx skills add vercel-labs/agent-skills --global

# 这会在用户目录创建技能
# 可在所有项目中使用

技能生态系统

技能发现

bash
# 从 GitHub 发现
npx skills search vercel-labs

# 从 GitLab 发现
npx skills search org/repo

# 本地发现
npx skills list

技能分享

bash
# 发布你的技能
npx skills publish ./my-skills

# 更新已发布技能
npx skills update ./my-skills

技能版本管理

bash
# 查看技能版本
npx skills info react-best-practices

# 更新技能
npx skills update react-best-practices

# 卸载技能
npx skills uninstall react-best-practices

工作流程

1. 技能创建

bash
# 创建技能目录
mkdir my-skills
cd my-skills

# 创建技能文件
mkdir skills
echo "# My Skill" > skills/my-skill/SKILL.md

2. 技能测试

bash
# 本地测试
npx skills test ./my-skills

# 在特定代理中测试
npx skills test ./my-skills --agent claude-code

3. 技能发布

bash
# 发布到 GitHub
git init
git add .
git commit -m "Initial commit"
git remote add origin https://github.com/username/my-skills.git
git push -u origin main

# 通过 skills CLI 发布
npx skills publish https://github.com/username/my-skills

配置文件

skills.config.json

json
{
  "skills": [
    {
      "name": "react-best-practices",
      "version": "1.0.0",
      "source": "vercel-labs/agent-skills",
      "agents": ["claude-code", "cursor"]
    }
  ],
  "globalPath": "~/.skills",
  "projectPath": ".skills"
}

环境变量

bash
# 自定义技能目录
export SKILLS_PATH=/custom/path

# 自定义代理目录
export AGENTS_PATH=/custom/agents

# 调试模式
export SKILLS_DEBUG=1

最佳实践

1. 技能组织

bash
# 按功能组织技能
my-skills/
├── skills/
│   ├── frontend/
│   │   ├── react/
│   │   └── vue/
│   └── backend/
│       ├── python/
│       └── node/

2. 版本管理

bash
# 使用语义化版本
# 1.0.0 → 1.0.1 → 1.1.0 → 2.0.0

# 在技能文件中指定版本
# version: 1.0.0

3. 文档完善

markdown
# SKILL.md 应包含：
- 技能描述
- 使用场景
- 触发条件
- 工作流程
- 示例代码

常见问题

Q: 如何卸载技能？

bash
npx skills uninstall skill-name

Q: 如何更新所有技能？

bash
npx skills update --all

Q: 技能安装到哪里？

bash
# 项目级：./.skills/
# 全局：~/.skills/

Q: 如何查看已安装技能？

bash
npx skills list

生态系统

技能仓库

相关工具

项目链接

Skills
上一篇

CoPaw：AI 代理协作平台

下一篇

Vercel Skills：开放代理技能生态系统 CLI

分享: