---
name: pearl-vvs
description: Install Pearl VVS / DEMON_01 — a sample-based rompler VST3 for macOS with 3,315 melodic one-shots across 7 banks (KEYS, PADS, SYNTH, LEAD, CHORD, MOOG, ARP). SYSTEM-styled flat UI, ASCII demon glyph, filter envelope, 2 LFOs, chorus/delay/reverb, stereo width, oversampled saturation, 16 factory presets. Trigger when user says "install pearl vvs", "install demon_01", "gimme pearl vvs", "drop pearl vvs in fl", "add demon vst", "install the demon vst", or any request to install or get the Pearl VVS / DEMON_01 plugin on their Mac. macOS only (universal arm64 + x86_64). Homies-only — contains samples from paid kits.
---


# Pearl VVS — DEMON_01

Install script for a prebuilt VST3 rompler. Contents of this skill:

```
pearl-vvs/
├── SKILL.md          (this file)
└── Pearl VVS.vst3/   (full plugin bundle with 3,315 bundled samples)
```

## Install flow (Claude does this)

1. **Verify macOS.** If not macOS, stop and tell user the plugin is macOS-only.

2. **Find the `.vst3` bundle.** It lives at `<skill_root>/Pearl VVS.vst3/` (where `<skill_root>` is wherever this skill was extracted to — typically `~/.claude/skills/pearl-vvs/` for user-scoped or wherever the plugin host unpacks it).

3. **Copy into the VST3 plug-in folder:**
   ```bash
   mkdir -p ~/Library/Audio/Plug-Ins/VST3
   cp -R "<skill_root>/Pearl VVS.vst3" ~/Library/Audio/Plug-Ins/VST3/
   ```
   If a previous Pearl VVS install exists, ask before overwriting.

4. **Verify install:**
   ```bash
   ls "~/Library/Audio/Plug-Ins/VST3/Pearl VVS.vst3/Contents/Resources/Samples/"
   ```
   Should list KEYS, PADS, SYNTH, LEAD, CHORD, MOOG, ARP directories.

5. **Tell user to rescan in their DAW:**
   - FL Studio: Options → Manage Plugins → Find More Plugins
   - Logic: Plugin Manager → Reset & Rescan
   - Ableton: Preferences → Plug-ins → Rescan
   - Then drop "Pearl VVS" on a channel.

## What the plugin does

- **7 sample banks** with popup menus showing every sample — click bank tab or sample row to browse
- **Filter envelope** (A D S R AMT) — independent of amp env, shapes cutoff
- **Dual-stage state-variable filter** (LP / BP / HP) with cubic Hermite interpolation for pitch shifting
- **2 routable LFOs** with oscilloscope visualization, destinations: cutoff / pitch / amp / chorus depth / reverb mix
- **FX rack:** chorus, tape delay, plate reverb, stereo width, 2x oversampled drive, master volume
- **16 factory starter presets** — via `[ PRESET ]` → `Factory...`
- **Favorites** — star any sample → appears in FAVS virtual bank (persisted to `~/Library/Application Support/Pearl VVS/favorites.json`)
- **4 built-in themes** (SYSTEM-DRK / SYSTEM-LGT / KAWAII / MONO) + live theme creator

## Files the plugin creates on the host machine

- `~/Library/Audio/Plug-Ins/VST3/Pearl VVS.vst3/` — the plugin itself
- `~/Library/Application Support/Pearl VVS/favorites.json` — starred samples
- `~/Library/Application Support/Pearl VVS/themes/*.json` — custom themes
- `~/Library/Application Support/Pearl VVS/presets/*.pvvs` — user presets

## Uninstall

```bash
rm -rf ~/Library/Audio/Plug-Ins/VST3/"Pearl VVS.vst3"
rm -rf ~/Library/Application\ Support/"Pearl VVS"
```

## Notes

- Prebuilt universal binary (arm64 + x86_64), ad-hoc code-signed
- Samples are plain WAV inside the bundle's `Contents/Resources/Samples/`
- Homies only — contains samples from ICYTWAT, E-Trou, JETLAG, Rio Leyva, Brandonfinessin, Noah Mejia, Midnight Club, etc. Don't redistribute publicly.
- JUCE 8.0.5 / C++20 / VST3

v0.1.0 — Museica / CCBBY