Skip to main content
skill CX Codex

health-check · bitwize-music-studio — Claude Code skill: plugin diagnostics

health-check — a skill that runs plugin diagnostics: checks virtual environment packages, verifies skill registration, and detects album slug collisions. Use it to confirm your setup is correct or troubleshoot missing components.

CC0-1.0 187 installs ★ 686 updated 2026-10-22

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add bitwize-music-studio/claude-ai-music-skills --skill health-check -a claude-code
Open on GitHub

What health-check does

health-check calls the health_check MCP tool and produces a structured report across three areas. It scans packages in ~/.bitwize-music/venv, flagging outdated or missing dependencies. It verifies that skills are registered in Claude Code and identifies stale cached entries from deleted skills. It also scans for album slug collisions, where two genres attempt to claim the same identifier.

When all checks pass, you get an OK status. If warnings arise, the skill shows what failed and provides the fix command—such as claude plugin update bitwize-music or /bitwize-music:setup. For critical failures, it suggests running the deeper diagnose MCP tool.

What it helps with

  • verify all plugin packages are installed in the virtual environment
  • confirm skills are registered and discoverable in the editor
  • locate and resolve album slug collisions
  • diagnose plugin startup errors and missing components

Example prompts for the agent

  • Run health-check to see if the plugin setup is complete
  • Run health-check and show me what's broken in the configuration
  • Check the plugin's health—something might be missing

How to install health-check

1Skills CLI (Vercel)

npx skills add bitwize-music-studio/claude-ai-music-skills --skill health-check -a claude-code

2Manually: put the files in place

~/.claude/skills/health-check/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/health-check/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about health-check

How do I install health-check in Claude Code?

Run npx skills add bitwize-music-studio/claude-ai-music-skills --skill health-check -a claude-code, then open ~/.claude/skills/health-check/SKILL.md.

What does health-check do?

It scans the plugin's virtual environment, verifies skill registration, and checks for identifier collisions. If it finds a problem, it shows the command to fix it.

What tools does health-check use?

It runs through the ToolSearch and bitwize-music-mcp MCP tools—no shell commands involved. For deeper insight, it can suggest running the diagnose tool.

Source text

SKILL.md · CC0-1.0
---
name: health-check
description: 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.
model: haiku
allowed-tools:
  - ToolSearch
  - bitwize-music-mcp
---

# 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

© bitwize-music-studio · CC0-1.0 · bitwize-music-studio/claude-ai-music-skills

Similar skills

All skills for Agent setup: memory, context, orchestration →

health-check by other authors comes first.

health-check codewithmukesh health-check — a skill for Claude Code, Codex, Cursor and other agents that grades a .NET project across 8 dimensions, each scored A–F with a fixed rubric. The overall GPA only averages dimensions that were actually assessed. CX Codex +1 4,000installs health-check hoangsonww The health-check skill checks Agent Monitor’s API, database, WebSocket, endpoints, hooks, and data freshness. Use it to spot issues in a monitoring setup. CX Codex +1 ★ 1,198repo stars digital-health-clinical-asr-setup Ben Randoing digital-health-clinical-asr-setup sets up the environment for NVIDIA's Clinical ASR Flywheel, verifies the NVIDIA_API_KEY, installs Python dependencies, and runs an end-to-end smoke test. CX Codex +1 1,900installs marketplace-health-check daymade marketplace-health-check runs a parallel audit of a skills marketplace repo: script safety, docs, PII, open PRs and issues, manifest integrity. CX Codex +1 452installs cja-funnel-health-check Adobe cja-funnel-health-check — a skill for Claude Code and Codex that builds step-by-step funnel analysis: how many users drop off at each stage and where the worst transition is. CX Codex +1 379installs context-layer-health-check PostHog The context-layer-health-check Claude Code skill checks a context wiki after changes are consolidated. It triages missed entries, conflicting claims, and outdated priorities. CX Codex +1 150installs health-check-endpoints secondsky health-check-endpoints is a Claude Code skill for adding service health and readiness checks. It applies to Kubernetes probes, load balancers, and dependency monitoring. CX Codex +1 427installs prod-logs-health-check Sharrmavishal prod-logs-health-check pulls production logs and filters errors after deployments or load tests. Relies directly on raw log entries rather than monitoring dashboards. CX Codex ★ 42,780repo stars

From the same set52

The whole set →
validate-album validate-album is a Claude Code skill that checks album directories, audio file paths, and track metadata before release. CX Codex +1 248installs researchers-financial researchers-financial is a Claude Code skill that researches financial records and market data for music projects about companies, financial crime, or market events. It gathers sources and marks claims for human review. CX Codex +1 248installs next-step next-step analyzes music album progress and recommends the single best next action with the exact command to run. CX Codex +1 247installs configure configure is a Claude Code skill that interactively creates, edits, and checks the ~/.bitwize-music/config.yaml configuration file. CX Codex +1 247installs cloud-uploader cloud-uploader is a skill for uploading album promo videos and samplers to Cloudflare R2 or AWS S3 after the videos are created. CX Codex +1 247installs resume resume finds an album by name and displays its status with a concrete next step. Use when returning to an unfinished project or checking where an album stands in its workflow. CX Codex +1 246installs researchers-primary-source The researchers-primary-source skill gathers statements from tweets, blogs, forums and chat logs. Use it when you need direct quotes or first-hand accounts instead of paraphrased reporting. CX Codex +1 246installs promote-idea promote-idea turns a pending album concept in IDEAS.md into a project with one command. Use it when an idea is ready to move into album planning. CX Codex +1 188installs

Project sponsors

Companies that keep this analytics open