Claude MarketplacesSubmit

Claude Skills Troubleshooting

daymade/claude-code-skills

If your plugins are installed but not showing up in your available skills list, this is the diagnostic tool you need. It walks you through the known bug where Claude Code adds plugins to installed_plugins.json but forgets to enable them in settings.json, plus provides the actual CLI commands to fix it. Includes a Python diagnostic script that checks for the usual culprits: enabled/installed mismatches, stale marketplace cache, and config errors. The reference tables for plugin state architecture and diagnostic commands are genuinely useful when you're knee deep in ~/.claude trying to figure out why something isn't working.

skills.sh installs: 960
GitHub stars: 1.5K
last updated: Aug 21, 2026

Install

$ npx -y skills add daymade/claude-code-skills --skill claude-skills-troubleshooting --agent claude-code

Installs into .claude/skills of the current project.

Files

Claude Skills Troubleshooting

Overview

Diagnose and resolve common Claude Code plugin and skill configuration issues. This skill provides systematic debugging workflows for plugin installation, enablement, and activation problems.

Quick Diagnosis

Run the diagnostic script to identify common issues:

python3 scripts/diagnose_plugins.py

The script checks:

Installed vs enabled plugins mismatch in both directions (installed-but-not-enabled and enabled-but-not-registered)
Missing enabledPlugins entries in settings.json
Stale marketplace cache using known_marketplaces.json lastUpdated
Missing, malformed, timezone-free, or future lastUpdated metadata
Invalid plugin configurations

Treat lastUpdated as the only cache-freshness source. Do not fall back to cache-directory modification times: marketplace updates can refresh nested files without changing that directory timestamp. The diagnostic exits nonzero for stale caches or invalid freshness metadata.

Common Issues

Issue 1: Plugin Installed But Not Showing in Available Skills

SKILL.md on GitHub

Sponsors

Promote your product hereReach 125k+ visitors monthly Promote your product hereReach 125k+ visitors monthly

Agent CaffeineSponsoredClose your lid, come back to finished work

SnugSponsoredThe clipboard manager for the AI era Promote your product hereReach 125k+ visitors monthly

WaxSponsoredBlock anything with supervision, without erasing your iPhone Promote your product hereReach 125k+ visitors monthly

knobsSponsoredSee your site on any phone, any day, in any language

Details

Repository: github.com/daymade/claude-code-skills
Category: Debugging
First seen: Jun 3, 2026

Recommended

1

gradle-build-performancenew-silvermoon/awesome-android-agent-skillsDebug and optimize Android/Gradle build performance. Use when builds are slow, investigating CI/CD performance, analyzing build scans, or identifying compilatio809skills.sh installs

2

debugging-network-issuesdaymade/claude-code-skillsEvidence-driven investigation for network, streaming, and protocol-layer bugs where symptoms don't match the obvious cause. Use when debugging connection resets710skills.sh installs

3

debugyeachan-heo/oh-my-claudecodeDiagnose the current OMC session or repo state using logs, traces, state, and focused reproduction683skills.sh installs

4

rust-profilingmohitmishra786/low-level-dev-skillsRust profiling skill for performance analysis. Use when generating flamegraphs from Rust binaries, measuring monomorphization bloat with cargo-llvm-lines, analy673skills.sh installs

5

troubleshooting-astro-deploymentsastronomer/agentsTroubleshoot Astronomer production deployments with Astro CLI. Use when investigating deployment issues, viewing production logs, analyzing failures, or managin655skills.sh installs

6

compose-performance-auditnew-silvermoon/awesome-android-agent-skillsAudit and improve Jetpack Compose runtime performance from code review and architecture. Use when asked to diagnose slow rendering, janky scrolling, excessive r596skills.sh installs