mpc-plugin-new — скилл для Claude Code: создание MPC-плагинов
Скилл mpc-plugin-new для Claude Code создаёт проект плагина для автономного оборудования Akai MPC по текстовому описанию. Запускается, когда нужно начать инструмент или аудиоэффект для MPC.
MIT ★ 200 обновлён 2026-11-07
npx skills add inmusic-software/mpc-plugin-builder-sdk --skill mpc-plugin-new -a claude-codeЧто делает mpc-plugin-new
Скилл превращает описание синтезатора, драм-машины, секвенсора-инструмента или аудиоэффекта в проект плагина для Akai MPC. До создания файлов агент согласует название плагина и производителя: имя производителя отображается на устройстве и входит в постоянную идентичность плагина.
Затем скрипт tools/new_plugin.py создаёт каркас с plugin.json, исходным C++-файлом, ui.json и README.md. Агент пишет код с опорой на SDK и DSP-хелперы, настраивает элементы интерфейса, затем собирает и тестирует проект через tools/build.py и .sdk-tools/host_sim. Сборку и тесты нужно повторять до устранения ошибок и сбоев.
Для работы нужны Python и инструменты SDK в репозитории. Готовый плагин требует MPC OS 3.10.1 или новее и включённой поддержки External plugins; его копируют в VST2 Plugins на накопителе. Переименование после сборки меняет постоянные uid и идентификаторы параметров, поэтому имена согласуются заранее.
Какие задачи решает
- создать каркас синтезатора или драм-машины для Akai MPC
- разделить параметры плагина на страницы интерфейса
- собрать и проверить новый MPC-плагин
- подготовить папку плагина для переноса на накопитель
Примеры запросов агенту
- Создай для Akai MPC синтезатор Wobble Bass от Acme Audio.
- Начни проект драм-машины с названием Dust Kit, производитель — North Sound.
- Собери аудиоэффект Tape Echo для моего бренда Amber Audio и проверь его.
Как установить mpc-plugin-new
1Через Skills CLI (Vercel)
npx skills add inmusic-software/mpc-plugin-builder-sdk --skill mpc-plugin-new -a claude-code2Вручную: положить файлы
~/.claude/skills/mpc-plugin-new/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/mpc-plugin-new/
1Через Skills CLI (Vercel)
npx skills add inmusic-software/mpc-plugin-builder-sdk --skill mpc-plugin-new -a codex2Вручную: положить файлы
.agents/skills/mpc-plugin-new/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add inmusic-software/mpc-plugin-builder-sdk --skill mpc-plugin-new -a cursor2Вручную: положить файлы
.cursor/skills/mpc-plugin-new/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install inmusic-software/mpc-plugin-builder-sdk .agents/skills/mpc-plugin-new2Вручную: положить файлы
.github/skills/mpc-plugin-new/SKILL.md1Через Skills CLI (Vercel)
npx skills add inmusic-software/mpc-plugin-builder-sdk --skill mpc-plugin-new -a gemini-cli2Командой платформы
gemini skills install https://github.com/inmusic-software/mpc-plugin-builder-sdk --path .agents/skills/mpc-plugin-newВручную: положить файлы
.devin/skills/mpc-plugin-new/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о mpc-plugin-new
Как установить mpc-plugin-new в Claude Code?
Выполни npx skills add inmusic-software/mpc-plugin-builder-sdk --skill mpc-plugin-new -a claude-code. Файл скилла появится по пути ~/.claude/skills/mpc-plugin-new/SKILL.md.
Что делает mpc-plugin-new?
Создаёт проект плагина для Akai MPC по описанию инструмента или эффекта, затем помогает написать код, настроить интерфейс, собрать и протестировать проект.
Что нужно для работы mpc-plugin-new?
Для создания проекта нужны Python и инструменты SDK из репозитория. Для запуска плагина на MPC требуются MPC OS 3.10.1 или новее и включённая поддержка External plugins.
Исходный текст
SKILL.md · MIT
--- name: mpc-plugin-new description: Create a new MPC plugin project from a plain-language description (a synth, drum machine, sequencer-instrument or audio effect for Akai MPC standalone hardware). Use when the user asks to make, start, scaffold or build a new plugin, or describes an instrument or effect they want on their MPC. --- # Create a new MPC plugin You turn a description into a complete plugin project under `plugins/<Name>/` that builds, tests and packages with the SDK tools. Work in this order; do not skip the build and test steps. ## 1. Decide the shape (ask only if truly ambiguous) From the description, settle: - **Kind**: `instrument` (makes sound from MIDI notes: synths, drum machines, samplers, sequencer-instruments) or `effect` (processes the track's audio; receives NO MIDI). An arpeggiator or step sequencer must be an instrument that makes its own sound, because plugins cannot send MIDI to the MPC. - **Name** (short, 1–3 words) and **manufacturer** (the user's name or brand). See "Confirm the manufacturer and plugin name" below; never invent a generic manufacturer such as "MPC Vibecoder". - **Parameters**: 6–24 is typical. Each gets a short screen name (≤ 12 chars), a kind (float / int / bool / choice), range, unit, default. Group them into pages of ≤ 16 for the UI. - **Channels**: instruments 0 in / 2 out (multi-out: 4, 6 or 8 outs as stereo pairs); effects 2 in / 2 out. ### Confirm the manufacturer and plugin name The manufacturer name appears on the MPC, in the folder name and in the plugin's permanent identity, so it must be a real, deliberate choice. - If the user's prompt already gives their name or brand (e.g. "by Acme Audio"), use it and do not ask again. - If it does not, **stop and ask before scaffolding**: "What name should appear as the manufacturer of this plugin? This is usually your name or your brand." - In the same message, show the plugin name you propose (e.g. "I'd call the plugin **Wobble Bass**") and invite the user to change it. If they gave a name, show that instead and still allow changes. - Wait for the answer. Only continue once both names are settled. If the user declines to give a manufacturer, ask once more explaining that it is shown on the device and is hard to change later; only then accept their stated preference. - Do not rename after the build: `uid`, folder and `plugin.json` are derived from these names (see the "Identity is permanent" rule in AGENTS.md). ## 2. Scaffold ``` python tools/new_plugin.py "<Name>" --vendor "<Manufacturer>" --kind instrument|effect ``` This creates `plugins/<Name>/` with `plugin.json`, `src/<Class>.cpp`, `ui.json`, `README.md`. The printed `uid` is already written into both `plugin.json` and the C++ `MPC_FOURCC(...)`; they must stay equal. ## 3. Write the plugin Edit `src/<Class>.cpp`. Read `framework/mpc_plugin.h` once (it is short) and follow `docs/dsp-cookbook.md`. Use the helpers in `framework/dsp/` (`oscillator.h`, `svf.h`, `adsr.h`, `delay_line.h`, `smoother.h`, `voice.h`, `lfo.h`, `biquad.h`, `tempo.h`, `math.h`) rather than writing filters and envelopes from scratch. Study `examples/SimpleSynth`, `examples/StereoDelay` and `examples/DrumSynth` for structure. Rules that are not negotiable: - No allocation, locks, logging or file I/O inside `process()`. Allocate in `prepare()`. - Treat `maxBlockSize` as a maximum; `ctx.numFrames` varies between 32 and 512. - Parameter 0 gets nudged by the host on every load: make it harmless (master volume) and keep `parameterChanged()` side-effect free. - Clamp everything that feeds a filter or a divide. Reset state in `reset()`. - Keep CPU modest: the MPC is far slower than a laptop. Per-block coefficient updates, per-sample arithmetic only. - Parameter `id` strings and the `uid` are permanent once users have projects. Then edit `ui.json` using the `mpc-plugin-ui` skill: give every control a kit widget (`knob`, `fader` or `switch`, see its heuristics) instead of the generic slider, and pick one theme. Then write `README.md` (what it does, the parameter list, tips). If the plugin needs sample, wavetable or other data files, put them in `plugins/<Name>/Content/` and load them with `mpc::contentPath(...)` / `dsp::loadWav` (see the `mpc-plugin-dsp` skill); never use absolute paths. ## 4. Build, test, iterate ``` python tools/build.py plugins/<Name> .sdk-tools/host_sim "plugins/<Name>/build/native/<slug>.dylib" test --seconds 3 --wav plugins/<Name>/build/test.wav ``` (`.so` on Linux, `.dll` on Windows.) Fix every compiler error and every `FAIL` in the report; take `WARN` lines seriously (silence, clipping, CPU). Rebuild until clean. See the `mpc-plugin-build` and `mpc-plugin-test` skills. ## 5. Hand over Tell the user: the output folder path (`plugins/<Name>/build/<Manufacturer> - VST - <Name>/`), how to copy it to `VST2 Plugins` on a drive, that the MPC needs MPC OS 3.10.1 or later, and that External plugins must be enabled on the device (Preferences → Enhancements (Beta) → Enable Enhancements and External Plugin Support), and offer to package it (`mpc-plugin-package` skill). Summarise the parameters and pages you created.
© inmusic-software · MIT · inmusic-software/mpc-plugin-builder-sdk