3 步零配置上手 npx skills:一键为 AI 助手安装、检索和更新技能
【免费下载链接】skillsThe open agent skills tool - npx skills项目地址: https://gitcode.com/GitHub_Trending/ad/skills
想让 AI 助手遵守团队代码规范、按固定流程写发布说明,靠每次手敲提示词既低效也无法共享。npx skills 是开放 agent skills 生态的 CLI:一条命令就能安装、检索、更新以 SKILL.md 为载体的技能,并自动适配机器上 70 多种 AI 编程助手。
skills CLI 解决什么问题
没有它时,每装一个助手都要手动往各自目录里拷文件,技能散落在 IM 聊天记录里,版本各不一致。装上 npx skills 之后,技能变成可以安装、锁定、更新的包:
| 手动管理 | 用 skills CLI | |
|---|---|---|
| 新增技能 | 逐个助手复制 SKILL.md | 一条命令链接到多个助手 |
| 团队共享 | 文件人肉传递、版本漂移 | 技能随项目仓库提交 |
| 保持更新 | 手动找新版替换 | 一条 update 命令 |
核心路径:skills 安装步骤与日常管理
按"先看有什么 → 装 → 临时用 → 找新的 → 维护"的顺序走一遍,8 个步骤覆盖日常全部场景。
先看仓库里有哪些技能
安装前先看看源仓库提供什么,不碰本地任何文件:
npx skills add vercel-labs/agent-skills --list执行后你会看到该仓库中所有可安装技能的名称和描述,此时尚未安装任何东西。
把技能装进 AI 助手
指定技能名和目标助手,一次装到多个助手:
npx skills add vercel-labs/agent-skills --skill frontend-design -a claude-code -a cursor执行后你会看到 CLI 检测本机已装的助手,然后把技能链接到对应目录(Claude Code 是.claude/skills/,Cursor 是.agents/skills/)。源可以是owner/repo简写、完整仓库 URL 或本地路径,这套 skills 安装步骤对私有仓库同样适用,它直接复用你为仓库 URL 配置好的 git 凭证。
不安装直接试用技能
临时用一次、不想留下痕迹时,use会把技能写进临时目录:
npx skills use vercel-labs/agent-skills --skill web-design-guidelines --agent claude-code不带--agent时,stdout 只打印生成好的提示词,可直接粘贴给任意助手;带上--agent则直接启动对应助手并加载该技能。
按关键词检索技能
不知道技能叫什么名字时,用关键词搜:
npx skills find typescript执行后你会看到匹配的技能列表和各自来源,加--owner vercel可以把范围限定到某个组织名下所有仓库;不带参数运行npx skills find则是 fzf 风格的交互式浏览。
查看已安装的技能
类似npm ls,随时核对状态:
npx skills list执行后你会看到每个技能的来源、它装到了哪些助手、以及属于项目级还是全局级。
更新已安装的技能
按名字更新指定的,或全部更新:
npx skills update frontend-design web-design-guidelines执行后你会看到 CLI 逐一比对技能目录与远端最新版本,有变更的自动重装。CI 场景用npx skills update -y跳过范围确认。
移除不需要的技能
npx skills remove web-design-guidelines执行后你会看到该技能从对应助手的目录中移除;--agent可以只从某个助手移除,--all清空全部(谨慎使用)。
创建自己的技能模板
想沉淀团队规范成技能时,先生成骨架:
npx skills init my-skill执行后你会看到生成一个带name和descriptionfrontmatter 的 SKILL.md,填上正文即可。
安装范围与方法怎么选
两个真正会纠结的选择点,一张表说清:
| 维度 | 项目级(默认) | 全局级(-g) |
|---|---|---|
| 落地路径 | ./<agent>/skills/,随仓库提交 | ~/<agent>/skills/,跨项目共享 |
| 适用对象 | 团队协作文档、与项目绑定的规范 | 个人常用技能,所有项目生效 |
| 落地方式 | symlink(默认,单一来源、更新只改一处) | --copy复制,供不支持软链的环境 |
推荐:团队项目一律用项目级 + symlink 默认值——技能变更随代码提交,队友拉取仓库后跑一次npx skills update就对齐;个人工具类技能再加-g装一份全局。
避坑清单
现象:add 仓库时提示 "No skills found" →原因:仓库里没有有效 SKILL.md,或 frontmatter 缺必填的name/description→解法:确认每个技能目录下的 SKILL.md 头部两个字段齐全且是合法 YAML。
现象:安装成功,助手里却加载不到技能 →原因:技能装进了该助手不读取的目录,或 frontmatter 不是有效 YAML →解法:跑npx skills list核对目标助手,再对照该助手要求的技能路径。
现象:装私有仓库时卡住或报认证错误 →原因:CLI 只复用你为该仓库 URL 已配置好的 git 凭证,不会中途弹 token 输入 →解法:先配好 SSH key 或 git credential helper,再执行同一条 add 命令。
延伸与进阶
如果你想写自己的技能并发给团队,技能就是一个含 SKILL.md 的目录(frontmatter 只需name和description),仓库自带的内置技能示例 skills/find-skills/SKILL.md 是最直接的参照,配合metadata.internal: true还能隐藏未完成的技能。
如果你想读实现,70 多种助手的路径定义集中在 src/agents.ts,源解析(简写、URL、本地路径)在 src/source-parser.ts,技能发现与解析在 src/skills.ts。
打开终端运行npx skills add vercel-labs/agent-skills --list,看到第一份技能清单后,你就知道要装什么了。
【免费下载链接】skillsThe open agent skills tool - npx skills项目地址: https://gitcode.com/GitHub_Trending/ad/skills
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考