Project-level skills in .claude/skills/ not discovered
Resolved 💬 6 comments Opened Mar 12, 2026 by jesterkeri Closed Apr 22, 2026
Description
Skills placed in a project's .claude/skills/ directory are not discovered or registered by Claude Code. Only skills in the global ~/.claude/skills/ directory are picked up.
Steps to Reproduce
- Create a skill at
<project-root>/.claude/skills/my-skill/SKILL.mdwith valid frontmatter:
``yaml``
---
name: my-skill
description: Does something project-specific
---
- Start Claude Code from the project root
- Type
/my-skill— returns "Unknown skill" - Copy the same skill to
~/.claude/skills/my-skill/SKILL.md - Restart Claude Code
- Type
/my-skill— works correctly
Expected Behavior
Project-level skills in .claude/skills/ should be auto-discovered and available as slash commands, just like global skills. This would allow having the same skill name with different behavior per project.
Additional Context
- Also tested with
disable-model-invocation: trueremoved — still not discovered at project level - The project's
.claude/commands/*.mdfiles also don't seem to register - Global
~/.claude/skills/works reliably - macOS, Claude Code latest version
🤖 Generated with Claude Code
This issue has 6 comments on GitHub. Read the full discussion on GitHub ↗