npx skills 入门：3 条命令给你的 AI 编程代理装上技能
【免费下载链接】skillsThe open agent skills tool - npx skills项目地址: https://gitcode.com/GitHub_Trending/ad/skills
npx skills 是开放代理技能生态的命令行工具：一条命令搜索、安装、更新模块化的"技能"（SKILL.md 指令包），装好后自动被你用 Claude Code、Codex 或 Cursor 等 AI 编程代理读取。
一句话认识 npx skills
把它理解成 AI 代理技能的"npm"。下面三个场景，中一个就够了：
- 想让代理学会"按我们团队的规范写代码审查意见"：搜一个现成技能装进去，不用自己从零写提示词。
- 同一台机器上跑 Claude Code 和 Codex：装一次技能，多个代理共享同一套能力。
- 只想临时用一次某个技能：
npx skills use直接生成提示词，不往磁盘里装任何东西。
第一次上手：从安装到第一条命令
- 确认 Node.js 在 22.20 以上。
npx随 npm 自带，不需要额外装软件。 - 按关键词搜一下有什么技能可用：
npx skills find react像 npm search 一样，帮你列出能装的技能及其来源仓库。
- 挑一个装到指定代理里：
npx skills add vercel-labs/agent-skills --skill frontend-design -a claude-code默认装在当前项目的目录里，代理重启后就会自动加载它。
- 确认装好了：
npx skills list逐条列出已装技能、来源和所属代理，装没装上扫一眼就知道。
3 个核心工作流
给代理装一个新技能
目标：把仓库里的技能落到本地代理目录。
npx skills add vercel-labs/agent-skills --skill frontend-design输出里能看到每个技能被写入的目标路径，比如.claude/skills/。 💡 先加--list可以看仓库里有哪些技能再决定装哪个；加-g则装到用户目录，所有项目通用。
查状态：看看装了什么、装在哪
目标：一眼看清项目级和全局各有哪些技能。
npx skills list输出类似npm ls，每行一个技能并标注它生效的代理。 💡 代理多的时候加-a claude-code -a cursor过滤，只关心这两个代理。
批量更新已安装的技能
目标：上游仓库改版后，把本地技能一次升到最新。
npx skills update -y-y跳过交互提问，自动判断范围（在项目目录就更新项目级，否则更新全局）并直接执行。 💡 只更新某一个时改成npx skills update frontend-design，其余不动。
命令速查
| 命令 | 作用 | 何时用 |
|---|---|---|
npx skills find [query] | 交互或按关键词搜技能 | 想要某能力但不知道技能叫啥 |
npx skills add <source> | 从仓库或本地路径装技能 | 选定要装的技能后 |
npx skills use <source> | 不安装，单次使用一个技能 | 只需要这一次提示词 |
npx skills list | 列出已装技能（别名 ls） | 检查装了什么、装在哪 |
npx skills update [skills] | 更新技能到最新版本 | 上游仓库更新后跟进 |
npx skills remove [skills] | 移除已安装的技能 | 清理不再用的技能 |
npx skills init [name] | 生成 SKILL.md 模板 | 想自己写一个技能 |
常见问题
技能装好了，为什么代理没反应？
先核对安装路径是否对得上（项目级是.<agent>/skills/，全局是~/<agent>/skills/），再确认 SKILL.md 的 frontmatter 里有 name 和 description 两个字段，最后重启代理。
项目级和全局，我该选哪个？
默认项目级：技能放在项目目录里，随 git 提交，团队成员共享。加-g的全局装在你用户目录下，跨所有项目可用。
提示 "No skills found" 是什么意思？
说明目标仓库里没找到有效的 SKILL.md，或 frontmatter 缺了 name/description。先跑npx skills add <仓库> --list看看它实际能发现哪些技能。
私有仓库的技能能装吗？
可以，命令和公共仓库完全一样。CLI 会复用你机器上已配置好的 Git 凭据，需要时也可以显式设置GITHUB_TOKEN环境变量。
会上传我的数据吗？
默认发送匿名使用统计。设置DISABLE_TELEMETRY=1或DO_NOT_TRACK=1即可完全关闭。
全部参数表和 70 多个受支持的代理清单见仓库内的 README.md，想自己写技能时，参考这份完整的 skills/find-skills/SKILL.md 示例，再用npx skills init生成你自己的第一份模板。
【免费下载链接】skillsThe open agent skills tool - npx skills项目地址: https://gitcode.com/GitHub_Trending/ad/skills
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
