先判断你要安装的是什么
Claude Code 已自带 /code-review、/debug 和 /batch 等 bundled Skills。独立 Agent Skill 是包含 SKILL.md 入口文件的目录。Claude Code 插件则是打包单元，可以同时包含 Skills、agents、hooks 和 MCP servers。
安装方式要和你要用的东西对应。独立 Skill 不必包装成插件；插件也不只是 SKILL.md 的另一个叫法。
| 你的需求 | 如何识别 | 从哪里开始 |
|---|---|---|
| 内置 Skill | /code-review、/debug 或 /batch | 直接在 Claude Code 中试用，不必另装一份。 |
| 独立 Skill | 以 SKILL.md 为入口的文件夹 | 用 Skills CLI 安装，或把完整目录复制到 Skill 路径。 |
| 插件 | 可能打包 Skills、agents、hooks 或 MCP servers | 打开 /plugin，并先审查整个包。 |
| claude.ai 同步 Skill | 已在 Claude 账号启用的 Skill | Cowork 或云端会话使用账号同步；仅放在本机个人目录不够。 |
用 Skills CLI 安装 GitHub Skill
在目标仓库根目录运行第一条命令，它会明确安装到 Claude Code，并使用 CLI 默认的项目范围。第二条增加个人范围，适合你确实想在本机多个项目中使用的 Skill。
以下是 CLI 文档中的具体示例，不代表我们推荐安装该软件包。运行安装前，请先核对仓库、具体 Skill 目录和权限。
npx skills add vercel-labs/agent-skills --skill frontend-design --agent claude-codenpx skills add vercel-labs/agent-skills --skill frontend-design --agent claude-code -g- 仓库专用或需要团队一起审查的工作流使用项目范围。
- 只有明确需要跨项目使用时才加 -g。它安装到当前用户目录，不是整台电脑的管理员级安装。
- 仔细查看安装器提示。不要为了跳过尚未审查的来源、范围或安装方式而添加 --yes。
手动安装：复制完整 Skill 文件夹
如果来源无法生成可靠的 CLI 命令，就打开列出的仓库，复制对应 Skill 的完整目录。SKILL.md 以及它引用的脚本、示例、模板和辅助文件应放在一起；只复制入口文件可能会让引用失效。
Claude Code 会用不同路径区分仓库级和个人级 Skill。在 Windows 上，个人路径位于当前用户配置目录下，不需要管理员账号。
| 范围 | Claude Code 路径 | 适用情况 |
|---|---|---|
| 项目 | .claude/skills/<skill-name>/SKILL.md | 只在一个仓库使用；要共享给团队时提交该目录。 |
| 个人 | ~/.claude/skills/<skill-name>/SKILL.md | 供本机多个项目使用。Windows 路径位于 %USERPROFILE%\.claude\skills\ 下。 |
- 除非确实需要两个范围，否则只保留一个权威副本。
- 确认最终目录里有 SKILL.md，以及指令中引用的所有文件。
- 希望团队能复用时优先选择项目路径，并像审查其他项目指令一样检查已提交文件。
确认路径与当前 Claude Code 会话都能发现它
CLI 列表用于检查安装器把文件放到了哪里。在交互式 Claude Code 会话中运行 /skills，确认 Claude Code 确实能发现它。范围很重要时，还要查看实际目录；列表和路径回答的是不同问题。
可以用 /名称 显式调用，也可以描述相符的任务，让 Claude Code 在相关时选择它。如果会话开始后才创建顶层 .claude/skills 目录，运行一次 /reload-skills。若目录在会话开始前已存在，Claude Code 通常会监测 Skill 目录中的 SKILL.md 变化。
npx skills ls -a claude-codenpx skills ls -g -a claude-code- 文件夹名或 SKILL.md 中的 name 与你预期使用的命令相符。
- 在安装它的同一个本机会话中，用 /skills 能看到该 Skill。
- 先用一个范围小、可撤销且不含密钥或生产凭据的任务测试，再审查结果和文件变化。
排查 Claude Code 安装后看不到 Skill 的情况
下载成功、安装器列表里能看到，以及当前 Claude Code 会话能发现，是三个不同的检查点。先根据现象判断问题在目标 Agent、命令名还是会话类型，不要一上来就重复安装。
| 你看到的情况 | 下一步检查 |
|---|---|
| CLI 显示已安装，但 Claude Code 的 /skills 里没有 | 确认安装目标是 claude-code，并检查 SKILL.md 是否位于 .claude/skills/（项目）或 ~/.claude/skills/（个人）。如果会话开始后才创建顶层 .claude/skills 目录，运行 /reload-skills。 |
| 能看到 Skill，但 /命令名称不一样 | 检查 SKILL.md frontmatter 中的 name 字段。它会指定命令名；没有该字段时，Claude Code 使用 Skill 文件夹名。 |
| 终端里能用，但 Cowork 或云端会话看不到 | 如果 Skill 只安装在本机 ~/.claude/skills/，这是预期行为。请为 claude.ai 账号启用该 Skill，或把项目 Skill 提交到仓库的 .claude/skills/。 |
为什么本地安装后，Cowork 或云端看不到？
Cowork 和云端会话不会读取你电脑里的 ~/.claude/skills/。它们会加载 Claude 账号启用的 Skill；云端会话还可以读取提交在仓库 .claude/skills/ 下的项目 Skill。本机的 -g 安装不等于跨设备或云端同步。
如果软件包包含 hooks、MCP servers 或其他组件，它可能是插件而不是独立 Skill。应使用插件安装流程，并审查它启用的所有组件。
- 本地终端会话：检查本地路径和 Claude Code 的 /skills 列表。
- Cowork 或云端会话：按团队规范启用账号同步 Skill，或使用已提交的项目 Skill。
- 插件：启用前检查其中的 Skills、agents、hooks 和 MCP servers；不要假设它只增加文字指令。
运行前检查来源与权限
榜单、安装量或安装成功，都不能证明 Skill 在你的仓库里会做什么。阅读指令及其引用文件，记录来源版本，并检查首次任务需要访问哪些文件、命令、网络或凭据。
第一次运行应范围明确且可撤销。把输出当成需要审查的证据，不要把它当作发布、合并或修改生产系统的授权。
- 来源仓库和 Skill 目录正是你想安装的那一份。
- 引用的脚本和文件与你能理解的任务相关。
- 首个测试有明确边界、可人工审阅的结果和回滚路径。