From health-plugin
Runs comprehensive diagnostics on Claude Code environment: plugins, settings, hooks, MCP servers. Identifies issues, supports --fix and --verbose.
npx claudepluginhub laurigates/claude-plugins --plugin health-pluginThis skill is limited to using the following tools:
Run a comprehensive diagnostic scan of your Claude Code environment. Identifies issues with plugin registry, settings files, hooks configuration, and MCP servers.
Guides Next.js Cache Components and Partial Prerendering (PPR) with cacheComponents enabled. Implements 'use cache', cacheLife(), cacheTag(), revalidateTag(), static/dynamic optimization, and cache debugging.
Guides building MCP servers enabling LLMs to interact with external services via tools. Covers best practices, TypeScript/Node (MCP SDK), Python (FastMCP).
Generates original PNG/PDF visual art via design philosophy manifestos for posters, graphics, and static designs on user request.
Run a comprehensive diagnostic scan of your Claude Code environment. Identifies issues with plugin registry, settings files, hooks configuration, and MCP servers.
| Use this skill when... | Use another approach when... |
|---|---|
| Running comprehensive Claude Code diagnostics | Checking specific component only (use /health:plugins, /health:settings) |
| Troubleshooting general Claude Code issues | Plugin registry issues only (use /health:plugins --fix) |
| Validating environment configuration | Auditing plugins for project fit (use /health:audit) |
| Identifying misconfigured settings or hooks | Just viewing settings (use Read tool on settings.json) |
| Quick health check before starting work | Need agentic optimization audit (use /health:agentic-audit) |
echo $HOMEpwdfind .claude -maxdepth 1 -name 'settings.json'find .claude -maxdepth 1 -name 'settings.local.json'| Parameter | Description |
|---|---|
--fix | Attempt to automatically fix identified issues |
--verbose | Show detailed diagnostic information |
Execute this comprehensive health check by running the diagnostic scripts. Pass --verbose and --fix flags through from $ARGUMENTS when specified.
bash "${CLAUDE_SKILL_DIR}/scripts/check-plugins.sh" --home-dir "$HOME" --project-dir "$(pwd)" [--fix] [--verbose]
Parse the STATUS= and ISSUES: lines from output.
bash "${CLAUDE_SKILL_DIR}/scripts/check-settings.sh" --home-dir "$HOME" --project-dir "$(pwd)" [--verbose]
Parse the STATUS= and ISSUES: lines from output.
bash "${CLAUDE_SKILL_DIR}/scripts/check-hooks.sh" --home-dir "$HOME" --project-dir "$(pwd)" [--verbose]
Parse the STATUS= and ISSUES: lines from output.
bash "${CLAUDE_SKILL_DIR}/scripts/check-mcp.sh" --home-dir "$HOME" --project-dir "$(pwd)" [--verbose]
Parse the STATUS= and ISSUES: lines from output.
Using the structured output from Steps 1-4, print a diagnostic report following the template in REFERENCE.md. Include status indicators (OK/WARN/ERROR), issue counts, and recommended actions. If --fix was used and fixes were applied, include a summary of changes made.
| Context | Command |
|---|---|
| Quick health check | /health:check |
| Health check with auto-fix | /health:check --fix |
| Detailed diagnostics | /health:check --verbose |
| Check plugin registry exists | test -f ~/.claude/plugins/installed_plugins.json && echo "exists" || echo "missing" |
| Validate settings JSON | jq empty .claude/settings.json 2>&1 |
| List MCP servers | jq -r '.mcpServers | keys[]' .mcp.json 2>/dev/null |
Reference these known Claude Code issues when diagnosing:
| Issue | Symptoms | Solution |
|---|---|---|
| #14202 | Plugin shows "installed" but not active in project | Run /health:plugins --fix |
| Orphaned projectPath | Plugin was installed for deleted project | Run /health:plugins --fix |
| Invalid JSON | Settings file won't load | Validate and fix JSON syntax |
| Hook timeout | Commands hang or fail silently | Check hook timeout settings |
| Flag | Description |
|---|---|
--fix | Attempt automatic fixes for identified issues |
--verbose | Include detailed diagnostic output |
/health:plugins - Detailed plugin registry diagnostics/health:settings - Settings file validation/health:hooks - Hooks configuration check/health:mcp - MCP server diagnostics