npx skills：AI Agent Skill 的 npm，50+ 工具统一的 Skill 管理工具-平芜编程栈

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`会直接删除文件。如果改过，先备份。