npx skills 是 Vercel Labs 开发的 Skill 管理工具，GitHub 16,500+ Stars。在 AI Agent Skill 领域，它目前用的人最多、生态最完整——类似于 npm 之于 Node.js、pip 之于 Python。

关键数据：

• 最热门 Skill 累计安装 130 万+
• Microsoft 一家总安装量 540 万+
• 支持 50+ 种 AI 工具
• 生态已有 260+ 个 Skill

如果你想快速给自己的 AI 编程工具装上别人写好的能力，或者想把自己写的好用 Skill 分享出去，这个工具值得一试。

项目定位

npx skills 是 Skill 领域的 npm——安装、更新、删除、搜索，一条命令搞定，不用手动建目录或复制文件。

# 装一个 Skill
npx skills add anthropics/skills --skill commit

# 看装了哪些
npx skills list

CLI 源码：github.com/vercel-labs/skills
Skill 发现和浏览：skills.sh

⚠ 注意：npx skills add 本质上是从 GitHub 下载文件。如果网络环境无法直接访问 GitHub，需要先配置代理。

基本用法

安装 Skill

npx skills add                           # 装某个仓库的全部 Skill
npx skills add  --skill            # 只装某个
npx skills add  -y                       # 跳过确认

# 也支持直接从 URL 安装单个 SKILL.md 文件：
npx skills add https://example.com/my-skill/SKILL.md

安装后，Skill 文件会被放到 .agents/skills/ 目录（项目级）或 ~/.agents/skills/（全局级），同时对已安装的 AI 工具创建对应的符号链接（比如 .claude/skills/）。

指定 AI 工具

默认只会为当前检测到的 AI 工具安装。用 --agent 可以指定：

npx skills add anthropics/skills --skill commit --agent claude-code cursor
npx skills add anthropics/skills --skill commit --agent '*'    # 所有支持的工具

全局 vs 项目安装

npx skills add anthropics/skills --skill commit        # 项目级
npx skills add anthropics/skills --skill commit -g     # 全局级

其他安装选项

查看已安装

npx skills list                # 项目级
npx skills ls -g               # 全局级
npx skills ls -a claude-code   # 按 AI 工具过滤
npx skills ls --json           # JSON 输出，方便脚本

搜索 Skill

find 命令提供交互式搜索，输入关键词就能从 skills.sh 上找到社区 Skill：

npx skills find                # 交互式搜索
npx skills find typescript     # 带关键词搜索

更新 Skill

npx skills update              # 更新所有项目级 Skill
npx skills update my-skill     # 只更新某个
npx skills update -g           # 只更新全局 Skill
npx skills update -p           # 只更新项目级 Skill
npx skills upgrade             # 同 update

更新是基于 Lock 文件中记录的来源去重新拉取。如果你手动改过 Skill 内容，更新会覆盖你的修改。

删除 Skill

npx skills remove              # 交互式选择要删的
npx skills remove my-skill     # 按名称删除
npx skills remove -g           # 从全局删除
npx skills rm --all            # 删除所有（需确认）

创建 Skill

npx skills init my-skill       # 创建 my-skill/SKILL.md

生成的 SKILL.md 包含 frontmatter 模板，编辑完后可以：

• 发布到 GitHub：推到你的仓库，别人就能用 npx skills add 安装
• 托管到任意 URL：别人用 npx skills add https://... 安装

Lock 文件机制

安装 Skill 后会产生 Lock 文件，用来记录安装来源和版本信息。有两套：

全局 Lock 文件

路径：~/.agents/.skill-lock.json

跟踪你全局安装了哪些 Skill。每条记录包含来源、路径、哈希和时间戳：

{
  "version": 3,
  "skills": {
    "mj-design": {
      "source": "makerjackie/skills",
      "sourceType": "github",
      "sourceUrl": "https://github.com/makerjackie/skills",
      "skillPath": "skills/mj-design/SKILL.md",
      "skillFolderHash": "abc123...",
      "installedAt": "2026-04-29T10:00:00.000Z",
      "updatedAt": "2026-04-29T10:00:00.000Z"
    }
  }
}

项目 Lock 文件

路径：项目根目录的 skills-lock.json

设计为提交到 Git。团队成员克隆后，运行 npx skills experimental_install 就能从 Lock 文件恢复所有项目级 Skill（类似 npm install 读 package-lock.json）。

与全局 Lock 的区别：项目 Lock 文件故意不存时间戳，减少 Git 合并冲突。

支持的 AI 工具

npx skills 支持 40+ 种 AI 工具，安装时会自动检测当前环境：

通用目录 .agents/skills/ 是所有"universal agent"共享的位置。

安全审计

Skills.sh 会对首次被安装的 Skill 自动生成安全审计，合作方包括 Gen Agent Trust Hub、Socket、Snyk 等。安装时 CLI 会展示审计结果：

Skilled Name   Gen    Socket    Snyk
mj-writer      Safe   0 alerts  Low Risk

⚠ 安全提示：这不意味着每个 Skill 都安全可靠——审计只覆盖已知风险类别。安装社区 Skill 前，建议先看一眼它的源码。

遥测

CLI 默认开启匿名遥测，只记录安装了哪些 Skill，不收集个人信息。关闭方式：

DISABLE_TELEMETRY=1 npx skills add ...

FAQ

苏米注

npx skills 的出现标志着 AI Agent Skill 生态正在走向标准化。正如 npm 统一了 Node.js 的包管理，npx skills 正在成为 AI 编程工具 Skill 的"包管理器"。

它的价值在于：① 统一安装路径：不再需要手动复制 SKILL.md；② 版本管理：Lock 文件机制让 Skill 可更新、可回滚；③ 跨工具兼容：一套 Skill 同时适配 Claude Code、Cursor、Codex 等 50+ 工具；④ 安全审计：与 Socket、Snyk 合作提供风险检测。

如果你在使用多个 AI 编码工具，或者团队需要统一 Skill 管理，npx skills 是目前最成熟的选择。