Claude Code does not recognize its own skills feature (~/.claude/skills/)
Problem
When asked about available skills, Claude Code lists skill names from the system reminder but treats them as "slash commands" or confuses them with sub-agents. It has no awareness that skills are files in ~/.claude/skills/ and cannot describe what the skills feature actually is.
Expected Behavior
Claude should:
- Understand that skills are user-defined files in
~/.claude/skills/ - Be able to read and describe skill files
- Distinguish skills from slash commands and sub-agent types
- Recognize when asked "what skills are available?" that the user is asking about files in
~/.claude/skills/
Actual Behavior
Claude lists items from the system reminder (e.g., /run-tests, /deploy-to-servidor) and calls them "skills" when they are actually slash commands or sub-agents. It completely forgets that skills are files stored in ~/.claude/skills/.
Evidence
User has skill files in ~/.claude/skills/:
$ ls ~/.claude/skills
calculate-coverage deploy-bcl-packages.md post-merge-cleanup pre-pr-review run-tests
coderabbit-workflow performance-testing pr-merger qodana-local-review speckit-autopilot.md
When asked "what skills are available?", Claude listed system reminder items instead of reading these files.
Environment
- Claude Code CLI: Latest version
- Model:
claude-sonnet-4-5-20250929 - Platform: macOS (Darwin 25.2.0)
Impact
Users cannot get help with their custom skills because Claude doesn't recognize the feature exists.
This issue has 5 comments on GitHub. Read the full discussion on GitHub ↗