安装失败: 技能目录不存在 cc-switch

Quick fix

升级到 cc-switch v3.14.0 或改用本地 ZIP 安装，以修复根目录包含 SKILL.md 的仓库 URL 安装失败问题。

Symptom

报错原文复制

安装失败: 技能目录不存在

Cause

在 cc-switch 的旧版本中，通过 URL 安装技能时，`download_and_extract` 函数会剥离 GitHub ZIP 的顶层目录前缀，将文件直接解压到临时目录。如果仓库的 `SKILL.md` 位于根目录，安装程序会错误地尝试在 `temp_dir/<repo.name>/` 下寻找技能目录，导致找不到该目录而报错。相比之下，本地 ZIP 安装 (`extract_local_zip`) 会保留完整的目录结构，因此不会触发此问题。该问题已在 v3.14.0 中通过添加根目录回退检查修复。

Fix

1. 1

   升级 cc-switch 到 v3.14.0 或更高版本，该版本已包含针对根目录 `SKILL.md` 的回退检查修复。

2. 2

   作为临时替代方案，手动下载目标仓库的 ZIP 文件，并使用 cc-switch 的 "Install from ZIP" 功能进行安装。

Affected Versions

Toolcc-switch

Version3.13.0 及更早版本（已在 v3.14.0 中修复）

PlatformsWindows

Source Issues

本页汇总自 2 个真实 issue

• #2202Bug: URL install fails with SKILL_DIR_NOT_FOUND for repos with SKILL.md at root level
• #2204Bug: URL install fails with SKILL_DIR_NOT_FOUND for repos with SKILL.md at root level

FAQ

为什么同一个仓库用 ZIP 安装可以成功，用 URL 安装却报错？

URL 安装流程 (`download_and_extract`) 会剥离 GitHub ZIP 的顶层目录前缀，导致程序按仓库名查找子目录时找不到文件；而 ZIP 安装 (`extract_local_zip`) 保留了完整的目录结构，因此可以成功识别。

相关问题

Skill 源目录缺少 SKILL.md，拒绝同步以避免覆盖目标目录当技能仓库目录结构与 skillId 不匹配或存在嵌套时 CC Switch 会安装失败，可改用 `npx skills add` 命令行手动安装。3 issues mergedskills 安装路径不对 cc-switch旧版 cc-switch 会把 skills 装到 ~/.claude/skills/skills，Claude Code 不识别；升级到修复版本，或临时把内容上移到 ~/.claude/skills/。4 issues mergedENOENT: no such file or directory在 VSCode Remote SSH 环境下，需在远程 Linux 服务器上单独配置 Claude Code 认证并创建缺失目录，本地配置不会自动同步。1 issues merged