导致 skill 无法被正确加载 - cc-switch

Quick fix

cc-switch 仅识别包含 SKILL.md 的目录，需手动提取 marketplace 结构中的 skills 子目录进行加载。

Symptom

报错原文复制

导致 skill 无法被正确加载。

Cause

当加载 marketplace 结构的仓库分支时，cc-switch 会直接将 plugins 放到 `~/.claude/skills`，而不是提取 plugin 里的 skills 子目录。这是因为 cc-switch 严格遵循官方规范，目前仅支持将包含 `SKILL.md` 的目录识别为 skills 目录，暂不考虑支持 marketplace 结构的扩展解析。

Fix

1. 1

   从 marketplace 结构的仓库中，手动找到包含 `SKILL.md` 文件的具体 skill 文件夹（例如 `codex-agent-collaboration-plugin/skills/codex-agent-collaboration`）。

2. 2

   仅将该包含 `SKILL.md` 的独立文件夹通过 cc-switch 进行加载，而不是加载整个仓库或 plugins 根目录。

Affected Versions

Toolcc-switch

Version未知

Platforms未知

Source Issues

本页汇总自 2 个真实 issue

• #362codex 也支持skills了
• #377加载/管理 Skills 时无法正确加载 marketplace 结构中 plugins 的 skills 子目录

FAQ

cc-switch 支持 Claude Code 和 Codex 共用 skills 吗？

支持，该适配需求已加入开发计划。

安装的 skills 太多，如何快速查找？

在 v3.19.2 及以上版本中，Installed 标签页已新增搜索框，支持按名称、描述、ID、目录和来源仓库进行实时过滤。

未来会直接支持加载 marketplace 的 plugins 结构吗？

目前暂不考虑支持此扩展，官方正在设计其他的全量安装方案。

相关问题

cc-switch 导致 Claude Code / Codex 的 MCP 配置丢失升级 cc-switch 到最新修复版，关闭或谨慎使用统一接管 MCP，逐个排查无效 MCP，并手动修正被改写的 command/type/path 字段。14 issues merged打开后就闪退 cc-switch目前没有已确认修复：卸载重装也无效，先收集 debug 日志并保留现场，等待官方修复。1 issues mergedChatGPT无法认证, 全局代理已经开了升级 cc-switch 至 v3.16.4+，并在「设置-路由-全局出站代理」中配置代理地址，修复 OAuth 认证不走代理的问题。5 issues merged