Skills created mid-session not available in slash-command autocomplete until session restart
Description
When a new skill is created at ~/.claude/skills/*/SKILL.md during an active Claude Code session (either in the CLI or via the Cursor/VS Code extension), the skill is registered in the Claude Code runtime's internal skill list but does not appear in the slash-command autocomplete dropdown until the session is restarted.
Steps to reproduce
- Open a Claude Code session in Cursor
- Create a new skill:
mkdir -p ~/.claude/skills/my-skill && echo "# my-skill\nDoes something." > ~/.claude/skills/my-skill/SKILL.md - Type
/my-skillin the chat input - Expected: The skill appears in the autocomplete dropdown
- Actual: The skill does not appear. It only appears after closing and reopening the Claude Code panel.
Environment
- Claude Code in Cursor (VS Code extension)
- macOS
- Skills located at
~/.claude/skills/
Expected behavior
Skills created during a session should be immediately available in the slash-command autocomplete without requiring a session restart. Either:
- The skill index should hot-reload when new SKILL.md files are detected (file watcher on the skills directory)
- A built-in command (e.g.,
/refresh) should force re-scanning of the skills directory - The autocomplete index should re-scan on each keystroke or on a short polling interval
Impact
In workflows where skills are created programmatically (e.g., an AI assistant building a new skill as part of a task), the operator cannot immediately invoke the skill. This creates a workflow interruption where the operator must restart the session to use something that was just built.
Workaround
Close and reopen the Claude Code panel in Cursor. The skill appears on the next session start because the runtime re-scans ~/.claude/skills/ during initialization.
This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗