claude-code - 💡(How to fix) Fix [BUG] Custom skills from ~/.claude/skills/ not appearing in "/" autocomplete dropdown (Desktop app, Windows) [4 comments, 4 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
anthropics/claude-code#49148Fetched 2026-04-17 08:49:32
View on GitHub
Comments
4
Participants
4
Timeline
14
Reactions
1
Timeline (top)
labeled ×6commented ×4cross-referenced ×4

Custom skills stored in ~/.claude/skills/ are not showing up in the "/" autocomplete dropdown in the Claude Code Desktop app on Windows. The skills work correctly when typed manually (e.g., /system-sync), but the autocomplete only shows built-in slash commands.

Error Message

Error Messages/Logs

No error messages. Skills work when typed manually (e.g., /system-sync → Enter executes correctly).

Root Cause

Custom skills stored in ~/.claude/skills/ are not showing up in the "/" autocomplete dropdown in the Claude Code Desktop app on Windows. The skills work correctly when typed manually (e.g., /system-sync), but the autocomplete only shows built-in slash commands.

Code Example

2. Restart Claude Code Desktop app completely
3. Open any project / session
4. Type `/` in the input field
5. **Expected:** Custom skills appear in autocomplete dropdown alongside built-in commands
6. **Actual:** Only built-in slash commands shown (e.g., `/help`, `/clear`, `/compact`)

## What Works

- Skills **execute correctly** when full name is typed manually (`/system-sync`Enter)
- Skills are loaded into system context (visible in `system-reminder` as "Available skills")
- `SKILL.md` frontmatter is valid (name, description, no `user-invocable: false`)
- Directory structure is correct: `~/.claude/skills/<name>/SKILL.md`

## Screenshot

The input field shows `/sys` typed but no custom skills in autocomplete — only the system-reminder confirms they're loaded:

![autocomplete not showing custom skills](screenshot.png)

## Expected Behavior

All 22 custom skills should appear in the "/" autocomplete dropdown, similar to how plugin skills (e.g., `anthropic-skills:*`, `data:*`, `engineering:*`) appear.

## Additional Context

- Fresh restart of Desktop app doesn't fix it
- Skills directory existed before session start (not a watcher init issue)
- All 22 skills have consistent frontmatter format
- Plugin/cowork skills DO appear in autocomplete — only personal `~/.claude/skills/` ones are missing[

<img width="1632" height="1139" alt="Image" src="https://github.com/user-attachments/assets/8fb64909-05ea-4cb6-8292-c764145f4b60" />

](url)

### What Should Happen?

When typing "/" in the input field, the autocomplete dropdown should show personal custom skills from ~/.claude/skills/ alongside built-in slash commands and plugin skills. Currently only built-in commands and plugin skills appear. Personal skills are loaded into context (confirmed in system-reminder "Available skills" section) and execute correctly when typed manually — they're just invisible in autocomplete.

### Error Messages/Logs
RAW_BUFFERClick to expand / collapse

Preflight Checklist

  • I have searched existing issues and this hasn't been reported yet
  • This is a single bug report (please file separate reports for different bugs)
  • I am using the latest version of Claude Code

What's Wrong?

Description

Custom skills stored in ~/.claude/skills/ are not showing up in the "/" autocomplete dropdown in the Claude Code Desktop app on Windows. The skills work correctly when typed manually (e.g., /system-sync), but the autocomplete only shows built-in slash commands.

Environment

  • App: Claude Code Desktop (Windows)
  • OS: Windows 11 Pro 10.0.26200
  • Model: Opus 4.6 (1M context)
  • Skills count: 22 custom skills in ~/.claude/skills/

Steps to Reproduce

  1. Create custom skills in ~/.claude/skills/<name>/SKILL.md with proper frontmatter:
2. Restart Claude Code Desktop app completely
3. Open any project / session
4. Type `/` in the input field
5. **Expected:** Custom skills appear in autocomplete dropdown alongside built-in commands
6. **Actual:** Only built-in slash commands shown (e.g., `/help`, `/clear`, `/compact`)

## What Works

- Skills **execute correctly** when full name is typed manually (`/system-sync` → Enter)
- Skills are loaded into system context (visible in `system-reminder` as "Available skills")
- `SKILL.md` frontmatter is valid (name, description, no `user-invocable: false`)
- Directory structure is correct: `~/.claude/skills/<name>/SKILL.md`

## Screenshot

The input field shows `/sys` typed but no custom skills in autocomplete — only the system-reminder confirms they're loaded:

![autocomplete not showing custom skills](screenshot.png)

## Expected Behavior

All 22 custom skills should appear in the "/" autocomplete dropdown, similar to how plugin skills (e.g., `anthropic-skills:*`, `data:*`, `engineering:*`) appear.

## Additional Context

- Fresh restart of Desktop app doesn't fix it
- Skills directory existed before session start (not a watcher init issue)
- All 22 skills have consistent frontmatter format
- Plugin/cowork skills DO appear in autocomplete — only personal `~/.claude/skills/` ones are missing[

<img width="1632" height="1139" alt="Image" src="https://github.com/user-attachments/assets/8fb64909-05ea-4cb6-8292-c764145f4b60" />

](url)

### What Should Happen?

When typing "/" in the input field, the autocomplete dropdown should show personal custom skills from ~/.claude/skills/ alongside built-in slash commands and plugin skills. Currently only built-in commands and plugin skills appear. Personal skills are loaded into context (confirmed in system-reminder "Available skills" section) and execute correctly when typed manually — they're just invisible in autocomplete.

### Error Messages/Logs

```shell
No error messages. Skills work when typed manually (e.g., /system-sync → Enter executes correctly).
The issue is purely visual — autocomplete dropdown doesn't list personal skills from ~/.claude/skills/.

Skills directory: ~/.claude/skills/ (22 skills, each with SKILL.md and valid frontmatter)
Skills ARE visible in system-reminder as "Available skills" at session start.
Skills ARE executable when full name typed manually.
Skills are NOT shown in "/" autocomplete dropdown.

Steps to Reproduce

  1. Create ~/.claude/skills/my-skill/SKILL.md with valid frontmatter:

    name: my-skill description: "Test skill"

    My Skill

    Instructions here.

  2. Restart Claude Code Desktop app completely (close window, reopen)

  3. Open any project session

  4. Type "/" in the input field

  5. Observe: only built-in commands shown, no personal skills

  6. Type "/my-skill" fully and press Enter — skill executes correctly

Claude Model

Opus

Is this a regression?

Yes, this worked in a previous version

Last Working Version

2.1.108

Claude Code Version

2.1.109

Platform

Anthropic API

Operating System

Windows

Terminal/Shell

PowerShell

Additional Information

No response

extent analysis

TL;DR

The issue can likely be resolved by reverting to the previous version of Claude Code (2.1.108) where the custom skills were visible in the autocomplete dropdown.

Guidance

  • Verify that the SKILL.md files in the ~/.claude/skills/ directory have the correct frontmatter format, including name and description fields.
  • Check the Claude Code Desktop app settings to ensure that custom skills are enabled and the ~/.claude/skills/ directory is configured correctly.
  • Try deleting the ~/.claude/skills/ directory and recreating it with a single custom skill to isolate the issue.
  • If the issue persists, consider reporting the bug to the Claude Code developers with detailed steps to reproduce and screenshots.

Example

No code snippet is provided as the issue seems to be related to the Claude Code Desktop app configuration or a regression in the latest version.

Notes

The issue is reported to be a regression, and the last working version was 2.1.108. The custom skills are loaded into the system context and execute correctly when typed manually, but are not visible in the autocomplete dropdown.

Recommendation

Downgrade to version 2.1.108, as it is reported to be the last working version where custom skills were visible in the autocomplete dropdown. This should resolve the issue until a fix is available in a future version.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING