health-check · bitwize-music-studio — скилл для Claude Code: проверка плагина
Скилл health-check диагностирует состояние плагина: проверяет пакеты в виртуальном окружении, регистрацию скиллов и коллизии slug-ов альбомов. Запускается когда нужно убедиться, что всё настроено правильно или найти причину ошибок.
CC0-1.0 187 установок ★ 686 обновлён 2026-10-22
npx skills add bitwize-music-studio/claude-ai-music-skills --skill health-check -a claude-codeЧто делает health-check
health-check вызывает MCP-инструмент health_check и выводит отчёт в трёх разделах. Сначала проверяет пакеты в ~/.bitwize-music/venv — показывает устаревшие и отсутствующие зависимости. Затем проверяет, зарегистрированы ли скиллы в Claude Code и нет ли «привидений» — удалённых скиллов, остающихся в кэше. Наконец, ищет коллизии slug-ов альбомов, когда два жанра пытаются использовать один идентификатор.
Если проблем не найдено, выводит статус OK. При предупреждениях показывает, что сломалось, и команду для исправления — например claude plugin update bitwize-music или /bitwize-music:setup. При критических ошибках предлагает запустить более глубокую диагностику через MCP-инструмент diagnose.
Какие задачи решает
- проверить, все ли пакеты плагина установлены в виртуальное окружение
- убедиться, что скиллы зарегистрированы и доступны в редакторе
- найти и разрешить коллизии slug-ов альбомов
- диагностировать ошибки при запуске плагина
Примеры запросов агенту
- Запусти health-check, чтобы проверить состояние плагина
- Запусти health-check и покажи, что не так с конфигурацией
- Проверь здоровье плагина — может быть, не хватает пакетов
Как установить health-check
1Через Skills CLI (Vercel)
npx skills add bitwize-music-studio/claude-ai-music-skills --skill health-check -a claude-code2Вручную: положить файлы
~/.claude/skills/health-check/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/health-check/
1Через Skills CLI (Vercel)
npx skills add bitwize-music-studio/claude-ai-music-skills --skill health-check -a codex2Вручную: положить файлы
.agents/skills/health-check/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add bitwize-music-studio/claude-ai-music-skills --skill health-check -a cursor2Вручную: положить файлы
.cursor/skills/health-check/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install bitwize-music-studio/claude-ai-music-skills skills/health-check2Вручную: положить файлы
.github/skills/health-check/SKILL.md1Через Skills CLI (Vercel)
npx skills add bitwize-music-studio/claude-ai-music-skills --skill health-check -a gemini-cli2Командой платформы
gemini skills install https://github.com/bitwize-music-studio/claude-ai-music-skills --path skills/health-checkВручную: положить файлы
.devin/skills/health-check/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add bitwize-music-studio/claude-ai-music-skills --skill health-check -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о health-check
Как установить health-check в Claude Code?
Выполни npx skills add bitwize-music-studio/claude-ai-music-skills --skill health-check -a claude-code, затем открой файл ~/.claude/skills/health-check/SKILL.md.
Что делает health-check?
Проверяет виртуальное окружение плагина, регистрацию скиллов и коллизии идентификаторов альбомов. Если найдёт проблему, показывает команду для её исправления.
Какие инструменты использует health-check?
Работает через MCP-инструменты ToolSearch и bitwize-music-mcp, не использует командную строку. Может предложить запустить более детальную диагностику через diagnose.
Исходный текст
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
Похожие скиллы
Все скиллы по теме «Настройка агента: память, контекст, субагенты» →Сначала — health-check от других авторов.