Problem entry · machine-readable · 技能管理

官方 CLI 安装失败:GitHub clone 被重置/卡死(国内高频)

本页嵌入 #trove-entity JSON(本条目全量结构化数据);全库数据见 /agent/trove.json。

元数据

idagent-skills-1收录2026-08-29
问题域技能管理主题分组网络与镜像
适用工具agent-skills

症状

`npx -y skills add addyosmani/agent-skills --yes --global` 卡在 Cloning repository… 后报 `fatal: unable to access ... Connection reset by peer` / Installation failed。

原因

skills CLI 安装流程依赖 `git clone https://github.com/addyosmani/agent-skills.git`(直连);国内出口到 GitHub 直连不稳定(本市场连通性基线:GitHub 直连慢/被重置)。注意:CLI 失败时 exit 码仍为 0,只看命令返回值会误判成功。

解法

1. 方式 B(国内推荐,实测可行):codeload tarball 手工复制——`curl -sL https://gh-proxy.com/https://codeload.github.com/addyosmani/agent-skills/tar.gz/refs/tags/0.6.7 | tar xz`,再 `cp -r agent-skills-0.6.7/skills ~/.claude/skills/agent-skills`(0.6.7 为当前收录版本,升级时换 tag)。

2. 或给 CLI 装代理环境变量(git 走代理)后重试方式 A。

3. 判断成功看输出(24 技能目录就位)而不是 exit 码。

验证证据

本站实测记录(2026-08-28)

来源与证据

素材来源:本站实测沉淀(2026-08-28)

验证证据:site docs#1