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:
- Create
.claude/skills/foo.mdwith valid frontmatter in project - Launch Claude Code in that project
- Check available skills list — file not present
- Copy same file to
~/.claude/skills/ - 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)
This issue has 1 comment on GitHub. Read the full discussion on GitHub ↗