Skill tool description conflates skills and slash commands

Status Fixed / completed
Maintainer reply None cached
Activity 4 comments · opened Dec 21, 2025 · closed Dec 22, 2025

Summary

The Skill tool description in the system prompt contains misleading language that conflates "slash commands" with "skills", when these are actually distinct features in Claude Code.

The Problem

The Skill tool description states:

"When users ask you to run a 'slash command' or reference '/<something>' (e.g., '/commit', '/review-pr'), they are referring to a skill."

But skills and commands are different:

| | Skills | Commands |
|---|--------|----------|
| Location | ~/.claude/skills/<name>/SKILL.md | ~/.claude/commands/<name>.md |
| Format | YAML frontmatter + body | Plain markdown prompt |
| Invocation | Model-invoked (proactive) | User-invoked (/command-name) |

The official documentation correctly describes skills as "model-invoked" and distinguishes them from slash commands which are "user-invoked".

Impact

This causes Claude to get confused about the distinction, leading to incorrect advice when users ask about skills vs commands. Users have to add explicit corrections to their CLAUDE.md to counteract the misleading tool description.

Suggested Fix

Update the Skill tool description to accurately reflect that:

  1. Skills are model-invoked based on their description
  2. Slash commands (/command-name) are a separate feature that users explicitly invoke
  3. The Skill tool should only be used for skills listed in <available_skills>, not for user-typed slash commands

View original on GitHub ↗

4 Comments

github-actions[bot] · 9 months ago

Found 2 possible duplicate issues:

  1. https://github.com/anthropics/claude-code/issues/14851
  2. https://github.com/anthropics/claude-code/issues/11459

This issue will be automatically closed as a duplicate in 3 days.

  • If your issue is a duplicate, please close it and 👍 the existing issue instead
  • To prevent auto-closure, add a comment or 👎 this comment

🤖 Generated with Claude Code

KyussCaesar · 9 months ago

closing as duplicate

KyussCaesar · 9 months ago

Also. Fucking funny that 1 Claude create the issue, another Claude check for duplicates hahaha

github-actions[bot] · 9 months ago

This issue has been automatically locked since it was closed and has not had any activity for 7 days. If you're experiencing a similar issue, please file a new issue and reference this one if it's relevant.