---

name: new-plugin description: Create a new iPlug2 plugin project by duplicating TemplateProject in the iPlug2OOS repository

Create New Plugin (iPlug2OOS)

Use this skill when the user wants to create a new plugin project in this out-of-source repository.

Workflow

1. Gather project details:

   • Plugin name (required): No spaces or special characters
   • Manufacturer name (required): No spaces

2. Check for existing projects:

   • If other project folders exist besides TemplateProject, ask if user wants to continue with existing work or create new

3. Run duplicate script:

   Copy./duplicate.py TemplateProject [PluginName] [ManufacturerName]
   

4. Offer config.h customization:

   • PLUG_UNIQUE_ID - Verify the auto-generated 4-char ID
   • PLUG_MFR_ID - Set manufacturer's 4-char ID
   • Copyright, URLs - allow skipping for later

5. Ask about committing:

   Copygit add [PluginName]/*
   git add .vscode/*
   git add .github/*
   git add bump_version.py
   git commit -m "created [PluginName] based on TemplateProject"
   

6. Next steps:

   • Open in Xcode: open [PluginName]/[PluginName].xcworkspace
   • Build: Use the build skill from iPlug2
   • Setup SDKs: Use the setup-deps skill if needed

Example

Copy./duplicate.py TemplateProject MySynth MyBrand

Creates MySynth/ with all project files configured and ready to build.