npx skills:像管理 npm 包一样管理 AI 智能体技能
【免费下载链接】skillsThe open agent skills tool - npx skills项目地址: https://gitcode.com/GitHub_Trending/ad/skills
你同时在用 Claude Code 和 Cursor,想让一个 web design guidelines 技能两边都能用,手动 clone 仓库、再把文件拷进各自的 skills 目录很折腾,技能一更新还得重做。npx skills是开源 agent 技能生态的包管理器,让你像用 npm 装包一样给 AI 编码助手安装、更新技能。
它是什么
skills是一个开源命令行工具(MIT 协议),把"技能"(一个带SKILL.md的目录)当作可安装的包来管理。核心卖点就三个:
- 支持 Claude Code、Cursor、Codex、OpenCode 等 70 多种编码助手,自动检测你装了哪些
- 技能源不限:GitHub 简写、完整 URL、GitLab、git 协议、本地路径都行
- 技能全部落在本地,离线可用;项目级和全局级两种安装范围
3 条命令装好第一个技能
只需 Node.js 22.20 以上,不需要预先安装任何东西,npx直接跑:
# 按关键词找技能 npx skills find typescript # 安装一个技能仓库(自动检测本机已装的编码助手) npx skills add vercel-labs/agent-skills # 查看已安装技能 npx skills list装完它会把技能链接到对应助手的目录里(如.claude/skills/)。没检测到任何助手时会让你手动选,加-g则装到用户目录全局生效。
装、找、用、管,四步闭环 ✨
从任何源安装
# 只装仓库里某个技能 npx skills add vercel-labs/agent-skills --skill frontend-design # 装到指定助手并全局生效 npx skills add vercel-labs/agent-skills -a claude-code -g私有仓库不用特殊处理,直接复用你已配置好的 git 凭据。适合"给团队项目固化一套统一技能"的场景。
先找再装
npx skills find pr review # 关键词搜索 npx skills find # 不带参数进入交互式搜索不知道有没有现成方案时,先搜一下能省掉自己写提示词的时间。
免安装直接用
npx skills use vercel-labs/agent-skills@web-design-guidelines | claude它把选中的技能写到临时目录,只把生成的提示词打印到 stdout,管道给任意 agent 即可;加--agent claude-code则直接拉起交互会话。适合临时用一次、不想污染项目的情况。
更新与清理
npx skills update # 更新到最新版 npx skills remove web-design-guidelines # 删掉某个技能update背后是 hash 比对而不是盲目重克隆,改动小的仓库更新很快。
项目内部长什么样 🔧
代码全在 src/ 下,按命令切分得很干净:
- src/cli.ts —— 入口,负责命令路由和版本检查
- src/add.ts —— 安装命令的完整逻辑,含来源解析与交互提示
- src/agents.ts —— 70 多种助手的定义与本地检测
- src/installer.ts —— 以符号链接或复制方式落地技能
- src/skill-lock.ts 与 src/local-lock.ts —— 两级锁文件:全局
~/.agents/.skill-lock.json记录已装技能,项目级skills-lock.json随仓库提交
值得看一眼的设计是锁文件里存的skillFolderHash(GitHub 目录树 SHA)。更新时只请求目录树接口比对 hash,不一致才真正重装,网络开销很小。
三个真实用法 🎯
团队协作:把skills-lock.json提交进仓库,新成员拉完代码跑一次安装命令,大家用的技能版本就完全一致,等价于package-lock.json的作用。
个人提效:前端开发者用-g把 React 性能优化、前端设计规范这类技能装进全局目录,之后所有项目里的助手都能直接调用,不用每个项目重复配置。
教学分发:老师把一套SKILL.md放进仓库,学生一条npx skills add就能拿到完整教学材料,包括示例和步骤说明。
老手会提醒你几点 💡
- 技能名含空格必须加引号:
npx skills add owner/repo --skill "Convex Best Practices" - 报 "No skills found" 时,先检查
SKILL.md的 frontmatter 里name和description是否都写了 - 这个 CLI 会收集匿名使用数据,介意的话设置
DISABLE_TELEMETRY=1即可关掉
技能管理从此不用手动拷文件了。去跑一条npx skills find,看看仓库里有什么吧。
【免费下载链接】skillsThe open agent skills tool - npx skills项目地址: https://gitcode.com/GitHub_Trending/ad/skills
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考