claude-skills-troubleshooting
An agent skill by daymade, from daymade/claude-code-skills. Tags: claude-code, debugging, setup, troubleshooting, validation.
What it does
Diagnose and resolve Claude Code plugin and skill issues. This skill should be used when plugins are installed but not showing in available skills list, skills are not activating as expected, or when troubleshooting enabledPlugins configuration in settings.json. Triggers include "plugin not working", "skill not showing", "installed but disabled", or "enabledPlugins" issues.
Install
With the skills CLI, which installs into Claude Code, Codex, Cursor and other agents:
npx skills add daymade/claude-code-skills --skill claude-skills-troubleshooting
Or copy the skill folder into Claude Code's skills directory by hand (~/.claude/skills for every project, or .claude/skills inside one):
git clone --depth 1 https://github.com/daymade/claude-code-skills
cp -r claude-code-skills/daymade-claude-code/claude-skills-troubleshooting ~/.claude/skills/claude-skills-troubleshooting
Safety box score
Grade B, low risk: 25 of 100 risk points, rated 2026-10-20. The grade rates what the skill and its scripts can reach on the machine of whoever installs it, across eight categories from shell execution to secrets access. How the score works.
This skill troubleshoots Claude Code plugin state and can read and modify the user’s `~/.claude` configuration, including bulk-enabling plugins and clearing marketplace cache files. Its main risks are local config changes and remote marketplace/git interactions; it does not handle secrets or elevate privileges.
| Category | Level | Why |
|---|---|---|
| Code & shell execution | 1 (low) | It runs shipped Python utilities via `python3 scripts/diagnose_plugins.py` and `python3 scripts/enable_all_plugins.py`; there is no arbitrary code evaluation or untrusted script download. |
| Network access | 2 (moderate) | It directs use of `claude plugin marketplace update/install` and `git push`, so troubleshooting can fetch from and send data to remote hosts. |
| Filesystem reach | 2 (moderate) | It reads and writes `~/.claude/settings.json` and `~/.claude/plugins/installed_plugins.json`, and it recommends `rm -rf ~/.claude/plugins/cache/marketplace-name` to clear cache files. |
| Secrets & credentials | 0 (none) | No commands or scripts reference tokens, API keys, browser sessions, `.env` files, keychains, or password stores. |
| Privilege & persistence | 0 (none) | There is no sudo, service registration, shell startup editing, or other privilege-changing action. |
| Instruction hijack surface | 0 (none) | The files do not instruct the agent to ignore rules, hide actions, or follow untrusted remote instructions; the system-prompt note in `references/architecture.md` is descriptive only. |
| Irreversible actions | 2 (moderate) | The skill can enable, disable, uninstall, and batch-enable plugins, and it suggests `git push`, which changes local state or publishes changes after user action. |
| Transparency | 0 (none) | All shipped files are plain text Markdown/Python; there are no binaries, minified blobs, or opaque installers. |
Before installing
- Read `scripts/enable_all_plugins.py`; it writes `~/.claude/settings.json` directly.
- Decide whether you are okay with deleting `~/.claude/plugins/cache/<marketplace>` if you use the cache-reset path.
- Check whether `~/.claude/plugins/installed_plugins.json` is a symlink before using the multi-profile reinstall workaround.
- Run `python3 scripts/diagnose_plugins.py` in a spare Claude profile first.
Rated 2026-10-20 by an automated review of 5 files from the skill's repository.
Source
- Repository
- daymade/claude-code-skills (all skills from this repository)
- Path
- daymade-claude-code/claude-skills-troubleshooting/SKILL.md
- Branch
- main
- Updated
- 2026-09-20
Related skills
- debug-voice — Use when the user runs /debug-voice, says voice mode has flaws, asks to see or capture what happened in a Grok realtime voice session.
- fix-ci — Find failing PR checks, inspect logs or external check links, and apply focused fixes
- principle-fix-root-causes — Apply when debugging.
- reproduce-and-fix-issues — Reproduce triaged Slack bugs through a configured app-control adapter, verify existing fixes.
- X MCP guide — ALWAYS read this when a user connects the X plugin or any X MCP, before using any X connection, and again on any X error.
- debugging-network-issues — Investigates network, streaming, and protocol failures with falsification-first layered experiments.