npx skills 命令与参数完整指南30秒上手的代理技能管理工具速查手册【免费下载链接】skillsThe open agent skills tool - npx skills项目地址: https://gitcode.com/GitHub_Trending/ad/skillsnpx skills 是一个开源的代理技能管理工具用一条命令行就能为 Claude Code、Cursor、Codex 等 AI 编程代理安装、查找、更新和移除技能skill。它支持从 GitHub 仓库、Git URL 甚至本地目录拉取技能并自动链接到各代理的目录。下面这份手册按真实使用场景组织所有命令都能直接复制运行。速查命令卡场景命令装一个技能npx skills add vercel-labs/agent-skills装之前先看看仓库里有什么npx skills add vercel-labs/agent-skills --list交互式移除技能npx skills remove看项目里已装的技能npx skills list看全局技能npx skills ls -g按关键词找技能npx skills find typescript更新全部技能npx skills update -y创建一个新技能骨架npx skills init my-skill快速安装一个技能这节解决怎么把技能装到代理里。核心是add命令支持仓库短名owner/repo、完整 Git URL、GitLab URL甚至本地路径./my-local-skills。# 最常见按 owner/repo 安装到当前项目 npx skills add vercel-labs/agent-skills # 安装前只列出仓库里有哪些技能不装 npx skills add vercel-labs/agent-skills --list # 只装其中两个指定技能只装到指定代理 npx skills add vercel-labs/agent-skills --skill pr-review commit -a claude-code cursor # 仓库里所有技能、装到所有代理、跳过确认 npx skills add vercel-labs/agent-skills --all安装默认在项目级写入项目目录加-g就装到用户主目录所有项目都能用。技能目录默认用符号链接挂到各代理目录跨平台环境或遇到链接问题时可以加--copy改为复制文件。参数含义统一放在公共参数速查一节这里不重复。移除技能与清理技能用不上了怎么办remove简写rm不带参数时会弹出交互式多选菜单勾掉要删的即可带名字则按名精确移除。# 交互式选择要移除的技能 npx skills remove # 按名字移除-y 跳过确认 npx skills remove skill1 skill2 -y # 只从 cursor 这个代理上摘掉所有技能 npx skills remove --skill * -a cursor # 移除当前作用域下所有已装技能隐含 -y npx skills remove --all注意--all不能和指定名字同时用它是清空一切的简写。默认只清项目作用域要清全局~下加-g。查看已装与可装技能两个命令分工不同list管本地已装的find管全网可装的。# 列出当前项目的技能 npx skills list # 列出全局技能并按代理过滤 npx skills ls -g -a claude-code # JSON 输出方便脚本处理无 ANSI 颜色码 npx skills ls --json # 交互式搜索可装技能 npx skills find # 关键词搜索并用 --owner 限定某个仓库主 npx skills find react --owner vercellist的别名是lsfind的别名有search、f、s短命令党可以放心用。保持技能更新仓库源更新后本地技能不会自动跟上。update别名upgrade负责这件事支持按名字只更新单个技能也可以批量。# 更新当前作用域的全部技能 npx skills update # 只更新一个技能 npx skills update my-skill # 只更新全局技能跳过作用域提示 npx skills update -g -y-p与-g二选一锁定项目或全局作用域-y会让它自动检测——在项目目录里就按项目算否则按全局算。创建并发布自己的技能init一条命令生成技能骨架方便你把自己的经验沉淀成可分发的技能。# 创建 my-skill/SKILL.md npx skills init my-skill # 不传名字则直接在当前目录生成 SKILL.md npx skills init生成的 SKILL.md 自带 frontmatter 模板name和description两个字段编辑好后推到仓库别人就能用npx skills add owner/repo装上把文件托管到任意 URL 后也可以用 URL 直接安装。技能的目录规范可以参考 skills/find-skills/SKILL.md命令参数实现则都在 src/cli.ts。临时试用与实验性命令不想装、只想看看某个技能长什么样use命令会把技能文件放到临时目录只把生成的 prompt 打到 stdout可以管道给代理使用# 生成 prompt 后直接喂给 claude npx skills use vercel-labs/agent-skillsweb-design-guidelines | claude # 或用 --agent 直接交互式启动某个代理 npx skills use vercel-labs/agent-skills --skill web-design-guidelines --agent claude-code另有两条实验性命令功能可能随版本变化# 按 skills-lock.json 恢复项目级技能 npx skills experimental_install # 把 node_modules 里依赖包自带的技能同步到代理目录 npx skills experimental_sync -a claude-code -y公共参数一次讲清大部分场景共享这几个参数集中说明一遍后面就不用反复解释-g, --global切换到用户级全局/~作用域涉及add、remove、list、update-a, --agent agents...指定目标代理可传多个-a claude-code -a cursor或空格分隔*表示所有代理-s, --skill skills...指定技能名可传多个*表示全部-y, --yes跳过所有确认提示CI/脚本场景必备--all--skill * --agent * -y的简写用于add和remove--full-depth即使仓库根目录已有 SKILL.md也继续搜索所有子目录add/use--copy复制文件而非创建符号链接仅add--subagent names装到 Eve 的子代理root表示根代理仅add--metadata json给安装遥测事件附带合法 JSON仅add全局选项只有两个任何命令后面都能带npx skills --help # 完整帮助-h 等价 npx skills --version # 查看版本-v 等价容易踩的几个坑项目级和全局装的东西互不可见。项目级技能写在项目目录里只对这个仓库生效适合团队共享-g装的全局技能放在用户主目录所有项目共用。用list不加-g看的是前者加-g看后者——找不到技能时先确认是不是看错了作用域。一次指定多个代理怎么写-a后面可以连续跟多个名字或用-a重复传npx skills add vercel-labs/agent-skills -a claude-code cursor。懒得一个个挑就直接--all铺到所有代理。技能名带空格要加引号。比如npx skills add owner/repo --skill Convex Best Practices不加引号会被 shell 拆成两个参数。remove --all不能和名字共存。它是清空操作写了具体技能名会被拒绝别把两者拼在一条命令里。下一步装第一个技能试试npx skills add vercel-labs/agent-skills --list看看里面有什么挑一个感兴趣的装进你的代理。想深入了解支持的代理列表和私有仓库认证细节直接读 README.md想看每个参数的解析实现src/ 下的add.ts、remove.ts、update.ts都是可读性很好的入口。【免费下载链接】skillsThe open agent skills tool - npx skills项目地址: https://gitcode.com/GitHub_Trending/ad/skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考