Naming inconsistency: Skills stored in 'commands' directory
Resolved 💬 3 comments Opened Mar 13, 2026 by rohitcoXilinx Closed Mar 17, 2026
Description
There is a naming inconsistency between how user-defined skills are stored vs. how they are presented in the UI/system.
Current Behavior
- User-defined skills are stored in
~/.claude/commands/directory - However, they appear in the system prompt as "skills":
```
The following skills are available for use with the Skill tool:
- boot-vek385: Boot a VEK385 board...
- save-session: Save current session summary...
```
- They are invoked using the
Skilltool, not a "Command" tool
Expected Behavior
The storage location should match the terminology used in the UI:
- Either rename the directory from
commands/toskills/ - Or clarify the distinction between commands and skills in documentation
Why This Matters
When users want to create or manage their custom skills, they look for a skills/ directory but find commands/ instead. This creates confusion about:
- Where to store new skills
- Whether "commands" and "skills" are the same thing or different concepts
- The mental model of how Claude Code extensibility works
Environment
- Claude Code CLI
- Storage location:
~/.claude/commands/
This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗