skill_packaging

SKILL: PACKAGING (Cross-Platform)

Goal: Create professional, cross-platform plugin installers for Windows, macOS, and Linux Trigger: /ship [Name] or "Ship [Name]" Prerequisites: Phase 4 (CODE) complete, audio engine working, all tests passed Output Location: release/[Name]_v[version]/ (honors paths.release_dir in apc.config.json)

---

Overview

This skill handles the complete packaging and distribution process for APC plugins. It supports:

• Local builds (current platform only)
• GitHub Actions builds (cross-platform CI/CD)
• Hybrid approach (local + remote for specific platforms)

Platform Support Matrix

Platform	VST3	AU	Standalone	LV2	Local Build	GitHub Actions
Windows	✓	-	✓	-	✓ (native)	✓
macOS	✓	✓	✓	-	✗	✓
Linux	✓	-	✓	✓	✗	✓

---

STEP 1: DETECT CURRENT PLATFORM & BUILD STATUS

# Detect current operating system
$CurrentOS = if ($IsWindows -or ($env:OS -eq "Windows_NT")) { "Windows" }
             elseif ($IsMacOS) { "macOS" }
             elseif ($IsLinux) { "Linux" }
             else { "Unknown" }

# Check for existing local build
$BuildDir = "build"
$HasLocalBuild = Test-Path "$BuildDir/*_artefacts/Release/*.vst3" -or
                 Test-Path "$BuildDir/*_artefacts/Release/*.component" -or
                 Test-Path "$BuildDir/*_artefacts/*.vst3"

Write-Host "Current Platform: $CurrentOS" -ForegroundColor Cyan
Write-Host "Local Build Found: $HasLocalBuild" -ForegroundColor Cyan

---

STEP 2: ASK USER FOR PLATFORM SELECTION

CRITICAL: Before proceeding, ask the user which platforms to build for.

Platform Selection Prompt

╔══════════════════════════════════════════════════════════════╗
║  SHIP WORKFLOW - Platform Selection                          ║
╠══════════════════════════════════════════════════════════════╣
║  Current Platform: Windows                                    ║
║  Local Build Status: Found                                    ║
╠══════════════════════════════════════════════════════════════╣
║  Select platforms to include in release:                     ║
║                                                              ║
║  [1] Windows (VST3, Standalone) - USE LOCAL BUILD            ║
║  [2] Windows (VST3, Standalone) - BUILD WITH GITHUB ACTIONS  ║
║  [3] macOS (VST3, AU, Standalone) - GITHUB ACTIONS REQUIRED  ║
║  [4] Linux (VST3, LV2, Standalone) - GITHUB ACTIONS REQUIRED ║
║  [5] ALL PLATFORMS - Use local for current, GitHub for rest  ║
║                                                              ║
║  Enter numbers (comma-separated) or 'all':                   ║
╚══════════════════════════════════════════════════════════════╝