[DOCS] Changelog entry "Merged slash commands and skills" is confusing for users
Documentation Type
Unclear/confusing documentation
Documentation Location
Claude Code v2.1.3 welcome screen ("What's new" section)
Section/Topic
Release notes / Changelog / "What's new" section
Current Documentation
The v2.1.3 welcome screen "What's new" section displays:
"Merged slash commands and skills, simplifying the mental model with no change in behavior"
What's Wrong or Missing?
This changelog entry is confusing because:
- The terms "slash commands" vs "skills" were never clearly defined in user-facing documentation
- Users don't understand what distinction existed before, so they can't understand what "merged" means
- The phrase "no change in behavior" raises the question: why is this in a user-facing changelog?
- It prompts users to spend time investigating something that ultimately doesn't affect them
As a user, I always invoked my custom commands with /command syntax. I never experienced them being triggered automatically by Claude. So what exactly changed?
Suggested Improvement
Two options:
- Remove internal changes from user-facing changelog: If there's "no change in behavior", it shouldn't appear in "What's new". Reserve this section for changes that actually impact user workflows.
- Or clarify the distinction: If this change matters to users, explain:
- What was a "slash command" vs a "skill" before?
- What concrete difference will users notice now?
- Example: "Previously, custom commands in
.claude/commands/and.claude/skills/were handled differently. Now they're unified."
Impact
Medium - Makes feature difficult to understand
Additional Context
<img width="1312" height="226" alt="Image" src="https://github.com/user-attachments/assets/fcaa60b0-6ec3-4269-a7b7-11f80b5a7e6e" />
This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗