Skill 源目录缺少 SKILL.md，Claude Code 技能安装失败

Quick fix

如果安装时提示源目录缺少 SKILL.md，检查技能仓库的实际目录结构，并确认 SKILL.md 位于被解析的技能目录中。

Symptom

报错原文复制

Skill 源目录缺少 SKILL.md，拒绝同步以避免覆盖目标目录: /home/fengyu/.cc-switch/skills/ast-grep

Cause

这些 issue 都涉及通过 Skills 管理或 skills.sh 安装失败，但触发原因并不相同。#4141 中，仓库里的同名目录是 Claude Code plugin 包，真正的 SKILL.md 位于更深的子目录；#6365 中，skillId 与包含 SKILL.md 的目录名不同，且 SKILL.md 不在仓库根目录，安装器无法解析源目录。#7013 报告压缩包条目超过 10000 上限，评论称已在 PR #7489 解决。#2078 没有提供可读取的错误文本或具体原因。

Fix

1. 1

   检查技能仓库的目录结构，确认实际技能目录中包含 SKILL.md；如果 SKILL.md 位于嵌套目录，确认安装器能将该目录解析为目标技能。

2. 2

   如果遇到压缩包条目超过 10000 的错误，使用包含该修复的版本；issue 评论指出此问题已在 PR #7489 中解决，但未提供修复版本号。

Affected Versions

ToolClaude Code

Version未知

PlatformsWindowsmacOSLinux

Source Issues

本页汇总自 4 个真实 issue

• #2078无法安装技能
• #4141ast-grep skill 无法安装
• #6365[Bug] skills.sh 的 skillId 与仓库目录名不同时无法安装（weread-skills）
• #7013Skill 安装失败，压缩包条目过多（上限10000）

FAQ

（暂无 FAQ）

相关问题

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