Project-level skills disappear from available list mid-session
Resolved 💬 3 comments Opened Feb 22, 2026 by nick-rich Closed Feb 26, 2026
Bug Description
Project-level skills (defined in <project>/.claude/skills/) are correctly discovered and available at session start, but silently disappear from the available skills list mid-session. Attempting to invoke them after they disappear returns "Unknown skill."
Steps to Reproduce
- Create a project-level skill in
.claude/skills/<name>/SKILL.mdwith valid frontmatter - Start a new Claude Code session in the project directory
- Verify the skill appears in the system reminder's available skills list — it does
- Continue working in the session (several tool calls, possibly triggering context compression)
- Observe that the skill is no longer listed in subsequent system reminders
- Attempting
Skill("name")returns:Unknown skill: name
Expected Behavior
Project-level skills should remain available for the entire session duration, surviving context compression and skill list refreshes.
Actual Behavior
- Session start: skill is listed and invocable ✅
- Mid-session: skill silently drops from the available list ❌
- Invoking it returns "Unknown skill" ❌
Environment
- Claude Code CLI (Opus 4.6)
- Linux (Fedora 42)
- Global
~/.claude/skills/contains 3 skills (via GNU Stow symlinks) - Project
.claude/skills/contains 2 skills (regular files, committed to git) - Global
~/.claude/settings.jsonis symlinked via GNU Stow (no skill filtering keys) - Project
.claude/settings.jsonhas hooks only (no skill filtering)
Notes
- Global skills (
~/.claude/skills/) remain available throughout — only project-level skills disappear - Project-level agents (
.claude/agents/) remain available throughout — only skills are affected - The skill files themselves are unchanged on disk when the disappearance occurs
- No errors or warnings are logged
This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗