Health Check

SkillMedia

Runs plugin health checks (venv packages, skill registration, and album slug collisions). Use when the user asks to check plugin health, verify setup, or troubleshoot missing skills.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the Health Check skill

What this skill tells your AI

The instructions your AI receives, as published by bitwize-music-studio/claude-ai-music-skills in skills/health-check/SKILL.md and read by ahel’s review.

Your Task

Run the health_check MCP tool and report results to the user.

Workflow

IMPORTANT: Do NOT use Bash for any step. Use only the tools listed below.

  1. Use the ToolSearch tool with query select:mcp__plugin_bitwize-music_bitwize-music-mcp__health_check to load the MCP tool schema
  2. Call mcp__plugin_bitwize-music_bitwize-music-mcp__health_check (the MCP tool, not a CLI command)
  3. Report results clearly using the format below

Report Format

All OK

HEALTH CHECK: OK
  Venv: N packages verified
  Skills: N skills registered
  Collisions: no album slug collisions

Warnings

HEALTH CHECK: WARN

VENV [warn]
  N outdated: pkg1 (1.0 -> 1.1), pkg2 (2.0 -> 2.1)
  N missing: pkg3, pkg4
  Fix: <the venv check's `fix` field from the health_check result> (already the correct command for the user's OS)

SKILLS [warn]
  N missing from Claude Code: skill-a, skill-b
  N ghost (deleted but cached): skill-c
  Fix: claude plugin update bitwize-music

COLLISIONS [warn]
  N album slug collision(s):
  slug-name: kept [genre-a], shadowed by [genre-b]
  Fix: Rename one album with /bitwize-music:rename or move its directory, then run rebuild_state

For comprehensive diagnostics, run the `diagnose` MCP tool.

Failure

HEALTH CHECK: FAIL

VENV [fail]
  Venv not found at ~/.bitwize-music/venv
  Fix: /bitwize-music:setup

Remember

  1. Be concise — this is a status report
  2. Show fix commands — always include the fix command when status is not ok
  3. Suggest diagnose — if warnings are found, mention diagnose MCP tool for deeper checks

Signals

GitHub stars
488
Forks
113
Last commit
Sep 2026
Advanced
Catalog kind
skill
Gateway key
health-check
Source
github.com/bitwize-music-studio/claude-ai-music-skills