npx skills 报错修复5 个常见坑的自查清单【免费下载链接】skillsThe open agent skills tool - npx skills项目地址: https://gitcode.com/GitHub_Trending/ad/skillsnpx skills 是一个在终端里给 AI 编码工具装、找、更新 agent 技能的 CLI。第一次用它的人十个有八个会撞上下面这五类报错——这篇文章带你按报错特征快速定位、逐条修复每条都附验证方法。快速自查表报错关键字大概率原因对应小节GitCloneError网络、Git 凭证或超时安装阶段ENOENT技能名没对上或可执行文件不在 PATH运行与移除阶段path traversal detected技能名里带../之类的路径字符安装阶段Unknown argument传了该命令不认识的参数运行与移除阶段Failed to sync node_modules本地依赖没装好安装阶段报错基本都集中在安装和移除两个环节下面按阶段往下查急着定位的话直接拿表格里的小节跳过去。安装阶段先装技能时最常撞的 3 类报错GitCloneError 怎么办先查网络再查凭证症状GitCloneError: Failed to clone 仓库地址: ...原因拉私有仓库或大仓库时最容易出现报错本身已经把网络、凭证、超时三种情况区分好了照着提示走即可。修复ssh-add -l gh auth status SKILLS_CLONE_TIMEOUT_MS600000 npx skills add owner/repo验证npx skills list里能看到这个技能说明装上了。相关实现可看 src/git.tsnode_modules 依赖同步失败先装依赖再恢复症状Failed to sync node_modules skills原因这条错误来自按 skills-lock.json 恢复技能时experimental_install调用experimental_sync去 node_modules 里找 SKILL.md而本地依赖缺失或只装了一半。修复npm install npx skills experimental_install验证ls node_modules确认包目录在最后npx skills list能看到恢复出来的技能。相关实现可看 src/install.ts路径遍历拦截名字带../会直接拒装症状Invalid skill name: potential path traversal detected原因这不是你的机器出了什么问题而是 skills 在安装前会把技能名转写成安全目录名名字里带../这类字符的要么被拒、要么被改写防止把文件写进技能目录之外。修复npx skills add owner/repo --skill my-skill验证装完后.agents/skills/下出现正常 kebab-case 目录名就说明名字被安全转写了。相关实现可看 src/installer.ts运行与移除阶段别先怀疑工具ENOENT先确认名字是不是打对了症状ENOENT: no such file or directory原因ENOENT 就是文件没找到。skills 自己对缺失的目录大多做了容错真把它抛出来的多半是你在移除一个实际不存在的技能或者skills use --agent指定的可执行文件不在 PATH 里。skills remove 报错十有八九是名字没对上。修复npx skills list npx skills remove 列表里复制出的准确名字验证看到Successfully removed 1 skill(s)即完成。相关实现可看 src/remove.tsUnknown argument只传你认识的参数症状Error: Unknown argument: xxx原因你传了一个当前命令不认识的参数。skills 没有一张统一的参数表每个子命令只认自己那组选项多敲一个就会报这个错。修复npx skills --help npx skills add owner/repo --list验证重跑后看到正常的技能列表输出、不再报参数错就是对了。相关实现可看 src/cli.ts、scripts/execute-tests.ts还没解决按这个顺序求助先翻 README.md 的 Options 表格和 Examples核对参数拼写再对照报错关键字看src/下对应模块比如 src/git.ts的判断分支搞清楚它为什么报这个错最后把完整报错原文、你敲的命令、Node 版本整理出来提 issue贴得越全别人复现越快。报错这东西八成只是名字或参数差了一个字符先按清单自查一遍往往就不用求助了。【免费下载链接】skillsThe open agent skills tool - npx skills项目地址: https://gitcode.com/GitHub_Trending/ad/skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 npx skills 报错修复：5 个常见坑的自查清单
npx skills 报错修复5 个常见坑的自查清单【免费下载链接】skillsThe open agent skills tool - npx skills项目地址: https://gitcode.com/GitHub_Trending/ad/skillsnpx skills 是一个在终端里给 AI 编码工具装、找、更新 agent 技能的 CLI。第一次用它的人十个有八个会撞上下面这五类报错——这篇文章带你按报错特征快速定位、逐条修复每条都附验证方法。快速自查表报错关键字大概率原因对应小节GitCloneError网络、Git 凭证或超时安装阶段ENOENT技能名没对上或可执行文件不在 PATH运行与移除阶段path traversal detected技能名里带../之类的路径字符安装阶段Unknown argument传了该命令不认识的参数运行与移除阶段Failed to sync node_modules本地依赖没装好安装阶段报错基本都集中在安装和移除两个环节下面按阶段往下查急着定位的话直接拿表格里的小节跳过去。安装阶段先装技能时最常撞的 3 类报错GitCloneError 怎么办先查网络再查凭证症状GitCloneError: Failed to clone 仓库地址: ...原因拉私有仓库或大仓库时最容易出现报错本身已经把网络、凭证、超时三种情况区分好了照着提示走即可。修复ssh-add -l gh auth status SKILLS_CLONE_TIMEOUT_MS600000 npx skills add owner/repo验证npx skills list里能看到这个技能说明装上了。相关实现可看 src/git.tsnode_modules 依赖同步失败先装依赖再恢复症状Failed to sync node_modules skills原因这条错误来自按 skills-lock.json 恢复技能时experimental_install调用experimental_sync去 node_modules 里找 SKILL.md而本地依赖缺失或只装了一半。修复npm install npx skills experimental_install验证ls node_modules确认包目录在最后npx skills list能看到恢复出来的技能。相关实现可看 src/install.ts路径遍历拦截名字带../会直接拒装症状Invalid skill name: potential path traversal detected原因这不是你的机器出了什么问题而是 skills 在安装前会把技能名转写成安全目录名名字里带../这类字符的要么被拒、要么被改写防止把文件写进技能目录之外。修复npx skills add owner/repo --skill my-skill验证装完后.agents/skills/下出现正常 kebab-case 目录名就说明名字被安全转写了。相关实现可看 src/installer.ts运行与移除阶段别先怀疑工具ENOENT先确认名字是不是打对了症状ENOENT: no such file or directory原因ENOENT 就是文件没找到。skills 自己对缺失的目录大多做了容错真把它抛出来的多半是你在移除一个实际不存在的技能或者skills use --agent指定的可执行文件不在 PATH 里。skills remove 报错十有八九是名字没对上。修复npx skills list npx skills remove 列表里复制出的准确名字验证看到Successfully removed 1 skill(s)即完成。相关实现可看 src/remove.tsUnknown argument只传你认识的参数症状Error: Unknown argument: xxx原因你传了一个当前命令不认识的参数。skills 没有一张统一的参数表每个子命令只认自己那组选项多敲一个就会报这个错。修复npx skills --help npx skills add owner/repo --list验证重跑后看到正常的技能列表输出、不再报参数错就是对了。相关实现可看 src/cli.ts、scripts/execute-tests.ts还没解决按这个顺序求助先翻 README.md 的 Options 表格和 Examples核对参数拼写再对照报错关键字看src/下对应模块比如 src/git.ts的判断分支搞清楚它为什么报这个错最后把完整报错原文、你敲的命令、Node 版本整理出来提 issue贴得越全别人复现越快。报错这东西八成只是名字或参数差了一个字符先按清单自查一遍往往就不用求助了。【免费下载链接】skillsThe open agent skills tool - npx skills项目地址: https://gitcode.com/GitHub_Trending/ad/skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考