导致 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

本页汇总自 4 个真实 issue

• #362codex 也支持skills了
• #377加载/管理 Skills 时无法正确加载 marketplace 结构中 plugins 的 skills 子目录
• #5348feat(skills): add search/filter input to Installed skills view
• #7048Improve accessible names for GUI controls

FAQ

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

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

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

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

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

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

相关问题

No MCP servers configured. Claude Code逐个启用 MCP 找出不可用配置，再关闭或删除该配置后重新加载 Claude Code。20 issues merged打开后就闪退：CC Switch Windows 启动闪退在最新版复现时，提供 CC Switch、Windows 和 WebView2 版本，以及最新日志和事件查看器错误信息以便定位。1 issues mergedskills 安装路径不对 cc-switch旧版 cc-switch 会把 skills 装到 ~/.claude/skills/skills，Claude Code 不识别；升级到修复版本，或临时把内容上移到 ~/.claude/skills/。8 issues merged