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

mpc-plugin-new — скилл для Claude Code: создание MPC-плагинов

Скилл mpc-plugin-new для Claude Code создаёт проект плагина для автономного оборудования Akai MPC по текстовому описанию. Запускается, когда нужно начать инструмент или аудиоэффект для MPC.

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

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

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

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

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

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

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

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

Каталог скиллов SKILL.md →
recipe-copy-sheet-for-new-month официальный googleworkspace Скилл recipe-copy-sheet-for-new-month для Claude Code дублирует шаблонный лист Google Sheets и переименовывает его для нового месяца. Запускается агентом при работе с таблицами отслеживания или учёта. CX Codex +1 31 200установок angular-new-app Angular Team @ Google Скилл angular-new-app для быстрого создания нового Angular-приложения с помощью Angular CLI. Проверяет окружение, генерирует проект с нужными флагами и направляет разработку по лучшим практикам Angular. CX Codex +1 21 200установок new-unity-project Unity-Technologies Скилл new-unity-project автоматизирует создание проекта в Unity: от концепта до инициализации git, пакетов и фоновой установки редактора. CX Codex +1 8 000установок asc-whats-new-writer rorkai Скилл asc-whats-new-writer для Claude Code и Codex готовит локализованные заметки «Что нового» из Git-коммитов, списка изменений или свободного описания. Готовит текст к обновлению приложения в App Store. CX Codex +1 6 100установок new-terraform-provider hashicorp Скилл new-terraform-provider для Claude Code создаёт каркас нового провайдера Terraform на Plugin Framework. Запускается при старте проекта для нового API. CX Codex +1 4 100установок openspec-new-change openspec Скилл openspec-new-change для Claude Code создаёт новые изменения через рабочий процесс OpenSpec. Формирует каталог изменения, проверяет статус артефактов и показывает инструкции для первого шага. CX Codex +1 3 800установок

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

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

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