npx skills : 最佳 Skills 管理工具完整指南

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

npx skills 是 Vercel Labs 开发的 Skill 管理工具。功能上你可以把它理解成 Skill 领域的 npm——安装、更新、删除、搜索，一条命令搞定，不用手动建目录或复制文件。

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

# 看装了哪些
npx skills list

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

npx skills add <owner/repo>

# 装某个仓库的全部 Skill
npx skills add <owner/repo> --skill <skill-name>     

# 只装某个
npx skills add <owner/repo> -y                       

# 跳过确认

npx skills add https://example.com/my-skill/SKILL.md

指定 AI 工具

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

npx skills add anthropics/skills --skill commit --agent claude-code cursor
npx skills add anthropics/skills --skill commit --agent '*'    

# 所有支持的工具

全局 vs 项目安装

加 --global（-g）装到全局，不加则装到项目目录：

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，不实际安装

查看已安装

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

update 命令把已安装的 Skill 更新到最新版本（别名 upgrade）：

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

1. 发布到 GitHub
   ：推到你的仓库，别人就能用 npx skills add <your-repo> 安装
2. 托管到任意 URL
   ：别人用 npx skills add https://... 安装

安装 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：

{
  "version": 1,
  "skills": {
    "fumadocs-i18n": {
      "source": "foreveryh/claude-skills-tutorial",
      "sourceType": "github",
      "skillPath": ".claude/skills/fumadocs-i18n/SKILL.md",
      "computedHash": "4030ba5e..."
    }
  }
}

实验性命令

# 从 skills-lock.json 恢复安装（类似 npm install 读 package-lock.json）
npx skills experimental_install

# 把 node_modules 里的 Skill 同步到 AI 工具目录
npx skills experimental_sync
npx skills experimental_sync -a '*'     # 指定工具
npx skills experimental_sync -y         # 跳过确认

仓库结构

skills/
├── mj-writer/
│   ├── SKILL.md
│   └── README.md
├── mj-design/
│   ├── SKILL.md
│   └── README.md
├── voice-to-article/
│   ├── SKILL.md
│   └── README.md
└── ...

工作流

1. 在仓库里编辑 Skill
   ——改完推到 GitHub
2. 在任何项目里安装或更新

# 安装某个 Skill
npx skills add makerjackie/skills --skill mj-writer

# 安装全部
npx skills add makerjackie/skills -y --all

# 全局安装全部（新机器初始化用）
npx skills add makerjackie/skills -g -y --all

# 后续更新
npx skills update

💡 好处

你在一个地方维护所有 Skill，改完之后各处 update 就同步了。

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

⚠ 安全提示

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

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

DISABLE_TELEMETRY=1 npx skills add ...

报错怎么办？

最常见的原因是网络问题。npx skills add 需要能访问 GitHub。

装完没生效？

支持私有仓库吗？

主要支持公开仓库。私有仓库需要你手动克隆后放到对应目录。

删除会丢我改过的内容吗？

会。npx skills remove 会直接删除文件，你手动改的内容也会被删除。如果改过，先备份。

TRY IT OUT

工具上手指南已在 01mvp.com/docs/skills 更新，点击阅读原文立即体验。完整教程涵盖 Skill 创建、MCP 组合、实战案例。