Issue Station
Sign In
Tools hereToolbox

claude-code - 💡(How to fix) Fix [BUG] Local custom skills not appearing in /skills list after restart [1 comments, 2 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#54233•Fetched 2026-04-29 06:32:44
View on GitHub
Comments
1
Participants
2
Timeline
5
Reactions
0
Author
samuelsong-digiforetsamuelsong-digiforet
Participants
github-actions[bot]github-actions[bot]samuelsong-digiforetsamuelsong-digiforet
Timeline (top)
labeled ×4commented ×1

Error Message

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?

Title:
Local custom skills not appearing in /skills list after restart

Body:

Bug Description

Custom skills created with the skill-creator skill and installed as local plugins (@local marketplace) do not appear in the /skills dialog or in the
available skills list after restarting Claude Code.

Steps to Reproduce

  1. Use the skill-creator skill to create a custom skill
  2. Install it as a local plugin (it gets registered as {skill-name}@local)
  3. Restart Claude Code
  4. Open /skills dialog — the custom skill is not listed

Expected Behavior

The custom skill should appear in the /skills list alongside marketplace skills like document-skills and example-skills.

Actual Behavior

The skill is absent from the /skills dialog and from the system context injected at session start, even though:

  • ~/.claude/settings.json has "project-ideas@local": true under enabledPlugins
  • ~/.claude/plugins/installed_plugins.json has the plugin registered
  • All files exist at the correct install path: ~/.claude/plugins/cache/local/{skill-name}/local/ ├── .claude-plugin/marketplace.json └── skills/{skill-name}/SKILL.md

Marketplace skills installed from GitHub repos (e.g., document-skills@anthropic-agent-skills) load correctly. Only @local marketplace skills are affected.

Environment

  • OS: Windows 11 Pro for Workstations (10.0.26200)
  • Claude Code: latest
  • Shell: bash / PowerShell

What Should Happen?

Title:
Local custom skills not appearing in /skills list after restart

Body:

Bug Description

Custom skills created with the skill-creator skill and installed as local plugins (@local marketplace) do not appear in the /skills dialog or in the
available skills list after restarting Claude Code.

Steps to Reproduce

  1. Use the skill-creator skill to create a custom skill
  2. Install it as a local plugin (it gets registered as {skill-name}@local)
  3. Restart Claude Code
  4. Open /skills dialog — the custom skill is not listed

Expected Behavior

The custom skill should appear in the /skills list alongside marketplace skills like document-skills and example-skills.

Actual Behavior

The skill is absent from the /skills dialog and from the system context injected at session start, even though:

  • ~/.claude/settings.json has "project-ideas@local": true under enabledPlugins
  • ~/.claude/plugins/installed_plugins.json has the plugin registered
  • All files exist at the correct install path: ~/.claude/plugins/cache/local/{skill-name}/local/ ├── .claude-plugin/marketplace.json └── skills/{skill-name}/SKILL.md

Marketplace skills installed from GitHub repos (e.g., document-skills@anthropic-agent-skills) load correctly. Only @local marketplace skills are affected.

Environment

  • OS: Windows 11 Pro for Workstations (10.0.26200)
  • Claude Code: latest
  • Shell: bash / PowerShell

Error Messages/Logs

Steps to Reproduce

Title:
Local custom skills not appearing in /skills list after restart

Body:

Bug Description

Custom skills created with the skill-creator skill and installed as local plugins (@local marketplace) do not appear in the /skills dialog or in the
available skills list after restarting Claude Code.

Steps to Reproduce

  1. Use the skill-creator skill to create a custom skill
  2. Install it as a local plugin (it gets registered as {skill-name}@local)
  3. Restart Claude Code
  4. Open /skills dialog — the custom skill is not listed

Expected Behavior

The custom skill should appear in the /skills list alongside marketplace skills like document-skills and example-skills.

Actual Behavior

The skill is absent from the /skills dialog and from the system context injected at session start, even though:

  • ~/.claude/settings.json has "project-ideas@local": true under enabledPlugins
  • ~/.claude/plugins/installed_plugins.json has the plugin registered
  • All files exist at the correct install path: ~/.claude/plugins/cache/local/{skill-name}/local/ ├── .claude-plugin/marketplace.json └── skills/{skill-name}/SKILL.md

Marketplace skills installed from GitHub repos (e.g., document-skills@anthropic-agent-skills) load correctly. Only @local marketplace skills are affected.

Environment

  • OS: Windows 11 Pro for Workstations (10.0.26200)
  • Claude Code: latest
  • Shell: bash / PowerShell

Claude Model

None

Is this a regression?

Yes, this worked in a previous version

Last Working Version

No response

Claude Code Version

2.1.121

Platform

Anthropic API

Operating System

macOS

Terminal/Shell

Terminal.app (macOS)

Additional Information

No response

extent analysis

TL;DR

The issue might be resolved by verifying the plugin registration and settings in ~/.claude/settings.json and ~/.claude/plugins/installed_plugins.json, and ensuring the custom skill files are correctly installed in the ~/.claude/plugins/cache/local/{skill-name}/local/ directory.

Guidance

  • Check the ~/.claude/settings.json file to ensure that the custom skill is enabled under enabledPlugins.
  • Verify that the custom skill is registered in ~/.claude/plugins/installed_plugins.json.
  • Confirm that the custom skill files are present in the correct directory: ~/.claude/plugins/cache/local/{skill-name}/local/.
  • Try reinstalling the custom skill using the skill-creator skill to see if it resolves the issue.

Example

No code example is provided as the issue seems to be related to configuration and plugin registration.

Notes

The issue is reported on Windows 11 Pro for Workstations, but the environment section also mentions macOS, which might indicate a cross-platform issue. However, without more information, it's difficult to provide a more specific solution.

Recommendation

Apply workaround: Verify plugin registration and settings, and ensure correct installation of custom skill files, as the issue might be related to configuration rather than a version-specific bug.

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…
#api#agent setup#task chaining#parallel task#integration issue

Still need to ship something?

×6

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

Back to top recommendations

TRENDING

claude-code - 💡(How to fix) Fix [BUG] Local custom skills not appearing in /skills list after restart [1 comments, 2 participants]