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

mpc-plugin-ui — скилл для Claude Code: интерфейс MPC

Скилл mpc-plugin-ui для Claude Code настраивает сенсорный интерфейс и Q-Link для MPC-плагина. Агент подключает его, когда нужно разложить элементы по страницам, задать темы или собрать скин.

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

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

Что делает mpc-plugin-ui

Скилл помогает создавать интерфейс MPC-плагина через ui.json или вручную собранные TUI.json и Q-Links.json. Для простого варианта он использует набор элементов SDK и скрипт tools/build.py; параметры берутся из build/params.json после нативной сборки. Можно задавать страницы, ручки, фейдеры, переключатели, подписи, темы и условия показа элементов.

В ручном формате доступны собственные изображения и точная раскладка. Версии объектов и ключи в JSON должны соответствовать формату MPC: ошибка может убрать все вкладки плагина. После правок скин проверяет python tools/validate.py plugins/<Name>. Для генерации нужны Python и файлы SDK; ручной вариант требует внимательно сверять индексы параметров и вкладок.

Какие задачи решает

  • разложить параметры плагина по страницам MPC
  • назначить Q-Link ручкам и фейдерам
  • настроить видимость элемента по значению параметра
  • собрать скин с собственными изображениями

Примеры запросов агенту

  • Разложи параметры MPC-плагина по страницам через ui.json.
  • Настрой Q-Link для ручек и фейдеров этого плагина.
  • Собери ручной скин в TUI.json и Q-Links.json.

Как установить mpc-plugin-ui

1Через Skills CLI (Vercel)

npx skills add inmusic-software/mpc-plugin-builder-sdk --skill mpc-plugin-ui -a claude-code

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

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

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

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о mpc-plugin-ui

Как установить mpc-plugin-ui в Claude Code?

Выполни npx skills add inmusic-software/mpc-plugin-builder-sdk --skill mpc-plugin-ui -a claude-code. Файл скилла находится по пути ~/.claude/skills/mpc-plugin-ui/SKILL.md.

Что делает mpc-plugin-ui?

Помогает проектировать интерфейс MPC-плагина и назначать аппаратным ручкам Q-Link параметры. Работает с простым ui.json или полными файлами скина TUI.json и Q-Links.json.

Что нужно для работы mpc-plugin-ui?

Для сборки и проверки нужны Python и файлы SDK. Чтобы получить список параметров для ui.json, сначала выполняется нативная сборка плагина.

Исходный текст

SKILL.md · MIT
---
name: mpc-plugin-ui
description: Design or change an MPC plugin's touch-screen UI and hardware knob (Q-Link) mapping, via the simple ui.json layout (film-strip knobs, faders and switches from the SDK's UI kit) or the full Plugin Skins JSON format (TUI.json, Q-Links.json). Use when the user wants pages, knobs, faders, switches, layout, labels, themes, conditional controls, images or custom skins for their plugin.
---

# Plugin UI on the MPC

The MPC draws plugin UIs from JSON skins in `Plugin Skins/`. Two ways to produce them. Use A unless the user asks for something it cannot do.

## A. The simple way: `ui.json` with the UI kit (default)

Edit `plugins/<Name>/ui.json`; `tools/build.py` turns it into the skin files. Full format: `docs/ui-guide.md`; schema: `schemas/ui.schema.json`. **Always give every parameter a real widget (`knob`, `fader` or `switch`) rather than the generic `slider`**; the generic bar is a fallback for long choice lists only. The kit graphics live in `ui-kit/` (look at `ui-kit/preview.png`; `ui-kit/README.md` explains them).

```json
{ "kit": "mpc-red",
  "pages": [ { "name": "FILTER", "controls": [
      { "param": "Cutoff",  "widget": "knob" },
      { "param": "Reso",    "widget": "knob" },
      { "param": "Mode",    "widget": "switch" },
      { "param": "Env Amt", "widget": "knob", "polarity": "bipolar" },
      { "param": "Attack",  "widget": "fader" }, { "param": "Decay", "widget": "fader" },
      { "param": "Sustain", "widget": "fader" }, { "param": "Release", "widget": "fader" },
      { "param": "Shape",   "widget": "slider", "overlay": "menu" },
      { "param": "Rate",    "widget": "knob", "visibleWhen": { "param": "Sync", "choice": "Off" } },
      "empty", { "widget": "text", "text": "Modulation" } ] } ] }
```

- Controls are parameter **names** exactly as declared in code (not ids). `build/params.json` lists them after a native build.
- ≤ 16 controls per page, reading order into a 4 × 4 grid that matches the 16 hardware knobs. The MPC itself does not require a grid (hand-written skins place controls freely), but the knobs work in **groups of four** and the focus rectangle wraps a group, so arrange controls as blocks of four (a row of four or a column of four; Q-Link groups can be horizontal or vertical). Each block should be one coherent set, so the interface looks intentionally aligned; page names ≤ 8 characters; ≤ 32 pages.
- Widgets: `knob`, `fader`, `switch` (kit), `slider` (generic bar), `text`, `empty`. `polarity` (`auto` / `unipolar` / `bipolar`) on knobs and faders. `overlay: "menu"` for long choice lists. `visibleWhen` shows a control only for a given choice/bool value.
- `kit`: `mpc-red` (default), `amber`, `cyan`, `lime`, `violet`, `mono`, or `{ "theme": "...", "accent": "AARRGGBB" }`. One theme per plugin. The build renders it (cached in `build/`) and copies only the PNGs the layout uses.
- `switch` needs a bool or a choice parameter with ≤ 4 choices; the generator fails with a hint otherwise.
- Bool and choice parameters automatically get discrete steps and labels.

### Which widget (apply these, in order)

1. **Bool → `switch`.** Choice with 2–4 options → `switch` (captioned segments). Choice with 5+ → `slider` + `"overlay": "menu"`.
2. **Levels, mix, dry/wet, sends, envelope stages → `fader`.** Put A, D, S, R as four faders in one row or one column.
3. **Anything centred on zero (pan, tune, pitch offset, signed mod amounts) → `knob`, bipolar.** Auto-detection catches centre-zero defaults; set `"polarity": "bipolar"` when the range is signed but the default is not zero.
4. **Every other continuous parameter (cutoff, resonance, drive, time, feedback, rate, depth, width) → `knob`.**
5. `slider` only when the value text is the point (note names, divisions, ratios) or the list is long.
6. **Design in blocks of four.** One related set per row or column of four (envelope ADSR, filter cutoff/resonance/drive/tracking, delay time/feedback/tone/mix); never split a set across two blocks; use `empty` or a `text` heading rather than a stray control to complete a block. Choose rows or columns per page for whichever reads best, and stay consistent within a page.
7. Same role, same widget on every page. Top row of page 1 = the four controls touched first, knobs or faders, never switches. Group by signal flow; keep a section's mode switch beside the knobs it affects. Rarely used settings go on a `MORE` page; leave them out of the UI if they are rarely touched (still saved and automatable).
8. Theme: `mpc-red` unless the plugin has a character (`amber` drums/analogue, `cyan` delay/reverb/digital, `lime`/`violet` playful, `mono` utilities) or the user names a colour (`accent`).

Regenerate by rebuilding (`python tools/build.py plugins/<Name>`), or run the generator alone for a quick check:
`python tools/gen_ui.py --params plugins/<Name>/build/params.json --ui plugins/<Name>/ui.json --out "plugins/<Name>/build/<Manufacturer> - VST - <Name>/Plugin Skins" --kit-cache plugins/<Name>/build`. Read its NOTE lines (bipolar auto-detection) and fix any ERROR (it names the control and the allowed values).

## B. Full control: hand-written skins

Create `plugins/<Name>/skins/` containing `TUI.json`, `Q-Links.json` and any images; the build copies it verbatim and does not run the generator. Start from the generated files in `build/<folder>/Plugin Skins/` (they already contain the kit PNGs and the component definitions for knobs, faders, toggles and segments) and edit. `python tools/make_ui_kit.py --out plugins/<Name>/skins --theme cyan` renders a full kit there, including vertical faders, small knobs and LED buttons that `ui.json` does not use; `ui-kit/README.md` gives the TUI.json snippet for each. The complete format, every widget and every key, is in `docs/ui-reference.md`; read the relevant sections before editing. Critical facts:
- Every object has an integer `version` the MPC checks; wrong versions or a missing key make the **whole file fail**, and the plugin then shows no tabs at all.
- `"Parameter N"` handles are 0-based parameter indices; `Q-Links.json` `Tab`/`SubTab` are 1-based; knob values are 0-based indices or -1.
- Overlay widgets need the documented duplicate `version` keys; do not "fix" them.
- Film-strip frames and button images are drawn at their native pixel size, never scaled: size the entry bounds to the asset. Labels do not intercept touches, so captions can sit over buttons.
- Tab area is 1280 × 628; overlays 1280 × 800; fonts Titillium Web / Roboto / Nexa only; images PNG/JPEG relative to the file; colours `AARRGGBB`.
- Run `python tools/validate.py plugins/<Name>` after editing; it checks versions, indices, image presence and JSON validity.

Own knob artwork instead of the kit: `python tools/make_knob.py plugins/<Name>/assets/knob.png --frames 127 --size 90` then `"knobImage": "knob.png"` in `ui.json` (files in `assets/` are copied into `Plugin Skins/`).

© inmusic-software · MIT · inmusic-software/mpc-plugin-builder-sdk

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

Все скиллы по теме «Фронтенд и UI» →
html-visualization sevos Скилл html-visualization для Claude Code генерирует автономные интерактивные HTML-страницы со схемами Mermaid и подсветкой кода из репозитория. Создаёт наглядные гайды и слайды. CX Codex +1 2установок playwright-visual-testing bradtaylorsf Скилл playwright-visual-testing с готовыми шаблонами визуального регрессионного тестирования на Playwright. Помогает настроить скриншотные тесты компонентов, маски динамических данных и снимки в CI. CX Codex +1 1установок design-workflow c0x12c Скилл design-workflow для Claude Code помогает проектировать и проверять интерфейсы с опорой на дизайн-систему проекта. Помогает создавать прототипы, компоненты и адаптивные экраны. CX Codex +1 ★ 111звёзд репо design-intelligence c0x12c Скилл design-intelligence собирает дизайн-систему с нуля: палитра, типографика, отступы, радиусы и инвентарь компонентов в трёх форматах. CX Codex +1 ★ 111звёзд репо ui-ux-design-principles databricks-solutions Скилл ui-ux-design-principles для Claude Code: канон решений о пользовательском опыте — чек-лист ревью, жёсткие правила и ссылки на детали. Закрывает строки перед мержем интерфейса или при проверке чужого. CX Codex +1 ★ 38звёзд репо analyse-design sammcj Скилл analyse-design для Claude Code анализирует код и скриншоты приложения, сайта или документа и описывает дизайн-систему. Помогает провести аудит интерфейса и создать согласованные компоненты. CX Codex +1 ★ 173звёзд репо

Из того же набора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-new Скилл mpc-plugin-new для Claude Code создаёт проект плагина для автономного оборудования Akai MPC по текстовому описанию. Запускается, когда нужно начать инструмент или аудиоэффект для MPC. CX Codex +1 ★ 200звёзд репо mpc-plugin-deploy Скилл mpc-plugin-deploy для Claude Code устанавливает и управляет VST2-плагинами на Akai MPC по сети. Запускается, когда нужно перенести плагин на устройство или сохранить его копию. CX Codex +1 ★ 200звёзд репо

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

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