先说结论
- 1想让所有项目都能用，就把 Skill 文件夹放进
~/.claude/skills/；只给一个仓库用，就放进.claude/skills/。 - 2用 Skillry CLI 安装时记得加
--agent claude-code。不加的话，Skill 会装进~/.agents/skills/，而 Claude Code 不读这个目录。 - 3输入
/skills确认它在列表里，再输入/skill-name加上你的需求，就能运行。
怎么给 Claude Code 添加 Skills
可以把安装提示词贴给 Claude Code，可以自己跑 Skillry CLI，也可以手动拷贝文件夹。不管哪种，最后都是 ~/.claude/skills/ 里多出一个 Skill 文件夹。
最容易漏的那个参数
Skillry CLI 默认装到 ~/.agents/skills/，因为 Codex 和 Cursor 都读这个目录。Claude Code 读的是自己的 ~/.claude/skills/。安装时漏了 --agent claude-code，命令照样显示成功，可 Claude Code 永远看不到这个 Skill。
- 1
打开 Skillry 上的 Skill 页面，点 复制安装提示词，再在弹窗里点 复制。
- 2
粘贴到 Claude Code 里发出去。它会自己去读 Skillry 的安装说明，执行该跑的命令。
安装提示词 Read https://skillry.dev/skills/<slug>/install.md and follow the instructions to install the skill. - 3
浏览器要你批准设备码时，点批准。
正常的话你会看到： Claude Code 告诉你装好的版本号和所在目录，就在
~/.claude/skills/下面。
- 1
先登录一次。浏览器会打开一个页面，让你批准设备码。
终端 npx --yes skillry-cli@latest login - 2
安装，命令末尾加上
--agent claude-code。终端 npx --yes skillry-cli@latest install <slug> --agent claude-code正常的话你会看到：
Installed <slug> <version> to ~/.claude/skills/<slug>
在 Skill 页面点 下载 ZIP，或者用你从别处拿到的 Skill 文件夹。装之前先翻一遍 SKILL.md 和 scripts/，因为 Agent 会照着里面的说明做事，也可能运行那些脚本。看完再把整个文件夹移过去：
mkdir -p ~/.claude/skills
mv ~/Downloads/my-skill ~/.claude/skills/ZIP 解压后经常多套一层，变成 my-skill/my-skill/SKILL.md。SKILL.md 必须直接放在 Skill 文件夹里，否则 Agent 找不到。
Claude Code 认到了吗？这样检查
输入 /skills。列表里有你装的 Skills，也有几个 Claude Code 自带的，比如 /code-review。按 t 可以按占用上下文的多少排序。
不用重启。新增或改过的 Skill，Claude Code 在当前会话里就能认到。只有一种例外：会话启动时 ~/.claude/skills/ 还不存在，这时运行一次 /reload-skills。
用斜杠命令运行 Claude Code Skill
装好的每个 Skill 都会变成一个斜杠命令，名字就是 Skill 的名字。输入命令，后面接着写你要做什么：
/launch-page Parcelo，一个给小网店用的包裹追踪面板命令名后面的所有内容，都会作为 $ARGUMENTS 交给 Skill。跑通一次之后，一般连命令都不用敲，直接用大白话说任务就行。你的请求和某个 Skill 的描述对得上，Claude 会自己加载它。想用得更好，看怎样用好 Skills。
Claude Code 去哪里找 Skills，重名时听谁的
Claude Code 会从五个地方收集 Skills。大多数人只用得到个人目录和项目目录，其余几个要到团队协作或装插件时才会碰到。
| 来源 | 位置 | 调用方式 |
|---|---|---|
| Enterprise | 托管设置 | /skill-name |
| 个人 | ~/.claude/skills/<name>/ | /skill-name |
| 项目 | .claude/skills/<name>/ | /skill-name |
| 插件 | <plugin>/skills/<name>/ | /plugin-name:skill-name |
| 你的 claude.ai 账号 | 同步到 ~/.claude/skills/synced/ | /name 或 /anthropic-skills:name |
同一个名字出现在两处时，Enterprise 压过个人，个人压过项目。子文件夹里的 .claude/skills/，要等 Claude 第一次处理那个子文件夹里的文件时才加载。这样大仓库里只跟某个包有关的 Skill，平时不会来添乱。
SKILL.md 里控制运行时机的几个字段
这些字段写在 SKILL.md 顶部的 frontmatter 里。Skill 跑得太勤、太少，或者每一步都停下来问你要权限时，才需要动它们。
| SKILL.md 字段 | 作用 |
|---|---|
description | Claude 靠它判断用不用这个 Skill。它和 when_to_use 加起来，在列表里超过 1,536 个字符的部分会被截掉。 |
allowed-tools | 调用这个 Skill 的那一轮里，Claude 不用问你就能用的工具。 |
paths | 文件匹配规则。只有处理到匹配的文件时，Claude 才会自动加载它。 |
Claude Code Skill 不生效？先查这几处
从上往下对照。第一条，也就是目录放错，是最常见的原因。
/skills 里没有
目录放错了，或者 ZIP 多套了一层。挪一下，让路径变成 ~/.claude/skills/<name>/SKILL.md；或者加上 --agent claude-code 重装。
目录是刚建的
运行 /reload-skills。
云端会话里没有
把它提交到仓库的 .claude/skills/，或者在 claude.ai 上启用。
Cowork 里没有
在你的 claude.ai 账号里启用它。
列表里有，但从来不被选中
先用 /name 手动调用，确认能跑；再把描述写具体些。见触发机制。
其他问题看故障排查。
常见问题
Claude Code 支持 Skills 吗？
支持。Claude Code 遵循开放的 Agent Skills 标准，会从你的个人目录、当前项目、插件、所在组织和 claude.ai 账号里加载 Skills。
Claude Code 的 Skills 存在哪里？
自己用的放在 ~/.claude/skills/<name>/SKILL.md，只给某个项目用的，放在那个仓库的 .claude/skills/<name>/SKILL.md。
以前的自定义斜杠命令还能用吗？
能。.claude/commands/deploy.md 这个文件和名叫 deploy 的 Skill，都会生成 /deploy。两个同时存在时，Skill 优先。
为什么 Skillry CLI 要加 --agent claude-code？
它默认装到 ~/.agents/skills/，那是 Codex 和 Cursor 共用的目录。Claude Code 读的是 ~/.claude/skills/，加这个参数就是让 Skill 装到那里。
参考来源
这篇对你有帮助吗？