[DOCS] Clarify relationship between skills and slash commands post v2.1.1

What type of docs issue?

Unclear

Section or topic

Skills and slash commands documentation - specifically how they relate to each other after v2.1.1

What's wrong or missing?

Boris Cherny stated on 𝕏 (in response to a question about the v2.1.1 launch):

Yes! Skills and slash commands are the same thing

This creates confusion for users who have been treating them as distinct concepts:

• Skills: Auto-invoked by Claude based on context
• Slash commands: Manually invoked by the user via /command

The current documentation doesn't clearly explain what "same thing" means in practice:

1. Can skills now be manually invoked with /skill-name?
2. Can slash commands now be auto-invoked by Claude when contextually relevant?
3. If they're truly unified, why maintain two separate names and directory structures?

Suggested fix

1. Update the docs to explicitly explain the unified behavior:

• How the merger works under the hood
• Whether both manual and auto-invocation apply to all registered prompts
• The practical implications for plugin/skill authors

1. Consider terminology consolidation in future versions:

• If they're the same concept, using one term would reduce cognitive overhead
• If there are still meaningful distinctions, document them clearly

1. Add a migration note for users familiar with the pre-v2.1.1 mental model

Impact

Medium