bitwize-music-studio/claude-ai-music-skills / skills/health-check
health-check
VerifiedRuns 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.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 2.3 KB |
SKILL.md
View on GitHub---
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
Suno: MCP server configured as 'suno' (local)
```
When the `suno` check is `info` (no Suno MCP server registered), the overall status is still OK — the server is optional. Add one line under the OK block, from the result's `suno.fix`:
```
SUNO [info]
No Suno MCP server registered (optional — /bitwize-music:generate and /bitwize-music:listen need it)
Add it: claude mcp add --transport http suno https://api.suno.com/mcp — then run /mcp and sign in
```
### 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
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |