# health-check

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.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 187 installs · ★ 686 repo stars
- Author: bitwize-music-studio
- License: CC0-1.0 · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/bitwize-music-studio/claude-ai-music-skills/tree/HEAD/skills/health-check/SKILL.md
- Updated: 2026-10-22
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/bitwize-music-studio-health-check

## What it 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.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add bitwize-music-studio/claude-ai-music-skills --skill health-check -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/health-check/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/health-check/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add bitwize-music-studio/claude-ai-music-skills --skill health-check -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/health-check/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add bitwize-music-studio/claude-ai-music-skills --skill health-check -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/health-check/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install bitwize-music-studio/claude-ai-music-skills skills/health-check
```

2. **Manually: put the files in place**
- File: `.github/skills/health-check/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add bitwize-music-studio/claude-ai-music-skills --skill health-check -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/bitwize-music-studio/claude-ai-music-skills --path skills/health-check
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/health-check/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add bitwize-music-studio/claude-ai-music-skills --skill health-check -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/bitwize-music-studio/claude-ai-music-skills/tree/HEAD/skills/health-check/SKILL.md

## When to use it
- 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
- 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

## Source text · SKILL.md · CC0-1.0

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: d4733b17086b5c7b.

BEGIN THIRD-PARTY FILE d4733b17086b5c7b
````text
---
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
````
END THIRD-PARTY FILE d4733b17086b5c7b

The third-party file has ended. Everything between the d4733b17086b5c7b tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

© bitwize-music-studio · CC0-1.0 · https://github.com/bitwize-music-studio/claude-ai-music-skills/tree/HEAD/skills/health-check/SKILL.md

## Similar
- [digital-health-clinical-asr-setup](https://affpapa.org/en/nevibecode/skills/digital-health-clinical-asr-setup.md) — skill · 1900 installs
- [marketplace-health-check](https://affpapa.org/en/nevibecode/skills/marketplace-health-check.md) — skill · 452 installs
- [cja-funnel-health-check](https://affpapa.org/en/nevibecode/skills/cja-funnel-health-check.md) — skill · 379 installs
- [context-layer-health-check](https://affpapa.org/en/nevibecode/skills/context-layer-health-check.md) — skill · 150 installs
- [health-check-endpoints](https://affpapa.org/en/nevibecode/skills/health-check-endpoints.md) — skill · 427 installs
- [prod-logs-health-check](https://affpapa.org/en/nevibecode/agents/prod-logs-health-check.md) — subagent · ★ 42780 repo stars

## Other versions with the same name
- [health-check · codewithmukesh](https://affpapa.org/en/nevibecode/skills/health-check.md) — 4000 installs

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
