mcpField
H
health-check

health-check

github.com/bitwize-music-studioTesting & quality609161 installsUpdated 2w ago
Repository

About health-check

health-check checks the bitwize-music environment. It calls an MCP health-check tool and reports the virtual environment, registered skills, and album slug collisions, including fixes when needed.

Key features

  1. 01Call the MCP health-check tool
  2. 02Report virtual environment dependencies
  3. 03Report registered skills
  4. 04Check album slug collisions
  5. 05Include fix commands for issues

Use cases

  1. 01Verify an installation environment
  2. 02Find missing or outdated dependencies
  3. 03Check skill status or album naming conflicts

MCP support

The skill calls the health_check MCP tool and presents its results.

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/bitwize-music-studio/claude-ai-music-skills --skill health-check

After installing, type/health-checkin Claude Code to confirm it loaded.

Details

From the project README

Health Check

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

Comments

Markdown supported