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 项目安装

场景	安装位置	理由
每个项目都用	全局 (-g)	省得每个项目装一遍
只在特定项目用	项目级	不污染其他项目的上下文
团队共享	项目 + 提交到 Git	跟着代码走

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

其他安装选项

--copy	复制文件而不是创建符号链接
--all	等同于 --skill '*' --agent '*' -y
--full-depth	即使子目录有 SKILL.md 也搜索更深层
-l, --list	只列出仓库里有哪些 Skill，不实际安装

搜索 Skill
 

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

更新 Skill

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

删除 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://xxx

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"
    }
  }
}

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

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

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

支持的 AI 工具

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

工具	开发方	安装路径
Claude Code	Anthropic	.claude/skills/
Cursor	Cursor Inc.	.cursor/skills/
Codex	OpenAI	.codex/skills/
Cline	开源社区	.cline/skills/
Windsurf	Codeium	.windsurf/skills/
Gemini CLI	Google	.gemini/skills/
Amp	Amplified	.agents/skills/
Goose	开源社区	.goose/skills/

通用目录 .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 add 需要能访问 GitHub。
装完没生效？	用 npx skills list 确认文件在正确目录下；当前对话需要新开一轮才能加载新 Skill。
支持私有仓库吗？	主要支持公开仓库。私有仓库需手动克隆后放到对应目录。
删除会丢改过的内容吗？	会。npx skills remove 会直接删除文件。如果改过，先备份。