claude-code - 💡(How to fix) Fix [BUG] "~/.claude/skills/ YAML files not loaded (v2.1.137 on WSL/Linux)"

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…

Error Message

Error Messages/Logs

Code Example

Loading skills from: user=/home/duansongtao/.claude/skills
  Loaded 0 unique skills (user: 0)
  Watching for changes in skill/command directories: /home/duansongtao/.claude/skills...
RAW_BUFFERClick to expand / collapse

Preflight Checklist

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

What's Wrong?

I am using Claude Code (v2.1.137) in an Ubuntu Linux (WSL) environment. I created a custom skill file in the global skills directory (~/.claude/skills/daily-report.yaml, and I also tried .md format with frontmatter).

However, the custom skill is completely ignored. When I run the /skills command in the CLI, it returns: "No skills found. Create skills in .claude/skills/ or ~/.claude/skills/"

According to my debug logs, Claude Code is watching the directory but fails to load anything: Loading skills from: user=/home/.../.claude/skills Loaded 0 unique skills (user: 0) Watching for changes in skill/command directories: /home/.../.claude/skills...

The slash command (e.g., /daily-report) is also not recognized ("Unknown command").

What Should Happen?

Claude Code should successfully parse and load valid .yaml or .md custom skill files located in the ~/.claude/skills/ directory.

When running the /skills command, the custom skills should appear in the list, and I should be able to trigger them using their respective slash commands (e.g., /daily-report).

Error Messages/Logs

Loading skills from: user=/home/duansongtao/.claude/skills
  Loaded 0 unique skills (user: 0)
  Watching for changes in skill/command directories: /home/duansongtao/.claude/skills...

Steps to Reproduce

Environment: Ubuntu Linux (WSL)

  1. Create the global skills directory if it doesn't exist: mkdir -p ~/.claude/skills

  2. Create a simple, valid skill file named test-skill.yaml in that directory with the following content:

name: test-skill
description: A simple test skill to verify loading
instructions: You are a test assistant.

### Claude Model

None

### Is this a regression?

Yes, this worked in a previous version

### Last Working Version

 Not sure. This is my first time trying the skills feature on v2.1.137.

### Claude Code Version

 2.1.137 (Claude Code)

### Platform

Anthropic API

### Operating System

Ubuntu/Debian Linux

### Terminal/Shell

WSL (Windows Subsystem for Linux)

### Additional Information

_No response_

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING