Skip to content
CC Switch WikiUnofficial Community Wiki

Installation failed: Skill directory does not exist cc-switch

Quick fix

Upgrade to cc-switch v3.14.0 or use local ZIP installation to fix URL install failures for repos with SKILL.md in the root.

Symptom

Section titled “Symptom”
Error output
安装失败: 技能目录不存在
English translation

Installation failed: Skill directory does not exist

Cause

Section titled “Cause”

In older versions of cc-switch, the `download_and_extract` function strips the top-level directory prefix from GitHub ZIP files when installing skills via URL, extracting files directly into the temp directory. If the repository's `SKILL.md` is located in the root directory, the installer incorrectly looks for the skill directory under `temp_dir/<repo.name>/`, resulting in a 'directory not found' error. In contrast, local ZIP installation (`extract_local_zip`) preserves the full directory structure and does not trigger this issue. This problem was fixed in v3.14.0 by adding a fallback check for the root directory.

Fix

Section titled “Fix”

  1. Upgrade cc-switch to v3.14.0 or later, which includes the fallback check fix for root directory `SKILL.md`.

  2. As a temporary workaround, manually download the target repository's ZIP file and use cc-switch's "Install from ZIP" feature.

Affected Versions

Section titled “Affected Versions”
Toolcc-switch
Version3.13.0 及更早版本（已在 v3.14.0 中修复）
PlatformsWindows

Source Issues

Section titled “Source Issues”

This page is distilled from 2 real issues

FAQ

Section titled “FAQ”
Why can the same repository be installed successfully via ZIP but fails via URL?
The URL installation process (`download_and_extract`) strips the top-level directory prefix from GitHub ZIPs, causing the program to fail to find the file when searching for a subdirectory by repository name; whereas ZIP installation (`extract_local_zip`) preserves the complete directory structure, allowing successful recognition.
Section titled “Related problems”
The Skill source directory has no SKILL.md; refusing to sync to avoid overwriting the target directoryCC Switch fails to install when the skill repository layout does not match the skillId or is nested — install by hand with `npx skills add`.3 issues mergedskills installed to the wrong path - cc-switchOlder cc-switch installs skills into ~/.claude/skills/skills, which Claude Code ignores. Upgrade, or move the contents up to ~/.claude/skills/.4 issues mergedENOENT: no such file or directory, scandir Claude CodeIn VSCode Remote SSH, configure Claude Code authentication on the remote Linux server and create missing directories; local settings do not sync.1 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.