---
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:**
```bash
./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:**
```bash
git 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
```bash
./duplicate.py TemplateProject MySynth MyBrand
```
Creates `MySynth/` with all project files configured and ready to build.
