[BUG] User-provided skills in ~/.claude/skills/ not appearing in /skills command output

Resolved 💬 10 comments Opened Dec 19, 2025 by pgesiak Closed Mar 2, 2026

Preflight Checklist

  • [x] I have searched existing issues and this hasn't been reported yet
  • [x] This is a single bug report (please file separate reports for different bugs)
  • [x] I am using the latest version of Claude Code

What's Wrong?

User-provided skills stored in ~/.claude/skills/ are not listed when running the /skills slash command, even though they are properly installed and accessible to Claude.

Expected Behavior:

The /skills command should list all available skills, including:

  • Built-in Claude Code skills
  • User-provided skills from ~/.claude/skills/

Actual Behavior:

The /skills command only shows built-in skills. User-provided skills are not displayed in the output, despite being properly installed in ~/.claude/skills/.

Steps to Reproduce:

  1. Create a skill in ~/.claude/skills/ (e.g., data-architect)
  2. Verify the skill structure exists:

~/.claude/skills/data-architect/SKILL.md

  1. Run the /skills command in Claude Code
  2. The user-provided skill does not appear in the output

Environment:

  • OS: macOS (Darwin 24.6.0)
  • Claude Code version: [run /status to get this]
  • Skill installed: data-architect

Additional Context:

The skill IS accessible to Claude (it appears in the available skills configuration), but the /skills command doesn't list it. This creates confusion about whether the skill is properly installed.

---
When you submit, run /status and include your Claude Code version number in the report.

What Should Happen?

/skills should output:
data-architect

skill is present in ~/.cursor/skills/data-architect/ as below.

tree ~/.claude/skills
  ⎿  /Users/paul/.claude/skills
     └── data-architect
         ├── references
         │   ├── ai_ml_architectures.md
         │   ├── database_tradeoffs.md
         │   ├── design_patterns.md
         │   ├── graph_database_design.md
         │   ├── multi_tenant_patterns.md
         │   └── technologies.md                                                                                      
        └── SKILL.md
     3 directories, 7 files

Error Messages/Logs

Steps to Reproduce

  1. Create a skill in ~/.claude/skills/ (e.g., data-architect)
  2. Verify the skill structure exists:

~/.claude/skills/data-architect/SKILL.md`

  1. Run the /skills command in Claude Code
  2. The user-provided skill does not appear in the output

Environment:

  • OS: macOS (Darwin 24.6.0)
  • Claude Code version: [run /status to get this]
  • Skill installed: data-architect

Additional Context:

The skill IS accessible to Claude (it appears in the available skills configuration), but the /skills command doesn't list it. This creates confusion about whether the skill is properly installed.

Claude Model

Sonnet (default)

Is this a regression?

Yes, this worked in a previous version

Last Working Version

_No response_

Claude Code Version

2.0.73 (Claude Code)

Platform

Anthropic API

Operating System

macOS

Terminal/Shell

Terminal.app (macOS)

Additional Information

_No response_

View original on GitHub ↗

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