Skip to main content
skill CX Codex

mpc-plugin-test — Claude Code skill for MPC plugin tests

mpc-plugin-test — a Claude Code skill that tests MPC plugins in the SDK host simulator before they reach hardware. It runs after builds and helps investigate silence, noise, crashes, glitches, or lost settings.

MIT ★ 200 updated 2026-11-07

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add inmusic-software/mpc-plugin-builder-sdk --skill mpc-plugin-test -a claude-code
Open on GitHub

What mpc-plugin-test does

The skill runs an MPC plugin through the SDK host simulator. It inspects the plugin’s name, UID, and parameters, then checks WAV rendering, MIDI, state round trips, parameter sweeps, stability, and CPU use. The report separates failures such as crashes, invalid output, and mismatched parameters from warnings about silence, clipping, or high CPU.

The simulator cannot stand in for testing on an MPC. Its CPU reading is for the computer running the test; the MPC is 10–40 times slower, so the simulator average should stay below a few percent. For silent output, the skill points to isNoteOn, envelope handling, output gain, and writes to ctx.outputs. For clicks, it suggests checking parameter smoothing and phase resets.

Listen to the rendered WAV, then test on the MPC: copy the plugin folder to VST2 Plugins, enable Preferences → Enhancements (Beta) → External Plugin Support, load the plugin, and save and reload a project.

What it helps with

  • run plugin checks after each build
  • trace silent or noisy output
  • catch crashes and broken state round trips
  • inspect MIDI behavior and CPU use

Example prompts for the agent

  • Test my MPC plugin after the build with the SDK host simulator.
  • The plugin is silent; check its note handling and output.
  • Find the cause of clicks and verify that plugin settings survive a reload.

How to install mpc-plugin-test

1Skills CLI (Vercel)

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

2Manually: put the files in place

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

Copy the whole skill folder; for one project use .claude/skills/mpc-plugin-test/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about mpc-plugin-test

How do I install mpc-plugin-test in Claude Code?

Run npx skills add inmusic-software/mpc-plugin-builder-sdk --skill mpc-plugin-test -a claude-code. The skill file is at ~/.claude/skills/mpc-plugin-test/SKILL.md.

What does mpc-plugin-test do?

It tests an MPC plugin with the SDK host simulator, covering WAV rendering, MIDI, state, parameters, stability, and CPU use. It also helps interpret the simulator report and investigate common audio problems.

Can the simulator replace testing on an MPC?

No. The simulator catches some crashes and DSP bugs, but the plugin still needs to be tested on an MPC.

Source text

SKILL.md · MIT
---
name: mpc-plugin-test
description: Test an MPC plugin on the computer with the SDK's host simulator before putting it on hardware: load sequence, audio rendering to WAV, MIDI, state round trip, parameter sweeps, stability and CPU. Use after every build, when the user reports no sound, noise, crashes, glitches or lost settings, or asks to verify a plugin.
---

# Test with the host simulator

The simulator imitates the MPC's host (same load sequence, 44.1 kHz, small blocks, concurrent-looking parameter writes, the parameter-0 nudge). It cannot replace a test on the real MPC, but it catches most crashes and DSP bugs.

```
.sdk-tools/host_sim plugins/<Name>/build/native/<slug>.dylib dump      # what the MPC will see: name, uid, params, kinds
.sdk-tools/host_sim plugins/<Name>/build/native/<slug>.dylib test --seconds 3 --wav plugins/<Name>/build/test.wav
   # instruments: --notes 48,52,55 ; --playing simulates transport ; effects get a sine + noise burst
   # --block 32 / --block 512 for extreme block sizes ; --verbose logs every opcode
```
(On Linux the native library is `.so`, on Windows `.dll` and the simulator is `host_sim.exe`.)

Read the report:
- `FAIL` lines must be fixed: NaN/Inf output, crash (exit 2, with the phase named), state not round-tripping, parameter get/set mismatch.
- `WARN`: silence from an instrument (no voice triggered?), clipping (reduce gain), denormals, high CPU, effect not passing silence.
- Timing: the simulator reports CPU on your machine; the MPC is 10–40× slower. Keep the simulator's average under a few percent.

Then listen to the WAV (ask the user to, or describe what to expect). For "no sound" problems: check `isNoteOn` handling, envelope attack/gate, output gain, and that `ctx.outputs` is written. For "clicks": smooth parameters, add short attack/release, avoid resetting phase on every block.

Finally remind the user to test on the MPC itself (`docs/install-and-test.md`): copy the folder into `VST2 Plugins`, enable Preferences → Enhancements (Beta) → External Plugin Support, load it, save and reload a project.

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

Similar skills

All skills for Testing and QA →

From the same set9

mpc-plugin-presets The mpc-plugin-presets Claude Code skill adds built-in presets to MPC plugins and explains .xpl preset files. It activates for requests about patches, programs, sound banks, or an initial patch. CX Codex +1 ★ 200repo stars mpc-plugin-package The mpc-plugin-package Claude Code skill creates a distributable ZIP for a built MPC plugin, including install instructions. It runs when a plugin needs to be shared, sent out, or prepared for release. CX Codex +1 ★ 200repo stars mpc-plugin-troubleshoot The mpc-plugin-troubleshoot Claude Code skill diagnoses MPC plugin faults and build or test tool issues. It handles reports of missing plugins, load failures, lost settings, audio glitches, and crashes. CX Codex +1 ★ 200repo stars mpc-plugin-build The mpc-plugin-build Claude Code skill builds MPC plugin projects into deployable folders and helps resolve build failures. It activates when a plugin needs compiling or a build reports errors. CX Codex +1 ★ 200repo stars mpc-plugin-dsp The mpc-plugin-dsp Claude Code skill guides DSP work on MPC plugins. It applies to changes involving synthesis, effects, MIDI, or plugin parameters. CX Codex +1 ★ 200repo stars mpc-plugin-new The mpc-plugin-new Claude Code skill scaffolds plugins for Akai MPC standalone hardware from plain-language descriptions. It activates for requests to start an instrument or audio effect project. CX Codex +1 ★ 200repo stars mpc-plugin-ui The mpc-plugin-ui Claude Code skill builds touch-screen layouts and Q-Link mappings for MPC plugins. It comes into play when an agent needs to arrange controls, set themes, or create a custom skin. CX Codex +1 ★ 200repo stars mpc-plugin-deploy The mpc-plugin-deploy Claude Code skill manages VST2 plugins on a real Akai MPC over the network. It activates for plugin installs, device updates, or plugin backups. CX Codex +1 ★ 200repo stars

Project sponsors

Companies that keep this analytics open