claude code 已安装的 skill 全部消失 cc-switch
Quick fix
检查 ~/.claude/skills 是否被改写到 ~/.agents/skills，若是则移回并重启 Claude Code；仍丢失就升级 cc-switch 后重新安装 skill。
Symptom
Section titled “Symptom”claude code 通过 /plugin marketplace 安装的 skill，偶发性地在重新打开 claude code 后全部消失。CC Switch 在切换配置或重启时会对 skill 目录做回填；早期写入逻辑可能覆盖 ~/.claude/skills。维护者称 v3.13.0 已通过 Provider Key Lifecycle & Live Sync 在写入前回填 live 配置，但后续 v3.14.1、v3.15.0、v3.16.x、v3.17.1 仍有用户报告丢失，说明修复与回归并存。另有报告指出配置被写到 ~/.agents/skills，而 Claude Code 默认只识别 ~/.claude/skills。Windows 下还有 symlink target 被写成 /c/Users/... 的情况，原生 claude.exe 无法解析；安装时提示“技能目录不存在”在 v3.16.2 做过反斜杠规范化，但仍有失败反馈。扫描逻辑长期只查 ~/.claude/skills，未适配 ~/.claude/plugins/marketplaces/<marketplace>/skills/<skill>/SKILL.md，导致插件市场安装的 skill 扫不到。相对路径仓库脚本缺失、skill.sh 安装失败属于同一条技能安装/注入链路；预配置仓库删除后重复出现以及 Hermes Agent 仍读取自身 skills 目录则是相邻的仓库状态和投影路径问题。
检查 ~/.claude/skills 是否缺失；如果发现技能被移到 ~/.agents/skills，将对应目录移回 ~/.claude/skills 并重启 Claude Code。
将 cc-switch 升级到 v3.13.0+；若你已在 v3.14.1/v3.15.0/v3.16.x/v3.17.1，回归报告仍存在，升级后需重新安装并验证 skill。
Windows 下检查 ~/.claude/skills/<skill> 的链接目标；若为 /c/Users/<username>/.cc-switch/skills/<skill>，手动改为 C:\Users\<username>\.cc-switch\skills\<skill> 或相对路径。
如果扫描不到插件市场安装的 skill，先看实际路径 ~/.claude/plugins/marketplaces/<marketplace>/skills/<skill>/SKILL.md；在官方适配前可手动复制或链接到 ~/.claude/skills/<skill>。
若来源是 skill.sh（如 gstack）或自定义仓库且拉取不完整/安装失败，先升级到修复版本后重新安装。
Affected Versions
Section titled “Affected Versions”Source Issues
Section titled “Source Issues”本页汇总自 11 个真实 issue
- #1001skill仓库存在相对路径的目录，无法拉取完整的skill
- #1815claude code 后已经安装过的 skill 全部消失
- #1816[bug] claude code 已安装的 skill 全部消失
- #2094使用skill.sh安装gstack失败
- #3009Skills symlink uses Unix-style path on Windows, causes skills to not load in Claude Code
- #3165安装skill提示技能目录不存在
- #4221SKILLs 无法添加
- #4677Skills: 预配置仓库删除后重复出现
- #5250Hermes Agent still reads its own skills instead of cc-switch skills
- #5402skills bugs?
- #5582[Bug] 扫描不到 Claude Code Skills：未适配 plugins 目录结构
- v3.13.0 已标记修复，为什么 v3.15.0/v3.16.x 还会丢失？
- 维护者说明与社区回归报告并存；除升级外还要检查 ~/.claude/skills 是否被移到 ~/.agents/skills，并重新安装 skill。
- 安装 skill 提示“技能目录不存在”怎么处理？
- 升级到 v3.16.2+（该版本规范化了 Windows 反斜杠路径）；确认目标 skill 目录存在且名称正确，若仍失败请补充版本号、配置和截图重新打开 issue。
- Windows 下 skill 的 symlink target 是 /c/Users/...，Claude Code 不加载怎么办？
- 手动把链接目标改为 C:\Users\<username>\.cc-switch\skills\<skill> 或相对路径，因为 claude.exe 无法解析 Unix 风格路径。
- 通过 Claude Code 插件市场安装的 skill，cc-switch 扫描不到？
- cc-switch 仍扫描 ~/.claude/skills，而实际在 ~/.claude/plugins/marketplaces/<marketplace>/skills/<skill>/SKILL.md；在官方适配前手动复制到 ~/.claude/skills。
- 为什么 Hermes Agent 还是读取自己的 skills 而不是 .cc-switch/skills？
- 该 Hermes Desktop 投影路径问题已由 #4896 跟踪；升级并重新投影后仍有差异请重新打开 issue，并附系统、Hermes 版本和实际目录。
这是一个非官方社区 wiki，与 cc-switch 作者及项目本身无隶属关系。内容整理自项目公开的 GitHub issues。本站不分发任何软件。