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

  1. Create a skill at <project-root>/.claude/skills/my-skill/SKILL.md with valid frontmatter:

``yaml
---
name: my-skill
description: Does something project-specific
---
``

  1. Start Claude Code from the project root
  2. Type /my-skill — returns "Unknown skill"
  3. Copy the same skill to ~/.claude/skills/my-skill/SKILL.md
  4. Restart Claude Code
  5. 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: true removed — still not discovered at project level
  • The project's .claude/commands/*.md files also don't seem to register
  • Global ~/.claude/skills/ works reliably
  • macOS, Claude Code latest version

🤖 Generated with Claude Code

View original on GitHub ↗

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