Skip to content
CC Switch WikiUnofficial Community Wiki

cc-switch Skills management problems (duplicates, not detected, deleted repos returning, inconsistent state)

Quick fix

Most Skills problems are fixed in later versions: v3.18.0 stops deleted default repos returning; v3.13.0 improves installed-Skill detection and dedup.

Symptom

Section titled “Symptom”
Error output
Skills 仓库状态在重启、删除和检查失败后不一致
English translation

Skills repository state is inconsistent after a restart, a deletion, or a failed check

Cause

Section titled “Cause”

This cluster holds several cc-switch Skills management problems rather than one error. The main mechanisms: 1) the default repository initialisation at startup compares the built-in default list against existing repositories and fills in anything "missing", so a default repository you deleted reappears after a restart. Fixed in v3.18.0, where the default list is written once at first database initialisation and an "initialised" marker is persisted. 2) Older Skill scanning, deduplication, directory structure, and detection logic were flawed: anthropics/skills only partly detected, a downloaded skill ending up with a nested skills directory, skills installed through other channels not detected, and CC-Switch not reading installed skills at all. A maintainer explained v3.13.0 upgraded multi-source scanning, cross-directory deduplication, SKILL.md metadata retention, and SHA-256 content hash detection. 3) Newer versions still have repository state lifecycle problems: re-downloading every enabled repository after a restart, and possibly reporting "all skills are up to date" when the network or a repository request fails. A maintainer said these sub-problems are not yet fixed in a release and are tracked by PR #4660 and #4659. There are also feature requests and UI/cache/sync problems that do not share this root cause.

Fix

Section titled “Fix”

  1. If the problem is a deleted default Skills repository reappearing after a restart, upgrade cc-switch to v3.18.0 or newer. That version fixed the automatic backfill of default repositories at startup.

  2. If the problem is an installed Skill not detected by CC-Switch, shown twice, or carrying wrong metadata, upgrade cc-switch to v3.13.0 or newer. That version improved multi-source scanning, cross-directory deduplication, metadata retention from SKILL.md, and SHA-256 based content hash detection.

  3. If the Skills page shows no available skills and the default repository will not load, check the network first. A maintainer explained skills are downloaded straight from GitHub. Users have asked how to configure a proxy, but the issues offer no confirmed method.

  4. For "re-downloads every repository after a restart" or "check for updates offline still reports all skills up to date": as of the current issue record neither is fixed in a release. Watch PR #4660 and #4659 for merge and release.

  5. If a skill will not work after migrating a SQL file from Windows to macOS, a maintainer explained the SQL file carries provider information only. Use the WebDAV feature to sync Skills rather than migrating the SQL file alone.

Affected Versions

Section titled “Affected Versions”
ToolUnknown
Version3.8.0 - 3.16.3 受影响；默认仓库删除后恢复问题在 v3.18.0 修复，已安装 Skill 识别/去重问题在 v3.13.0 修复
PlatformsmacOSWindows

Source Issues

Section titled “Source Issues”

This page is distilled from 18 real issues

FAQ

Section titled “FAQ”
Why does a default Skills repository I deleted come back after a restart?
Older versions backfill "missing" default repositories from the built-in list at startup, so a manual deletion is written straight back. Fixed in v3.18.0, where the default list is written once at first initialisation.
I have many Skills installed — why can CC-Switch not read them?
A maintainer explained this was fixed in v3.13.0, which upgraded Skill scanning: multi-source scanning, cross-directory deduplication, SKILL.md metadata retention, and SHA-256 content hash detection.
The Skills page says there are no available skills. What now?
A maintainer explained this is a network problem — skills are downloaded straight from GitHub. The issues offer no confirmed proxy configuration method.
A skill installed from a third-party platform or an .agent directory is not detected. What now?
In issue #980 a maintainer said it was fixed and would ship in the next version, but users later reported it still present on v3.12.3. Upgrade to v3.13.0 or newer to check; if it persists, keep reporting.
Can I sync config only, without syncing Skills?
Issue #1876 requested this, because WebDAV syncs ~/.claude/skills/ and can overwrite a Git-managed skill directory. The issue was closed for inactivity with no record of it being implemented.
Can I search or filter when I have many Skills?
Issue #1879 asked for a search box on the Skills management page. A maintainer replied the feature is finished and merged to main, and will be available in the next release.
Section titled “Related problems”
show 0 skills from cc-switchUpgrade cc-switch to v3.17.0 and re-toggle the skill state to fix Windows Hermes Desktop reading the LOCALAPPDATA path.1 issues mergedcc-switch import / cloud sync failures: foreign keys, read-only database, overwritesUpgrade cc-switch and avoid syncing provider_health or a read-only db; after picking a file, click 导入 (Import) rather than 保存 (Save).25 issues mergedcc-switch crashes immediately after openingNo confirmed fix. Reinstalling does not help. Collect debug logs and wait for an official fix.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.