AI 编程工具 Skills 使用指南：通过 npx skills 安装、管理和卸载技能

一、什么是 Skills？

随着 Claude Code、Codex、Cursor 等 AI 编程工具的发展，AI 已经不仅能够回答问题、生成代码，还可以通过 Skills（技能） 扩展自身的能力。

简单来说，Skill 就是一套可复用的 AI 工作规范或操作指南，用于告诉 AI 在特定场景下应该如何执行任务。

例如：

  • 前端开发：遵循特定的 UI 设计规范。

  • 代码审查：按照预设规则检查代码质量。

  • 测试开发：指导 AI 编写和执行测试。

  • 文档编写：按照统一规范生成技术文档。

  • 自动化任务：按照指定的工作流程完成复杂操作。

可以把 Skill 理解为给 AI 安装的一个“技能包”。

需要注意的是，Skill 不一定是可执行程序。很多 Skill 的核心就是一个 Markdown 文件，用来描述任务的执行方式。

1.1 Skill 的基本结构

一个简单的 Skill 目录如下：

my-skill/
├── SKILL.md
├── scripts/
├── references/
└── assets/

其中：

文件或目录作用
SKILL.md 核心文件，定义技能名称、描述和执行规范
scripts/ 可选，存放辅助脚本
references/ 可选，存放参考文档
assets/ 可选，存放资源文件

一个简单的 SKILL.md 示例：

---
name: code-review
description: 用于检查代码质量和潜在问题
---

# Code Review

当用户要求检查代码时：

1. 分析代码逻辑。
2. 检查潜在异常。
3. 检查资源释放问题。
4. 检查性能问题。
5. 提供修复建议。

当 AI 识别到相关任务，或者用户明确调用该 Skill 时，就可以按照其中的规范执行。

具体如何发现和加载 Skill，取决于所使用的 AI 编程工具。

二、什么是 npx skills？

npx skills 是 Vercel Labs 提供的开源 Skills 命令行管理工具。

GitHub 地址：

https://github.com/vercel-labs/skills

Skills 目录网站：

https://skills.sh/

通过这个工具，可以统一管理不同 AI 编程工具使用的 Skills。

主要功能包括：

  • 搜索 Skills

  • 安装 Skills

  • 查看已经安装的 Skills

  • 更新 Skills

  • 卸载 Skills

  • 创建自己的 Skills

它支持 Claude Code、Codex、Cursor、OpenCode 等多种 AI 编程工具。

2.1 使用前提

需要提前安装 Node.js 和 npm。

检查 Node.js 版本：

node -v

检查 npm 版本：

npm -v

检查 npx：

npx -v

如果能够正常输出版本号，说明已经具备运行条件。

由于使用的是 npx，因此通常不需要提前全局安装 skills CLI。

首次运行时，npx 会根据需要下载对应的 npm 包。

三、搜索 Skills

在安装之前，可以先搜索需要的 Skill。

3.1 交互式搜索

npx skills find

执行后可以通过交互式界面搜索和选择 Skills。

3.2 根据关键词搜索

例如搜索 React 相关技能：

npx skills find react

搜索 TypeScript：

npx skills find typescript

搜索测试相关技能：

npx skills find testing

也可以直接访问：

https://skills.sh/

通过网站浏览现有 Skills，查看对应的安装命令。

四、安装 Skills

4.1 基础安装

基本语法：

npx skills add <仓库地址>

例如：

npx skills add vercel-labs/agent-skills

这里的：

vercel-labs/agent-skills

代表 GitHub 仓库：

https://github.com/vercel-labs/agent-skills

执行命令后，CLI 会根据仓库中的 Skills 和本地 AI 工具情况，引导用户选择要安装的技能及目标工具。

4.2 安装指定 Skill

如果仓库包含多个 Skills，可以使用 --skill 指定名称。

例如：

npx skills add vercel-labs/agent-skills --skill web-design-guidelines

也可以指定多个：

npx skills add vercel-labs/agent-skills \
  --skill web-design-guidelines \
  --skill frontend-design

在 Windows PowerShell 中，建议将命令写在同一行。

4.3 查看仓库中有哪些 Skills

不确定仓库包含哪些 Skill 时，可以执行：

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

该命令只列出仓库中的技能，不会安装。

确认名称后，再通过 --skill 安装。

4.4 给 Claude Code 安装 Skill

使用 -a 指定目标 AI 工具：

npx skills add vercel-labs/agent-skills --skill web-design-guidelines -a claude-code

其中：

-a claude-code

表示将 Skill 安装到 Claude Code 对应位置。

4.5 给 Codex 安装 Skill

npx skills add vercel-labs/agent-skills --skill web-design-guidelines -a codex

同一个 Skill 可以提供给不同的 AI 编程工具使用，但实际兼容性仍然取决于 Skill 的具体内容。

4.6 同时安装到多个 AI 工具

npx skills add vercel-labs/agent-skills \
  --skill web-design-guidelines \
  -a claude-code -a codex

这样可以在 Claude Code 和 Codex 中使用同一套技能规范。

五、项目级安装与全局安装

Skills 支持两种主要安装范围：

项目级安装和全局安装。

5.1 项目级安装

默认情况下，不指定 -g，会安装到当前项目。

例如：

npx skills add vercel-labs/agent-skills --skill web-design-guidelines -a claude-code

对于 Claude Code，典型目录结构：

my-project/
├── .claude/
│   └── skills/
│       └── web-design-guidelines/
├── src/
└── package.json

特点：

  • 主要在当前项目使用。

  • 可以根据项目需求配置不同 Skills。

  • 可以将 Skills 相关文件提交到 Git 仓库，与团队共享。

适合项目专用的代码规范、开发流程和业务规则。

5.2 全局安装

如果希望所有项目都能使用，可以增加 -g 参数。

npx skills add vercel-labs/agent-skills --skill web-design-guidelines -g -a claude-code

对于 Claude Code，全局 Skill 通常位于：

~/.claude/skills/

Windows 中对应用户目录下的：

C:\Users\用户名\.claude\skills\

全局安装适合通用技能，例如代码审查、文档生成和开发规范。

5.3 两种安装方式的区别

对比项项目级安装全局安装
参数 默认 -g
作用范围 当前项目 用户的多个项目
Claude Code 常见位置 .claude/skills/ ~/.claude/skills/
适用场景 项目专用规范 通用开发技能

个人建议：

通用 Skills 使用全局安装，项目特殊需求使用项目级安装，避免所有项目加载大量不必要的技能。

另外，Skills CLI 可能使用符号链接，将 Agent 目录链接到统一管理的技能副本，因此实际目录结构可能略有差异。

六、查看已经安装的 Skills

6.1 查看已安装的 Skills

npx skills list

也可以使用简写：

npx skills ls

用于查看当前项目和全局范围内已安装的 Skills。

6.2 只查看全局 Skills

npx skills list -g

6.3 只查看 Claude Code 的 Skills

npx skills list -a claude-code

如果同时安装了 Claude Code、Codex 等多个 AI 工具，可以使用该参数进行筛选。

七、如何使用已经安装的 Skill？

安装完成后，Skills 的调用方式由具体 AI 工具决定。

以 Claude Code 为例。

7.1 启动 Claude Code

进入项目目录：

cd my-project

启动：

claude

7.2 自动使用

当用户的任务符合 Skill 的描述时，Claude Code 可以根据技能描述选择相应的 Skill。

例如已经安装了代码审查相关 Skill，可以提出：

帮我检查当前项目的代码质量，重点分析异常处理、
资源释放、潜在性能问题，并给出修复建议。

AI 可以根据任务内容决定是否使用已安装的 Skill。

需要注意：安装 Skill 不代表每次执行任务都会自动调用。

7.3 手动调用

对于支持直接调用的 Claude Code Skill，可以通过对应名称调用，例如：

/web-design-guidelines

具体名称以安装的 Skill 及 Claude Code 实际识别结果为准。

也可以直接在任务中说明：

请按照 web-design-guidelines Skill 的规范，
检查并优化当前项目的前端页面。

八、更新 Skills

已经安装的 Skills 可能会持续更新。

可以通过 update 命令获取更新。

8.1 更新 Skills

npx skills update

默认会根据交互提示选择更新范围。

8.2 更新指定 Skill

npx skills update web-design-guidelines

8.3 更新全局 Skills

npx skills update -g

8.4 更新当前项目的 Skills

npx skills update -p

8.5 跳过交互确认

npx skills update -y

注意：-y 会跳过部分交互提示，更新范围需要根据当前所在目录及 CLI 行为判断。

九、卸载 Skills

如果某个 Skill 不再需要，可以使用 remove 命令卸载。

9.1 交互式卸载

npx skills remove

执行后可以选择需要卸载的 Skill。

9.2 卸载指定 Skill

npx skills remove web-design-guidelines

9.3 卸载多个 Skills

npx skills remove frontend-design web-design-guidelines

9.4 卸载全局 Skill

npx skills remove web-design-guidelines -g

-g 表示操作全局安装范围。

9.5 只从 Claude Code 中卸载

npx skills remove web-design-guidelines -a claude-code

如果同一个 Skill 同时安装到了 Claude Code 和 Codex，那么指定 -a claude-code 可以只移除 Claude Code 对应的安装。

9.6 卸载 Claude Code 的所有项目级 Skills

npx skills remove --skill '*' -a claude-code

如果需要卸载全局范围内 Claude Code 的全部 Skills：

npx skills remove --skill '*' -a claude-code -g

执行批量删除前，建议先查看当前已安装的 Skills，避免误删。

9.7 卸载所有 Skills

npx skills remove --all

该命令会针对当前操作范围移除所有 Agent 的 Skills，并跳过确认。

如果要操作全局范围，则需要增加 -g：

npx skills remove --all -g

这类命令影响范围较大，建议谨慎使用。

十、创建自己的 Skill

除了安装别人提供的 Skill，还可以创建自己的 Skill。

10.1 初始化 Skill

npx skills init my-skill

会创建一个基础 Skill 模板。

10.2 修改 SKILL.md

例如创建一个用于 C# 代码审查的 Skill。

---
name: csharp-code-review
description: 检查 C# 项目代码质量、异常处理与资源释放问题
---

# C# Code Review

## 检查目标

分析当前 C# 项目的代码质量。

## 检查要求

1. 检查异常处理是否完整。
2. 检查 IDisposable 资源是否正确释放。
3. 检查文件流、数据库连接和网络连接是否泄漏。
4. 检查并发访问中的线程安全问题。
5. 检查潜在性能问题。

## 修复规则

发现明确的问题后：

1. 优先进行最小范围修改。
2. 避免改变原有业务逻辑。
3. 保持现有项目的代码风格。
4. 说明修改的原因。
5. 在条件允许时运行构建和相关测试。

创建完成后，可以将其安装到支持的 AI 编程工具中。

也可以直接在工具规定的 Skills 目录下创建对应文件夹和 SKILL.md。

对于需要长期维护的团队规范，自定义 Skill 可以减少重复编写提示词的工作。

十一、常用命令速查表

命令说明
npx skills find 交互式搜索 Skills
npx skills find react 根据关键词搜索
npx skills add owner/repo 安装 Skills
npx skills add owner/repo --list 查看仓库 Skills
npx skills add owner/repo -g 全局安装
npx skills add owner/repo -a claude-code 安装到 Claude Code
npx skills add owner/repo -a codex 安装到 Codex
npx skills list 查看已安装 Skills
npx skills list -g 查看全局 Skills
npx skills update 更新 Skills
npx skills update -g 更新全局 Skills
npx skills remove 交互式卸载
npx skills remove skill名称 卸载指定 Skill
npx skills remove skill名称 -g 卸载全局 Skill
npx skills remove --all 卸载当前范围所有 Skills
npx skills init my-skill 创建 Skill 模板

十二、使用 Skills 的注意事项

12.1 不要盲目安装大量 Skills

Skills 越多，并不意味着 AI 的执行效果一定越好。

如果存在多个功能相似、规范互相冲突的 Skill，反而可能影响 AI 对任务的判断。

建议只安装实际需要的 Skills，并定期清理不再使用的技能。

12.2 注意第三方 Skill 的安全性

第三方 Skill 可能包含：

  • Shell 命令

  • Python、Node.js 等执行脚本

  • 外部网络访问

  • 文件修改操作

  • 其他工具调用指令

因此安装前最好查看 SKILL.md 和附带的脚本，确认来源可信。

不要在未经审查的情况下让 AI 执行涉及敏感信息、生产环境或重要文件的操作。

12.3 区分 Skill 和 MCP

Skill 和 MCP 都能扩展 AI 的能力，但两者并不是同一概念。

对比项SkillMCP
核心作用 定义 AI 如何完成任务 为 AI 提供外部工具与数据能力
主要形式 Markdown 指令、脚本、参考资料 MCP Server 提供的工具及资源
使用场景 工作流程、开发规范、任务指导 数据库访问、外部 API、工具集成
是否需要运行服务 通常不需要 通常需要相应的服务或连接

例如：

Skill 可以告诉 AI 如何进行代码审查，而 MCP 可以向 AI 提供访问某个外部系统的工具。

两者可以配合使用。

十三、总结

npx skills 提供了一种统一管理 AI 编程技能的方法。

对于同时使用 Claude Code、Codex、Cursor 等开发工具的用户，可以通过一个 CLI 完成技能的搜索、安装、更新和卸载。

日常最常用的命令其实只有以下几个：

# 搜索
npx skills find

# 安装
npx skills add owner/repo

# 全局安装到 Claude Code
npx skills add owner/repo -g -a claude-code

# 查看
npx skills list

# 更新
npx skills update

# 卸载
npx skills remove

通过合理使用 Skills，可以让 AI 更好地遵循固定的开发规范和工作流程，减少重复输入提示词，提高 AI 辅助开发的一致性。

参考资料：

posted @ 2026-10-13 14:07  曲琦  阅读(53)  评论(0)    收藏  举报