Skip to content
CC Switch WikiUnofficial Community Wiki

Skill not loaded correctly - cc-switch

Quick fix

cc-switch only recognizes directories containing SKILL.md; manually extract the skills subdirectory from marketplace structures for loading.

Symptom

Section titled “Symptom”
Error output
导致 skill 无法被正确加载。
English translation

Skill not loaded correctly.

Cause

Section titled “Cause”

When loading a repository branch with marketplace structure, cc-switch places plugins directly into `~/.claude/skills` instead of extracting the skills subdirectories within plugins. This is because cc-switch strictly follows official specifications: currently, it only identifies directories containing `SKILL.md` as skills directories and does not support extended parsing for marketplace structures.

Fix

Section titled “Fix”

  1. From the marketplace-structured repository, manually locate the specific skill folder containing the `SKILL.md` file (e.g., `codex-agent-collaboration-plugin/skills/codex-agent-collaboration`).

  2. Load only that independent folder containing `SKILL.md` via cc-switch, rather than loading the entire repository or the plugins root directory.

Affected Versions

Section titled “Affected Versions”
Toolcc-switch
VersionUnknown
PlatformsUnknown

Source Issues

Section titled “Source Issues”

This page is distilled from 2 real issues

FAQ

Section titled “FAQ”
Does cc-switch support sharing skills between Claude Code and Codex?
Yes, this adaptation requirement has been added to the development plan.
Too many installed skills; how to find them quickly?
In version v3.19.2 and above, the Installed tab includes a search box supporting real-time filtering by name, description, ID, directory, and source repository.
Will direct support for loading marketplace plugins structures be added in the future?
Support for this extension is not currently considered; the official team is designing other full-installation solutions.
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 mergedcc-switch crashes immediately after openingNo confirmed fix. Reinstalling does not help. Collect debug logs and wait for an official fix.1 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 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.