mpc-plugin-troubleshoot — скилл для Claude Code
Скилл mpc-plugin-troubleshoot для Claude Code помогает искать причины сбоев плагинов MPC и проблем со сборкой или тестированием. Разбирает случаи, когда плагин не отображается, не загружается, теряет настройки или звучит с ошибками.
MIT ★ 200 обновлён 2026-11-07
npx skills add inmusic-software/mpc-plugin-builder-sdk --skill mpc-plugin-troubleshoot -a claude-codeЧто делает mpc-plugin-troubleshoot
Скилл ведёт диагностику плагина MPC по симптомам: проверяет прошивку и настройки поддержки внешних плагинов, расположение папки, архитектуру и файлы конфигурации. Для проверки предлагает запустить python tools/validate.py plugins/<Name> и симулятор хоста с нужными параметрами. Список проверок охватывает отсутствие звука, сбои интерфейса и щелчки при загрузке.
При щелчках проверяется параметр 0, который хост может сдвинуть при загрузке; в таком случае скилл предлагает сделать его безопасным и сглаженным. Для восстановления после зависания предлагается удалить папку плагина, а воспроизведение сбоя провести в симуляторе. Для диагностики нужен Python; при несовпадении архитектуры или слишком новой glibc плагин может не загрузиться.
Какие задачи решает
- найти причину, по которой MPC не показывает плагин
- разобраться, почему плагин не загружается или вызывает сбой
- проверить отсутствие вкладок интерфейса и неверную работу Q-Links
- выяснить, почему пропал звук, появились щелчки или потерялись настройки
Примеры запросов агенту
- Разберись, почему MPC не показывает мой плагин.
- Проверь, из-за чего плагин загружается без вкладок интерфейса.
- Найди причину щелчков при загрузке и потери настроек после обновления.
Как установить mpc-plugin-troubleshoot
1Через Skills CLI (Vercel)
npx skills add inmusic-software/mpc-plugin-builder-sdk --skill mpc-plugin-troubleshoot -a claude-code2Вручную: положить файлы
~/.claude/skills/mpc-plugin-troubleshoot/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/mpc-plugin-troubleshoot/
1Через Skills CLI (Vercel)
npx skills add inmusic-software/mpc-plugin-builder-sdk --skill mpc-plugin-troubleshoot -a codex2Вручную: положить файлы
.agents/skills/mpc-plugin-troubleshoot/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add inmusic-software/mpc-plugin-builder-sdk --skill mpc-plugin-troubleshoot -a cursor2Вручную: положить файлы
.cursor/skills/mpc-plugin-troubleshoot/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install inmusic-software/mpc-plugin-builder-sdk .agents/skills/mpc-plugin-troubleshoot2Вручную: положить файлы
.github/skills/mpc-plugin-troubleshoot/SKILL.md1Через Skills CLI (Vercel)
npx skills add inmusic-software/mpc-plugin-builder-sdk --skill mpc-plugin-troubleshoot -a gemini-cli2Командой платформы
gemini skills install https://github.com/inmusic-software/mpc-plugin-builder-sdk --path .agents/skills/mpc-plugin-troubleshootВручную: положить файлы
.devin/skills/mpc-plugin-troubleshoot/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о mpc-plugin-troubleshoot
Как установить mpc-plugin-troubleshoot в Claude Code?
Выполни npx skills add inmusic-software/mpc-plugin-builder-sdk --skill mpc-plugin-troubleshoot -a claude-code. Файл скилла находится по пути ~/.claude/skills/mpc-plugin-troubleshoot/SKILL.md.
Что делает mpc-plugin-troubleshoot?
Скилл помогает диагностировать проблемы плагинов MPC: от отсутствия в списке и ошибок загрузки до сбоев звука, интерфейса и сохранения настроек. Он предлагает проверки для плагина и инструментов сборки или тестирования.
Что нужно для диагностики mpc-plugin-troubleshoot?
Для запуска валидатора нужен Python. Скилл также использует симулятор хоста для отдельных проверок.
Исходный текст
SKILL.md · MIT
--- name: mpc-plugin-troubleshoot description: Diagnose an MPC plugin that does not appear, fails to load, shows no UI tabs, crashes the MPC, sounds wrong, glitches, or loses settings. Use when the user reports a problem on the MPC hardware or with the build/test tools. --- # Troubleshooting checklist Work top-down; stop when the cause is found. Full list in `docs/troubleshooting.md`. 1. **Not listed on the MPC** → MPC OS 3.10.1 or later (Preferences → Info)? Older firmware ignores the folder. Preferences → Enhancements (Beta): both *Enable Enhancements* and *External Plugin Support* on? Folder inside `VST2 Plugins` at the drive root? `plugin.json` valid, `numOutputs > 0`, correct `file32`/`file64` for that MPC's architecture? Run `python tools/validate.py plugins/<Name>`. 2. **"VST2 failed to load"** → wrong architecture, glibc too new, extra library dependency, crash in `VSTPluginMain`. Validator + `host_sim ... test --verbose`. Try the internal drive instead of USB. 3. **Loads, no tabs on the edit screen** → `TUI.json` failed to parse (version numbers, missing keys, trailing commas). Validate; regenerate from `ui.json` if hand edits broke it. 4. **Knobs move the wrong thing** → `Q-Links.json` uses 0-based parameter indices and 1-based `Tab`; compare with `build/params.json`. 5. **Default UI shown instead of the skin** → folder name, `plugin.json` name/manufacturer and `PluginInfo` name/vendor disagree. 6. **No sound / wrong sound** → host simulator with `--wav`; check MIDI handling, envelopes, gain, filter stability. 7. **Glitches / dropouts** → CPU or a lock/allocation in `process`. Simplify; raise the MPC's block size in audio preferences to confirm. 8. **Crash / freeze** → remove the folder to recover; reproduce in the simulator with `--block 32 --seconds 30`; look for out-of-range indices and uninitialised state. 9. **Settings lost after update** → `uid` or parameter `id` strings changed. Restore the originals. 10. **Click on load** → parameter 0 is nudged by the host; make it harmless and smoothed. When reporting back, say what was checked, what was found, and what changed.
© inmusic-software · MIT · inmusic-software/mpc-plugin-builder-sdk