Skip to content
CC Switch WikiUnofficial Community Wiki

WSL path configured but skills are not read - cc-switch

Quick fix

Windows cc-switch cannot read or install WSL ~/.agents/skills. Install and run the Linux build of cc-switch inside WSL instead.

Symptom

Section titled “Symptom”
Error output
已经配置WSL路径，但\\wsl.localhost\Ubuntu-22.04\home\cutem\\.agents\skills 下的技能好像读不到？
English translation

I already configured the WSL path, but the skills under \\wsl.localhost\Ubuntu-22.04\home\cutem\.agents\skills do not seem to be read?

Cause

Section titled “Cause”

Unified management across filesystems produces all sorts of edge problems, fundamentally because cc-switch has one source of truth and one DB, running on the Windows side. The WSL override dir was designed narrowly: only to tell cc-switch "this app's config lives in WSL" so it reads and writes the app-specific directory (.claude/skills) correctly. By design, Windows CC Switch does not scan the WSL ~/.agents/skills, so skills are read incompletely or installed into Windows by default.

Fix

Section titled “Fix”

  1. Stop managing WSL skills from the Windows desktop app and work inside the WSL subsystem directly.

  2. Download and install the Linux build of cc-switch inside WSL (v3.9.1 shown as an example): wget https://github.com/farion1231/cc-switch/releases/download/v3.9.1/CC-Switch-v3.9.1-Linux.deb chmod 644 ~/CC-Switch-v3.9.1-Linux.deb sudo apt install ./CC-Switch-v3.9.1-Linux.deb

  3. Install the system dependencies, CJK fonts, and Chromium browser the GUI needs under WSL: sudo apt update sudo apt install -y libnss3 libatk1.0-0t64 libatk-bridge2.0-0t64 libcups2t64 libx11-xcb1 libxcomposite1 libxdamage1 libxrandr2 libgbm1 libasound2t64 libxshmfence1 libxkbcommon0 sudo apt install -y fonts-noto-cjk fonts-wqy-zenhei fonts-wqy-microhei fonts-arphic-uming fonts-arphic-ukai fc-cache -fv sudo apt install -y chromium-browser xdg-settings set default-web-browser chromium.desktop

  4. Run cc-switch directly in the WSL terminal to start the graphical interface, which then reads and manages the skills directory inside WSL normally.

Affected Versions

Section titled “Affected Versions”
Toolcc-switch
VersionUnknown
PlatformsWindowsLinux

Source Issues

Section titled “Source Issues”

This page is distilled from 3 real issues

FAQ

Section titled “FAQ”
Why can the Windows build of cc-switch not read the WSL ~/.agents/skills directly?
By design, Windows CC Switch does not scan the WSL ~/.agents/skills. The WSL override directory was designed only for reading and writing app-specific directories such as .claude/skills, because unified management across filesystems produces all sorts of edge problems.
Running cc-switch in WSL reports missing dependencies or will not display. What now?
Make sure your WSL supports a graphical interface (WSLg), and install the GUI dependencies (libnss3 and friends), CJK fonts (fonts-noto-cjk), and the Chromium browser inside WSL.
Section titled “Related problems”
cc-switch loses Claude Code / Codex MCP configurationUpgrade cc-switch, disable or use unified MCP takeover carefully, find the one broken MCP entry, and fix rewritten command/type/path fields.14 issues mergedChatGPT will not authenticate even with the global proxy on - cc-switchUpgrade cc-switch to v3.16.4+ and set the proxy address under Settings > Routing > Global outbound proxy, fixing OAuth not going through the proxy.5 issues mergedcc-switch keeps deleting my environment variablesClosing the conflict dialog does not delete anything. To clear it for good, remove the entry from your shell config or the Hermes config.yaml.3 issues merged

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.