[DOCS] Changelog entry "Merged slash commands and skills" is confusing for users

Resolved 💬 3 comments Opened Jan 10, 2026 by RagDam Closed Feb 24, 2026

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:

  1. 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.
  1. 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" />

View original on GitHub ↗

This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗