[BUG] /skills command doesn't find skills in symlinked directories
Open 💬 10 comments Opened Dec 20, 2025 by kchristidis
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?
The /skills command doesn't detect skills when the skill directory is a symlink. Running /skills shows "No skills found" even though the skill is correctly loaded and usable by the model.
What Should Happen?
/skills should follow symlinks when scanning ~/.claude/skills/ and .claude/skills/ directories, finding SKILL.md files inside symlinked skill directories.
Error Messages/Logs
> /skills
Skills
No skills found
No skills found. Skills are specialized prompts that extend Claude capabilities.
Create skills in .claude/skills/ or ~/.claude/skills/
Steps to Reproduce
- Create a skill directory outside ~/.claude/skills/
mkdir -p ~/my-skills/sourcegraph
cat > ~/my-skills/sourcegraph/SKILL.md << 'EOF' ---
name: sourcegraph description: Search codebase via Sourcegraph
allowed-tools: Bash ---
# Sourcegraph Skill
EOF
- Symlink it into ~/.claude/skills/
mkdir -p ~/.claude/skills
ln -s ~/my-skills/sourcegraph ~/.claude/skills/sourcegraph
- Verify the symlink resolves correctly
find -L ~/.claude/skills -name "*.md" # outputs: ~/.claude/skills/sourcegraph/SKILL.md
find ~/.claude/skills -name "*.md" # outputs nothing (no -L flag)
- Run /skills in Claude Code - shows "No skills found"
Claude Model
Opus
Is this a regression?
I don't know
Last Working Version
_No response_
Claude Code Version
2.0.73
Platform
Anthropic API
Operating System
macOS
Terminal/Shell
Other
Additional Information
_No response_
This issue has 10 comments on GitHub. Read the full discussion on GitHub ↗