How can I refresh a stale marketplace cache?

You can update the cache using 'claude plugin marketplace update {name}' or by manually clearing the specific marketplace directory in ~/.claude/plugins/cache/.

What does the diagnostic script check?

The provided diagnostic script identifies mismatches between installed and enabled plugins, missing configuration entries, stale caches, and invalid JSON structures.

How do I manually enable a Claude Code skill?

You can use the command 'claude plugin enable plugin-name@marketplace-name' or manually set the plugin to true in the enabledPlugins section of ~/.claude/settings.json.

Why is my installed plugin not showing in my available skills?

This is often caused by a known issue where plugins are registered as installed but are not automatically added to the enabledPlugins list in your settings.json file.

Claude Skills Troubleshooting

Name: Claude Skills Troubleshooting
Author: daymade

bydaymade

•

510

•

Developer Tools

Diagnoses and resolves configuration issues for Claude Code plugins and skills to ensure they activate and function correctly.

This skill provides a systematic approach to debugging common Claude Code extension problems, specifically addressing scenarios where plugins are installed but fail to appear in the available skills list. It guides users through automated diagnostic scripts, manual verification of ~/.claude/ configuration files, and resolution workflows for the known sync bug between installed plugins and enabled settings. Whether you are dealing with stale marketplace caches or complex JSON configuration errors, this skill provides the architecture mapping and commands needed to restore your development environment's functionality.

Key Features

01Marketplace cache management and manual update synchronization

02Step-by-step resolution for the 'Installed but Disabled' configuration bug

03510 GitHub stars

04Detailed mapping of Claude Code's internal plugin state architecture

05Automated diagnostic scripts for verifying plugin and skill health

06Batch enablement tools for restoring multiple marketplace plugins

Use Cases

01Fixing plugins that appear in the filesystem but are missing from the available skills list

02Auditing and repairing the enabledPlugins section within settings.json

03Synchronizing local plugin versions with the latest updates from a GitHub marketplace

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add daymade/claude-code-skills claude-skills-troubleshooting

For use in Claude.ai and ChatGPT

Download Skill