Agent Skills CLI：AI编程助手技能管理工具详解

1. 什么是Agent Skills CLI工具

Agent Skills CLI是一个用于管理"智能编码助手技能"的命令行工具。它允许开发者轻松地为各种AI编程助手（如Claude Code、OpenCode、Cursor等）安装、更新和管理扩展技能。

这些技能本质上是一组预定义的指令集，可以增强AI助手在特定场景下的表现。比如：

• 根据git历史自动生成规范的发布说明
• 按照团队约定创建Pull Request
• 与Linear、Notion等工具深度集成

提示：技能通常以SKILL.md文件形式存在，包含YAML元数据和具体的操作指南，可以被多个不同的AI编程助手共享使用。

2. 安装与基础使用

2.1 安装技能

最基本的安装命令格式如下：

bash复制npx skills add vercel-labs/agent-skills

这个命令会从vercel-labs/agent-skills仓库安装所有可用的技能到你的项目中。安装过程是交互式的，CLI会自动检测你本地已安装的AI编程助手，并提示你选择要安装到的目标助手。

2.1.1 支持的来源格式

技能可以从多种来源安装：

bash复制# GitHub简写(owner/repo)
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

2.2 安装选项详解

CLI提供了丰富的选项来控制安装行为：

注意：使用--copy选项会在每个AI助手目录创建技能的独立副本，而默认的符号链接方式则保持单一数据源，更易于更新维护。

3. 高级使用技巧

3.1 安装作用域管理

技能可以安装到两种作用域：

例如，如果你正在开发一个需要特定代码审查技能的项目，应该使用项目级安装：

bash复制npx skills add team-org/code-review-skills

而像代码格式化这类通用技能，则适合全局安装：

bash复制npx skills add standard-org/formatting-skills -g

3.2 批量操作技巧

CLI支持多种批量操作方式：

bash复制# 列出仓库中所有技能
npx skills add vercel-labs/agent-skills --list

# 安装特定技能到特定助手
npx skills add vercel-labs/agent-skills --skill frontend-design --skill skill-creator -a claude-code

# 非交互式安装(适合CI/CD)
npx skills add vercel-labs/agent-skills --skill frontend-design -g -a claude-code -y

# 安装仓库中所有技能到所有助手
npx skills add vercel-labs/agent-skills --all

# 安装所有技能到特定助手
npx skills add vercel-labs/agent-skills --skill '*' -a claude-code

# 安装特定技能到所有助手
npx skills add vercel-labs/agent-skills --agent '*' --skill frontend-design

4. 技能管理命令

4.1 查看已安装技能

bash复制# 列出所有已安装技能(项目和全局)
npx skills list

# 只列出全局技能
npx skills ls -g

# 按助手过滤
npx skills ls -a claude-code -a cursor

4.2 搜索技能

bash复制# 交互式搜索(fzf风格)
npx skills find

# 按关键词搜索
npx skills find typescript

4.3 更新技能

bash复制# 检查技能更新
npx skills check

# 更新所有技能
npx skills update

4.4 移除技能

bash复制# 交互式移除
npx skills remove

# 移除特定技能
npx skills remove web-design-guidelines

# 批量移除
npx skills remove frontend-design web-design-guidelines

# 从全局范围移除
npx skills remove --global web-design-guidelines

# 从特定助手移除
npx skills remove --agent claude-code cursor my-skill

# 无确认移除所有技能
npx skills remove --all

5. 创建自定义技能

5.1 技能文件结构

技能是包含SKILL.md文件的目录，基本结构如下：

markdown复制---
name: my-skill
description: 这个技能的用途和使用场景
---

# 我的技能

AI助手激活此技能后需要遵循的指令。

## 使用场景

描述应该在什么情况下使用这个技能。

## 操作步骤

1. 首先做这个
2. 然后做那个

5.1.1 必填字段

• name: 唯一标识符(小写，可使用连字符)
• description: 技能功能的简要说明

5.1.2 可选字段

yaml复制---
name: my-internal-skill
description: 默认不显示的内部技能
metadata:
  internal: true
---

设置internal: true可以将技能标记为内部使用，只有设置INSTALL_INTERNAL_SKILLS=1时才会显示。

5.2 初始化新技能

bash复制# 在当前目录创建SKILL.md
npx skills init

# 在子目录创建新技能
npx skills init my-skill

6. 支持的AI编程助手

Agent Skills CLI支持40+种AI编程助手，部分示例如下：

注意：Kiro CLI用户需要手动将技能添加到自定义助手的resources配置中：

json复制{
  "resources": ["skill://.kiro/skills/**/SKILL.md"]
}

7. 常见问题排查

7.1 "No skills found"错误

• 确保仓库包含有效的SKILL.md文件
• 检查文件是否包含正确的YAML frontmatter(name和description)

7.2 技能未加载

• 验证技能是否安装到了正确的路径
• 检查AI助手的文档了解技能加载要求
• 确认SKILL.md的YAML语法正确

7.3 权限问题

• 确保对目标目录有写入权限
• 在Linux/macOS上，可能需要使用sudo进行全局安装

8. 环境变量

使用示例：

bash复制INSTALL_INTERNAL_SKILLS=1 npx skills add vercel-labs/agent-skills --list

9. 实际应用建议

1. 团队协作：将常用的代码规范、PR模板等技能放在团队共享仓库，统一安装确保一致性
2. 个人效率：创建个性化技能如常用代码片段、项目初始化模板等
3. CI/CD集成：使用-y选项在自动化流程中安装必要技能
4. 技能组合：将多个相关技能组合使用，如前端开发技能包(包含React规范、CSS指南等)

我在实际使用中发现，定期运行npx skills update保持技能更新很重要，特别是当依赖的技能仓库有重大改进时。同时，建议将项目级技能的安装命令写入项目文档或README，方便新成员快速配置环境。