Standalone .md skill files in .claude/skills/ not discoverable via slash command search
Problem
Skills placed as standalone .md files directly in .claude/skills/ (e.g., ae-demo-to-figma.md, ae-file-bugs.md) are not discoverable via the / slash command autocomplete in VS Code extension (and likely CLI too).
Only skills using the folder + SKILL.md pattern (e.g., discuss/SKILL.md, harvest/SKILL.md) appear in slash command search results.
Steps to Reproduce
- Create two skills in
.claude/skills/:
my-skill/SKILL.md(folder pattern)ae-demo-to-figma.md(standalone file pattern)
- In VS Code Claude Code extension, type
/my→ the folder-based skill appears - Type
/ae→ "No matching commands" is shown
Screenshots
Folder-based skills appear:/discuss and /insight show up in slash command autocomplete.
Standalone .md skills don't appear:
Typing /ae shows "No matching commands" despite multiple ae-*.md files existing in .claude/skills/.
Expected Behavior
Both skill formats should be discoverable via slash command search, OR the documentation should clearly state that only the folder/SKILL.md pattern is supported for user-invocable skills.
Suggestion
If standalone .md files are a supported skill format, they should be indexed and searchable via /. If not, consider either:
- Adding support for standalone
.mdskill files in slash command discovery - Documenting that only
folder/SKILL.mdis the supported pattern for user-invocable skills
Environment
- Claude Code VS Code Extension
- Skills directory:
.claude/skills/
This issue has 2 comments on GitHub. Read the full discussion on GitHub ↗