/reload-skills
重新扫描 Skill 和 Command 目录,使会话期间修改过的 Skill 无需重启即可生效。
重新扫描 skill 和 command 目录，让那些在会话运行期间被添加、修改或删除的 skill 无需重启会话即可生效。运行结束后，该命令会报告当前总共有多少个可用 skill，以及自上次扫描以来新增或减少了多少个。
会话期间的自动变更检测只覆盖各个 SKILL.md 的文本内容。如果某个 skill 目录属于一个插件，那么对其 hooks/、.mcp.json、agents/ 或 output-styles/ 的修改要等执行 /reload-plugins 后才会生效，因为这些修改可能还涉及已加载的 MCP 工具和 prompt 缓存。
该命令在版本 2.1.152 中引入。适合在 .claude/skills/ 中新建或编辑自己的 skill 之后立即使用，以便在当前会话中马上测试改动，而不用结束会话再重新开始。
✅ 什么时候用？
让新建的 skill 在当前会话中立即可用
在 .claude/skills/ 中添加一个 skill，然后执行 /reload-skills，而不是重启会话。
检查某次 skill 修改是否被正确识别
编辑完某个 SKILL.md 之后执行 /reload-skills，查看关于新增或移除 skill 的提示信息。
⛔ 什么时候不该用？
整个插件（不只是零散的 skill/command）发生了变化
/reload-skills 扫描的是 skill 和 command 目录；它无法识别插件 skill 目录下 hooks/、.mcp.json、agents/ 或 output-styles/ 的变化。
更好的选择: 使用 /reload-plugins 重新加载整个插件（如果涉及已加载的 MCP 工具变化，可能需要加 --force 确认）。
新建了一个全新的顶层 skill 目录
会话启动时还不存在的目录，Claude Code 尚未对其进行监控——/reload-skills 只会重新扫描已知的目录。
更好的选择: 完全重启 Claude Code，让新目录被识别到。
来源
- Claude Code 文档（官方） ↗ code.claude.com