Project-local skills in .claude/skills/ not discovered

Resolved 💬 1 comment Opened Jun 4, 2026 by nfleischmann Closed Jun 4, 2026

Bug report

Observed:

  • Skill file exists at with valid frontmatter
  • Skill does not appear in available skills list in session
  • System can read file (shows in system-reminder) but cannot invoke via Skill tool

Expected:

  • Skills in project directory should be discovered at session start, like global skills

Evidence:

  • Global skills in ~/.claude/skills/ ARE discovered
  • Plugin skills (caveman) from plugin cache ARE discovered
  • Project-local skill is NOT discovered

Repro:

  1. Create .claude/skills/foo.md with valid frontmatter in project
  2. Launch Claude Code in that project
  3. Check available skills list — file not present
  4. Copy same file to ~/.claude/skills/
  5. Restart session — now appears

Impact:

  • Can't ship project-specific skills with repo
  • Teams can't share custom workflows in version control

Workaround:
Copy to ~/.claude/skills/ (global) or use skill content directly.

Session info:

  • Created skill: 2026-06-01 10:18 AM
  • Session started: 2026-06-04 (skill predates session)
  • Platform: macOS (Darwin 25.5.0)

View original on GitHub ↗

This issue has 1 comment on GitHub. Read the full discussion on GitHub ↗