Claude Code 怎么安装 Skill：从 GitHub 下载、启用到更新排错

先确认 Skill 的来源和目录，再让 Claude Code 读取它；不要把整个陌生仓库直接当作可信能力运行。

很多人遇到的不是“找不到 Skill”，而是把 GitHub 仓库下载下来后，不知道该复制哪一层目录、放在哪里、为何重启后仍然不生效。下面按最稳妥的路径操作。

先认识一个可安装的 Skill

一个常见的 Agent Skill 至少有一个 SKILL.md 文件。它会说明这个能力解决什么问题、何时触发、需要哪些输入，以及会不会调用命令、访问网络或改动文件。

下载前先打开 SKILL.md 和仓库说明，确认三件事：维护者是否可信、最近是否维护、是否要求安装依赖或授予额外权限。看不懂的脚本不要直接执行。

Claude Code 的两种安装位置

项目级安装适合只在一个代码库内使用：在项目根目录创建 .claude/skills/，每个 Skill 单独一个文件夹，例如 .claude/skills/review/SKILL.md。它跟随项目版本管理，团队成员拉取代码后可以看到同一套规范。

个人级安装适合自己的通用能力：放到用户目录的 ~/.claude/skills/ 下，例如 ~/.claude/skills/meeting-summary/SKILL.md。不同版本或安装方式的 Claude Code 可能有差异；如果客户端没有识别，优先以当前官方文档和客户端提示为准。

项目级与个人级同时存在时，先避免同名，防止你无法判断实际加载了哪个版本。

从 GitHub 安装的标准步骤

1. 找到仓库中真正包含 SKILL.md 的目录；不要只看仓库首页。
2. 将这个目录完整复制到目标 skills 目录下，保证最终路径是“技能名/SKILL.md”，不要多嵌套一层仓库名。
3. 重新打开 Claude Code 或新建会话，让客户端重新扫描。
4. 用一个小任务验证，例如“请先说明你会使用哪些已加载的 Skills，再用 review Skill 检查这个文件”。
5. 首次只在可回滚的低风险项目中试用，观察它是否读取了不该读的文件、是否执行了额外命令。

如果仓库提供了安装命令，也要先看命令会写到哪里、会安装什么依赖；一键安装不等于无风险。

装完不生效的四个原因

1. 目录多嵌套了一层：实际变成 skills/仓库名/技能名/SKILL.md，客户端扫描不到预期文件。
2. 文件名不对：必须是 SKILL.md，不要是 skill.md.txt 或仅有 README。
3. 放错作用域：你在 A 项目里放了项目级 Skill，却在 B 项目启动 Claude Code。
4. 内容没有触发条件：Skill 的名称和描述过于模糊，模型无法判断何时使用。

排错时先检查最终路径，再打开新会话验证。不要通过反复复制同一份文件来碰运气。

如何安全更新和卸载

更新前先记录当前版本或保留一份可回退副本；更新后对比 SKILL.md、依赖清单和脚本是否新增了写文件、联网、上传数据等行为。

不再使用时直接删除对应技能文件夹即可。若 Skill 曾安装依赖或写入配置，应按仓库的卸载说明逐项清理，而不是只删 Markdown 文件。