Standalone .md skill files in .claude/skills/ not discoverable via slash command search

Resolved 💬 2 comments Opened Apr 1, 2026 by aotm0weng-oss Closed May 7, 2026

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

  1. Create two skills in .claude/skills/:
  • my-skill/SKILL.md (folder pattern)
  • ae-demo-to-figma.md (standalone file pattern)
  1. In VS Code Claude Code extension, type /my → the folder-based skill appears
  2. 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:

  1. Adding support for standalone .md skill files in slash command discovery
  2. Documenting that only folder/SKILL.md is the supported pattern for user-invocable skills

Environment

  • Claude Code VS Code Extension
  • Skills directory: .claude/skills/

View original on GitHub ↗

This issue has 2 comments on GitHub. Read the full discussion on GitHub ↗