Claude Code does not recognize its own skills feature (~/.claude/skills/)

Resolved 💬 5 comments Opened Jan 31, 2026 by brunosantoscodexforgeceo Closed Mar 24, 2026

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:

  1. Understand that skills are user-defined files in ~/.claude/skills/
  2. Be able to read and describe skill files
  3. Distinguish skills from slash commands and sub-agent types
  4. 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.

View original on GitHub ↗

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