Claude Skill MartBrowse skillsWhat is a Skill?
 
← Back to list

Claude Skills Troubleshooting

Systematically diagnose and fix Claude Code plugins and skills that install but never show up or activate.

UtilitiesIntermediate★ 1,323⑂ 212AI score 8/10Last updated: Aug 8, 2026

What it does

Gives Claude a step-by-step debugging workflow for broken plugin/skill setups.

  • Detects mismatches between installed_plugins.json and enabledPlugins in settings.json
  • Checks marketplace cache freshness strictly via lastUpdated in known_marketplaces.json
  • Ships diagnose_plugins.py for quick diagnosis and enable_all_plugins.py for bulk enabling
  • Explains the Skills (auto-activated) vs Commands (/name invoked) architecture
  • Includes a cheat sheet of claude plugin ... CLI commands

Who it's for

  • Users whose plugin shows as installed but whose skill never appears
  • Power users juggling multiple marketplaces and plugins
  • Developers authoring and publishing their own skills or plugins

Examples

  1. "I installed the plugin but the skill isn't listed" → compare both JSON files, spot the missing enabledPlugins entry, fix with claude plugin enable plugin@marketplace.
  2. "I pushed a new skill to GitHub but the marketplace can't find it" → verify the push, validate marketplace.json syntax, refresh the marketplace cache.
  3. "Installs keep pulling an old version" → remove the cache directory and run claude plugin marketplace update.

· · · Install guide · · ·

Install in the Claude app (no terminal)
  1. Download the ZIP with the button below.
  2. In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
  3. Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.
↓ Download ZIP
Install in Claude Code

Let Claude do it — paste this into Claude Code

Install the skill I found on Claude Skill Mart.
Copy the daymade-claude-code/claude-skills-troubleshooting folder from the GitHub repo daymade/claude-code-skills into my ~/.claude/skills/claude-skills-troubleshooting/.
When it's done, tell me in one line what this skill can do.

Install with a command instead

git clone https://github.com/daymade/claude-code-skills.git /tmp/claude-code-skills && mkdir -p ~/.claude/skills && cp -r /tmp/claude-code-skills/daymade-claude-code/claude-skills-troubleshooting ~/.claude/skills/

⚠ This is a third-party skill. Check the source repository before installing.

  1. Open your terminal.
  2. Clone the repository: git clone https://github.com/daymade/claude-code-skills.git
  3. Create the skills folder if needed: mkdir -p ~/.claude/skills
  4. Copy the whole skill folder (scripts included): cp -r claude-code-skills/daymade-claude-code/claude-skills-troubleshooting ~/.claude/skills/
  5. Verify: ls ~/.claude/skills/claude-skills-troubleshooting/SKILL.md
  6. Restart Claude Code.
  7. Ask something like "plugin not working" or "skill not showing" to trigger the skill.
  8. (Optional) Run python3 scripts/diagnose_plugins.py from the skill folder for an immediate self-check.
View source on GitHub ↗License: MIT