Skip to content
CC Switch WikiUnofficial Community Wiki

No skill found in the ZIP file (it must contain a SKILL.md) - cc-switch

Quick fix

Upgrade cc-switch to v3.16.2 or newer, and delete the old directory by hand before importing a Skill of the same name.

Symptom

Section titled “Symptom”
Error output
ZIP 文件中未找到技能（需包含 SKILL.md 文件）
English translation

No skill found in the ZIP file (it must contain a SKILL.md)

Cause

Section titled “Cause”

This cluster covers several cc-switch defects in Skill management and updating. First, importing a Skill whose name already exists makes the backend skip the conflict silently and return an empty array, so the front end wrongly reports "no skill found in the ZIP file (it must contain a SKILL.md)". Second, on Windows, backslash path separators are not normalised to forward slashes, so a Skill installed in a subdirectory is silently skipped during the update check. Separately, v3.10.3 has a Home environment variable read regression on Windows that leaves the config list empty after upgrading.

Fix

Section titled “Fix”

  1. Upgrade cc-switch to v3.16.2 or newer, fixing Skill updates failing on Windows path separators and the v3.10.3 config loss.

  2. If importing a Skill of the same name errors, delete the existing Skill directory by hand (usually at ~/.cc-switch/skills/<skill name>) and import again.

  3. If the config list is empty after upgrading, set the config directory again in settings and restart the program, or install v3.10.2 over the top to downgrade.

Affected Versions

Section titled “Affected Versions”
Toolcc-switch
Version3.10.3 - 3.16.1 (受影响范围)
PlatformsWindowsmacOS

Source Issues

Section titled “Source Issues”

This page is distilled from 3 real issues

FAQ

Section titled “FAQ”
No config shows at all after upgrading to v3.10.3. What now?
A regression from reading the Home environment variable on Windows. Downgrade to v3.10.2, or upgrade to v3.11.0 or newer. You can also set the config directory again in the latest version and restart.
A Skill installed from a repository will not update automatically on Windows.
Because Windows backslash paths are not normalised, a subdirectory Skill is skipped by the update check. Upgrade to v3.16.2 for the fix.
Section titled “Related problems”
codex cli failed - CC SwitchUpgrading cc-switch to v3.16.3 or newer fixes the local environment detection and the blocked upgrade path.2 issues mergedCannot query usage for an official subscription in the Codex UI - CodexEnable local route mapping so specific models are counted. Third-party APIs need their own query script; Claude official and Free accounts are unsupported.8 issues mergedFrozen after clicking updateForce quit and reopen the app, or update by hand to v3.16.3 or newer for the update deadlock fix.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.