skills 安装路径不对 cc-switch
Quick fix
旧版 cc-switch 会把 skills 装到 ~/.claude/skills/skills,Claude Code 不识别;升级到修复版本,或临时把内容上移到 ~/.claude/skills/。
Symptom
Section titled “Symptom”安装完后发现 claude code 不识别,后来发现安装在了 ~/.claude/skills/skills 目录下,手动向上移了一层目录到 ~/.claude/skills 下正常了。cc-switch 在从技能仓库安装 skills 时会解析仓库路径并生成目标目录。旧版本把仓库路径中的 `skills` 也当成目标层级,导致 codex/gemini 等技能被安装到 `~/.claude/skills/skills/`,而不是 Claude Code 实际扫描的 `~/.claude/skills/`,所以安装后 Claude Code 不识别。同一时期的 #265 和 #267 也报告 Claude/Gemini skills 安装失败,维护者确认由下一版本修复。
手动把 `~/.claude/skills/skills/` 下的内容上移可以临时让 Claude Code 激活技能,但 cc-switch 无法跟踪手动移动后的位置。对于 Gemini CLI 的技能软链接,`~/.gemini/skills/` 是 cc-switch 所管理的 Gemini CLI 的正确用户级 skills 目录,不应改到 Antigravity 的 `~/.gemini/config/skills/`。
升级到修复版本。维护者在 #382、#265、#267 中确认“新版本已经修复”或“下一个小版本将修复”;升级后重新安装受影响的 skills。
临时方案(仅当无法升级时):将 `~/.claude/skills/skills/` 下的内容移动到 `~/.claude/skills/`。手动移动后 cc-switch 可能不再识别该技能,升级后应重新安装。
如果你使用的是 Gemini CLI,请保持软链接在 `~/.gemini/skills/`;不要将其迁移到 `~/.gemini/config/skills/`,因为 Gemini CLI 不扫描该路径,Antigravity 也不是 cc-switch 受管应用。
Affected Versions
Section titled “Affected Versions”Source Issues
Section titled “Source Issues”本页汇总自 4 个真实 issue
- 手动移动后技能能激活,但 cc-switch 里不识别了怎么办?
- 这是临时移动的副作用。升级到修复版本后用 cc-switch 重新安装,避免手动维护 `~/.claude/skills/`。
- 为什么 Gemini 技能软链接在 `~/.gemini/skills/`,而不是 `~/.gemini/config/skills/`?
- cc-switch 管理的是 Gemini CLI,其用户级 Skills 目录为 `~/.gemini/skills/`,并兼容 `~/.agents/skills/`。`~/.gemini/config/skills/` 是 Antigravity 的目录,Antigravity 不在 cc-switch 受管范围内。
- 安装 codex/gemini skills 时直接提示安装失败,怎么处理?
- 这些报告与同一批路径/打包问题有关,维护者已确认在后续版本修复。请升级后重试。
这是一个非官方社区 wiki,与 cc-switch 作者及项目本身无隶属关系。内容整理自项目公开的 GitHub issues。本站不分发任何软件。