https://github.com/vercel-labs/skills#readme 这是一个由 Vercel Labs 推出的开源命令行工具，旨在帮助开发者管理和分发“代理技能”（Agent Skills）。

简单来说，“代理技能”就是给 AI 编码代理（如 Cursor、Claude Code 等）写的标准化提示词（Prompt）。这个工具能帮你轻松地在不同的 AI 代理之间共享和管理这些技能。

🛠️ 核心功能速览

• 统一管理：支持 OpenCode、Claude Code、Codex、Cursor 等 50+ 种主流 AI 代理。
• 便捷安装：通过 npx skills add 命令，可以从 GitHub、GitLab 或本地路径一键安装技能包。
• 多级作用域：
  • 项目级：技能安装在当前项目目录下，方便团队共享。
  • 全局级：使用 -g 参数，技能安装在用户目录，所有项目通用。
• 智能链接：默认使用符号链接（Symlink），确保技能更新时只需修改一份源文件。
• 技能发现：内置 find 命令，可以搜索和浏览可用的技能库。

🚀 快速入门指南

1. 安装与初始化

你不需要全局安装，直接使用 npx 即可运行：

# 添加一个技能仓库（例如官方示例）
npx skills add vercel-labs/agent-skills

2. 常用命令速查表

3. 高级使用技巧

• 精准安装：

  • 指定代理：如果你只想给 Cursor 和 Claude 安装，使用 -a 参数：

    npx skills add vercel-labs/agent-skills -a cursor -a claude-code
    

  • 指定技能：如果仓库里有很多技能，只想装某一个（比如“前端设计”）：

    npx skills add vercel-labs/agent-skills --skill frontend-design
    

  • 通配符：安装所有技能或所有代理：

    # 安装所有技能到所有代理
    npx skills add vercel-labs/agent-skills --all
    

• 作用域选择：

  • 默认情况下，技能会安装到当前项目（./.agents/skills/）。
  • 如果想让技能在所有项目中生效，加上 -g 参数：

    npx skills add vercel-labs/agent-skills -g
    

• 非交互模式：

  • 在 CI/CD 或自动化脚本中，可以使用 -y 参数跳过所有确认提示：

    npx skills add vercel-labs/agent-skills -y
    

📝 技能开发规范

如果你打算自己创建一个技能，只需要一个包含 SKILL.md 的文件夹：

1. 文件结构：

   my-skill/
   └── SKILL.md
   

2. SKILL.md 格式：
   文件开头必须包含 YAML Frontmatter，定义 name 和 description：

   ---
   name: my-skill
   description: 这是一个示例技能，用于演示如何编写技能
   metadata:
     internal: false # 设为 true 可隐藏该技能
   ---
   
   # 我的技能指南
   
   这里写具体的提示词指令，告诉 AI 该如何执行任务。
   
   ## 执行步骤
   1. 第一步做什么
   2. 第二步做什么
   

💡 排错与提示

• 提示 “No skills found”：
  • 请检查目标仓库的根目录或 skills/ 目录下是否存在格式正确的 SKILL.md 文件。
  • 确保文件头部的 YAML 格式正确（冒号后要有空格）。
• 代理不加载技能：
  • 检查技能是否安装到了正确的路径（项目路径 vs 全局路径）。
  • 部分代理（如 Kiro CLI）可能需要手动在配置文件中添加资源路径。
• 权限错误：
  • 如果遇到权限问题，请确保你对目标安装目录有读写权限。

这个工具目前在 GitHub 上非常受欢迎（已有 20k Stars），对于提升 AI 编程效率非常有帮助。你可以先从官方的 agent-skills 仓库开始尝试！