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:

   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:

   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

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