Skip to content

All installed claude code skills disappear - cc-switch

Quick fix

Check whether ~/.claude/skills was rewritten to ~/.agents/skills; if so move it back and restart Claude Code. Still missing: upgrade cc-switch and reinstall.

Error output
claude code 通过 /plugin marketplace 安装的 skill,偶发性地在重新打开 claude code 后全部消失。
English translation

Skills installed in claude code through /plugin marketplace occasionally all disappear after reopening claude code.

CC Switch backfills the skill directory when switching config or restarting, and early write logic could overwrite ~/.claude/skills. Maintainers say v3.13.0 backfills the live config before writing via Provider Key Lifecycle & Live Sync, but users still reported losses on v3.14.1, v3.15.0, v3.16.x, and v3.17.1, so fixes and regressions coexist. Other reports point at config written to ~/.agents/skills while Claude Code only recognises ~/.claude/skills by default. On Windows the symlink target can be written as /c/Users/..., which native claude.exe cannot resolve; the "skill directory does not exist" message at install time got backslash normalisation in v3.16.2 but failures are still reported. Scanning long looked only at ~/.claude/skills and never adapted to ~/.claude/plugins/marketplaces/<marketplace>/skills/<skill>/SKILL.md, so skills installed from the plugin marketplace are not found. Missing relative-path repository scripts and skill.sh install failures belong to the same install/injection path, while preconfigured repositories reappearing after deletion and Hermes Agent still reading its own skills directory are adjacent repository-state and projection-path problems.

  1. Check whether ~/.claude/skills is missing. If the skills moved to ~/.agents/skills, move the directory back to ~/.claude/skills and restart Claude Code.

  2. Upgrade cc-switch to v3.13.0+. If you are already on v3.14.1/v3.15.0/v3.16.x/v3.17.1 where regressions are still reported, reinstall and verify the skills after upgrading.

  3. On Windows, check the link target of ~/.claude/skills/<skill>. If it reads /c/Users/<username>/.cc-switch/skills/<skill>, change it by hand to C:\Users\<username>\.cc-switch\skills\<skill> or a relative path.

  4. If skills installed from the plugin marketplace are not scanned, check the real path ~/.claude/plugins/marketplaces/<marketplace>/skills/<skill>/SKILL.md. Until this is supported officially, copy or link it into ~/.claude/skills/<skill> by hand.

  5. If the source is skill.sh (gstack, for example) or a custom repository that pulls incompletely or fails to install, upgrade to a fixed version and reinstall.

ToolClaude Code
Version3.13.0 - 3.17.1(用户报告受影响范围;v3.13.0 维护者称已修复但仍有回归)
PlatformsWindowsmacOS
v3.13.0 is marked as fixed — why do skills still disappear on v3.15.0/v3.16.x?
Maintainers acknowledge the fix and community regression reports coexist. Besides upgrading, check whether ~/.claude/skills was moved to ~/.agents/skills, and reinstall the skills.
Installing a skill says the skill directory does not exist. What now?
Upgrade to v3.16.2+ (that version normalised Windows backslash paths). Confirm the target skill directory exists and is named correctly. If it still fails, reopen the issue with your version number, config, and a screenshot.
On Windows the skill symlink target is /c/Users/... and Claude Code will not load it. What now?
Change the link target by hand to C:\Users\<username>\.cc-switch\skills\<skill> or a relative path, since claude.exe cannot resolve Unix-style paths.
cc-switch does not find skills installed from the Claude Code plugin marketplace.
cc-switch still scans ~/.claude/skills while they actually live at ~/.claude/plugins/marketplaces/<marketplace>/skills/<skill>/SKILL.md. Copy them into ~/.claude/skills by hand until this is supported.
Why does Hermes Agent still read its own skills rather than .cc-switch/skills?
That Hermes Desktop projection path problem is tracked in #4896. If a difference remains after upgrading and re-projecting, reopen the issue with your system, Hermes version, and the actual directory.

This is an unofficial community wiki with no affiliation to the cc-switch authors or the project itself. Its content is compiled from the project's public GitHub issues. This site distributes no software.