skills.rest
HuuBar
HuuBarCOMMUNITY
Explore all skills by this author →
GitHub

claude-skills-troubleshooting

Diagnose and fix Claude Code plugin and skill configuration issues.

Updated Apr 21, 2026
Search Tags:#debugging#plugin#diagnose#claude-code#settings.json#marketplaces#installed_plugins.json
One-click install
npx skills add https://github.com/HuuBar/skill-routing-experiment --skill claude-skills-troubleshooting
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: claude-skills-troubleshooting
Source: https://github.com/HuuBar/skill-routing-experiment/tree/main/unified_skills/daymade/claude-skills-troubleshooting
Command: npx skills add https://github.com/HuuBar/skill-routing-experiment --skill claude-skills-troubleshooting

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Diagnose and resolve Claude Code plugin and skill configuration issues that prevent plugins from appearing or activating.

Core Features & Use Cases

  • Diagnostic checks for installed vs enabled plugins across installed_plugins.json and settings.json
  • Marketplace cache freshness validation and guidance to refresh caches
  • Detection of missing or misconfigured plugin files in the cache and marketplaces
  • Remediation guidance and CLI commands to enable plugins

Quick Start

Run the diagnostic script to identify and fix Claude Code plugin and skill configuration issues.

Frequently Asked Questions about claude-skills-troubleshooting

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
Why are my Claude Code plugins installed but not enabled?▼

Claude Code plugins may not be enabled due to mismatches between installed_plugins.json and settings.json. This diagnostic tool inspects your ~/.claude directories to identify configuration mismatches and provides actionable remediation steps to activate them.

How do I diagnose Claude Code plugin configuration issues?▼

You can diagnose Claude Code plugin configuration issues by running the diagnose_plugins.py script. It inspects installed_plugins.json, settings.json, and known_marketplaces.json to surface missing files, misconfigurations, and actionable CLI remediation steps.

What causes a Claude Code marketplace cache to become out of date?▼

A Claude Code marketplace cache becomes out of date when local known_marketplaces.json files are not synchronized with remote updates. The diagnostic tool validates cache freshness and provides guidance to refresh outdated marketplace configurations.

Does this tool check for missing plugin files in the Claude Code cache?▼

Yes, this tool detects missing or misconfigured plugin files within the Claude Code cache and marketplace directories. It inspects the cache state to pinpoint exact file discrepancies and offers guidance to resolve them.

What is the best way to fix settings.json misconfigurations for Claude Code plugins?▼

The best way to fix settings.json misconfigurations is to run the diagnostic script to inspect the file and generate precise CLI commands. This tool compares settings.json against installed plugins to surface exact remediation steps.

Related Skills

Explore More Software Engineering Skills→
acaprinoacaprino
6

marketplace-audit

Audit Claude Code plugin marketplaces for structural integrity and frontmatter correctness.

Community
Advanced
blueif16blueif16

sync-to-marketplace

Automate plugin validation, packaging, versioning, and git deployment to a marketplace.

Community
Intermediate
vitalliumvitallium
10

ce-update

Compare installed compound-engineering plugin versions against upstream main in Claude Code.

Community
Advanced
fcakyonfcakyon
1.0k

plugin-structure

Scaffold Claude Code plugins with manifest configuration and directory layout.

Community
Basic