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 Skill tool, not a "Command" tool

Expected Behavior

The storage location should match the terminology used in the UI:

  • Either rename the directory from commands/ to skills/
  • 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:

  1. Where to store new skills
  2. Whether "commands" and "skills" are the same thing or different concepts
  3. The mental model of how Claude Code extensibility works

Environment

  • Claude Code CLI
  • Storage location: ~/.claude/commands/

View original on GitHub ↗

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