[DOCS] `/reload-skills` command missing from command reference and skill reload guidance

Open 💬 1 comment Opened May 27, 2026 by coygeek

Documentation Type

Missing documentation (feature not documented)

Documentation Location

https://code.claude.com/docs/en/commands

Section/Topic

The "All commands" table and the skill reloading guidance for changes that require a directory re-scan.

Current Documentation

The command reference currently lists the adjacent plugin reload command but not the new skill reload command added in v2.1.152:

| /release-notes | View the changelog in an interactive version picker. Select a specific version to see its release notes, or choose to show all versions | | /reload-plugins | Reload all active plugins to apply pending changes without restarting. Reports counts for each reloaded component and flags any load errors | | /remote-control | Make this session available for remote control from claude.ai. Alias: /rc |

The skills guide also still says some skill-directory changes require a restart, without mentioning /reload-skills as the in-session recovery path:

Claude Code watches skill directories for file changes. Adding, editing, or removing a skill under ~/.claude/skills/, the project .claude/skills/, or a .claude/skills/ inside an --add-dir directory takes effect within the current session without restarting. Creating a top-level skills directory that did not exist when the session started requires restarting Claude Code so the new directory can be watched.

The v2.1.152 changelog announces the missing command explicitly:

Added /reload-skills command to re-scan skill directories without restarting the session

What's Wrong or Missing?

Claude Code v2.1.152 added /reload-skills, but the main command reference does not document it at all. That leaves users without a discoverable description of what the command does, when to run it, or how it relates to existing live skill watching.

The missing command entry also leaves the skills guide incomplete for the specific case where a skill directory was not present when the session started. The guide currently tells users to restart, but v2.1.152 added an in-session command whose purpose is to re-scan skill directories instead.

Suggested Improvement

Add a /reload-skills row to https://code.claude.com/docs/en/commands near /reload-plugins, with a purpose line similar to:

/reload-skills | Re-scan skill directories and load newly discovered or updated skills without restarting the current session. Use this when you create a skill directory after startup or need Claude Code to pick up newly installed skills immediately. |

Also update https://code.claude.com/docs/en/skills so the live-change section distinguishes between file changes that are watched automatically and directory additions that require either /reload-skills or a restart.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

| Page | Line(s) | Context |
|------|---------|---------|
| https://code.claude.com/docs/en/commands | 97-99 | Command table shows /reload-plugins but no /reload-skills entry |
| https://code.claude.com/docs/en/skills | 114 | Live change detection still says creating a top-level skills directory requires restarting Claude Code |
| https://code.claude.com/docs/en/changelog | 13-17 | v2.1.152 changelog announces /reload-skills and describes its purpose |

Total scope: 3 pages affected

Version context: this command was added in v2.1.152.

View original on GitHub ↗

This issue has 1 comment on GitHub. Read the full discussion on GitHub ↗