claude /reload-skills: Apply Edited Skills Instantly Without Restart

Have you been shutting down and restarting Claude Code every time, because a skill (a bundle of instructions that teaches Claude Code in advance how to do a specific task) you edited by one line isn't reflected? /reload-skills reloads only the skills without a restart. For beginners building skills themselves, it's an essential shortcut for spinning through trial and error quickly.

Definition (What It Is)

/reload-skills is a command that scans (skims and reads) and applies newly added or modified skills while keeping the current session.

Claude Code reads the list of available skills once at startup. So even if you edit a skill file midway, it doesn't know about that change and keeps using the old content. When you type this command, it skims the skill folder again to immediately recognize the description you just changed or the skill you newly created.

How to Use It (By Difficulty)

Basic — Refreshing Skills

After modifying a skill file, type this in the input box.

/reload-skills

With this single line, Claude Code scans the skills again. If it's a newly created skill, it now shows up in the list; if it's an edited skill, it operates according to the changed content.

Applied — Slotting It into the Build-Test Loop

If you're in the middle of developing a skill, use it in this flow.

(Edit and save the skill file)
/reload-skills
(Request a task that needs that skill to check it works)

After slightly changing the description text or trigger conditions, reload and immediately check whether the skill actually fires as intended. If it differs from your expectation, just fix it and reload again.

Common Pitfalls

• If it stays the same after you edited it, you most likely didn't save the file. Check the save first.
• For a skill to be recognized, it must follow the prescribed folder location and file format. If it doesn't appear in the list even after a reload, check whether the skill file is in the correct location.
• It's different from /reload-plugins for plugins. If you edited a skill, use /reload-skills.

Real-World Example

It fits well when refining a skill that holds writing rules, such as a blog-writing skill. You can change one line of a style rule, reflect it immediately with /reload-skills, then actually have it write a post and quickly compare how the result differs.

Taking It Further

It's also great on days you're tinkering with several skills at once. After modifying a few files in a row, a single /reload-skills reloads them all, letting you check the changes in a batch. If you make "edit a skill, reload" a habit, your development speed noticeably picks up.

Summary

/reload-skills is a command that re-reads newly added or modified skills without a restart. The build-test loop gets faster, greatly reducing the trial-and-error cost of skill development. If it's not reflected, check whether you saved and the file location first.

Reference: Claude Code v2.1.154 (2026.05)