К основному содержанию
скилл CX Codex

mpc-plugin-troubleshoot — скилл для Claude Code

Скилл mpc-plugin-troubleshoot для Claude Code помогает искать причины сбоев плагинов MPC и проблем со сборкой или тестированием. Разбирает случаи, когда плагин не отображается, не загружается, теряет настройки или звучит с ошибками.

MIT ★ 200 обновлён 2026-11-07

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add inmusic-software/mpc-plugin-builder-sdk --skill mpc-plugin-troubleshoot -a claude-code
Открыть на GitHub

Что делает 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-code

2Вручную: положить файлы

~/.claude/skills/mpc-plugin-troubleshoot/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/mpc-plugin-troubleshoot/

По шагам, с командами для каждой платформы: Как установить скилл в 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

Похожие скиллы

Каталог скиллов SKILL.md →
dynamo-troubleshoot Dan Gil Скилл dynamo-troubleshoot для Claude Code разбирает сбои в развёртываниях Dynamo. Он подключается, когда ломаются поды, PVC, модельный кэш, воркеры, эндпоинты или бенчмарки. CX Codex +1 1 900установок troubleshoot-binlog-mcp dotnet Скилл troubleshoot-binlog-mcp диагностирует сбои запуска binlog MCP-сервера dotnet-msbuild и помогает найти причину проблем с SDK, NuGet feeds или настройками хоста. CX Codex +1 1 300установок webflow-code-component:troubleshoot-deploy webflow Скилл webflow-code-component:troubleshoot-deploy для Claude Code диагностирует ошибки деплоя Webflow Code Components. Запускается после сбоя webflow library share или проблем с опубликованным компонентом. CX Codex +1 1 000установок revenuecat-troubleshoot RevenueCat Скилл revenuecat-troubleshoot находит причины ошибок в интеграции RevenueCat на iOS, Android, Flutter и React Native. Проверяет ключи, конфигурацию в панели управления и логи SDK. CX Codex +1 1 000установок troubleshoot-ssi datadog-labs Скилл troubleshoot-ssi для Claude Code находит причины отсутствия APM-трейсов Datadog и сбоев Single Step Instrumentation в Kubernetes. Диагностирует цепочку, когда агент настроен, но трейсы не поступают. CX Codex +1 472установок svelte-storybook-troubleshoot davila7 Слэш-команда svelte-storybook-troubleshoot разбирает типовые поломки Storybook в проектах на SvelteKit: ошибки сборки, неразрешённые модули, конфликты аддонов. CX Codex +1 118установок

Из того же набора9

mpc-plugin-presets Скилл mpc-plugin-presets для Claude Code помогает добавлять встроенные пресеты в плагины MPC и разбирать файлы пресетов .xpl. Подключается по запросам о программах, патчах, звуковых банках и начальном патче. CX Codex +1 ★ 200звёзд репо mpc-plugin-package Скилл mpc-plugin-package для Claude Code упаковывает собранный MPC-плагин в ZIP с инструкцией по установке. Запускается, когда нужно отправить плагин другим или подготовить его к публикации. CX Codex +1 ★ 200звёзд репо mpc-plugin-test Скилл mpc-plugin-test для Claude Code проверяет MPC-плагин в симуляторе хоста SDK до установки на устройство. Запускает тесты после сборки и помогает разбирать тишину, шум, сбои и потерю настроек. CX Codex +1 ★ 200звёзд репо mpc-plugin-build Скилл mpc-plugin-build для Claude Code собирает проект MPC-плагина в папку для установки и помогает исправлять ошибки сборки. Запускается, когда нужно скомпилировать плагин или сборка завершается с ошибкой. CX Codex +1 ★ 200звёзд репо mpc-plugin-dsp Скилл mpc-plugin-dsp для Claude Code помогает писать и менять DSP-код MPC-плагина. Включается при работе с синтезом, эффектами, MIDI или параметрами. CX Codex +1 ★ 200звёзд репо mpc-plugin-new Скилл mpc-plugin-new для Claude Code создаёт проект плагина для автономного оборудования Akai MPC по текстовому описанию. Запускается, когда нужно начать инструмент или аудиоэффект для MPC. CX Codex +1 ★ 200звёзд репо mpc-plugin-ui Скилл mpc-plugin-ui для Claude Code настраивает сенсорный интерфейс и Q-Link для MPC-плагина. Агент подключает его, когда нужно разложить элементы по страницам, задать темы или собрать скин. CX Codex +1 ★ 200звёзд репо mpc-plugin-deploy Скилл mpc-plugin-deploy для Claude Code устанавливает и управляет VST2-плагинами на Akai MPC по сети. Запускается, когда нужно перенести плагин на устройство или сохранить его копию. CX Codex +1 ★ 200звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой