---

name: smart-build description: This skill should be used when the user asks to "build the app", "run the app", "build and run", "deploy to simulator", "build this project", or uses the /build, /run, /install commands. Builds Swift/SwiftUI projects and marks for auto-deploy.

Smart Build Skill

⚠️ CRITICAL: READ THIS FIRST

YOU MUST follow these instructions EXACTLY as written.

DO NOT:

• ❌ Use Search or Glob tools - use the exact bash commands shown
• ❌ Construct xcodebuild commands yourself - use the scripts provided
• ❌ Use AppleScript or osascript
• ❌ Skip steps or change the order
• ❌ Improvise or use alternative methods

YOU MUST:

• ✅ Run the EXACT bash commands and scripts shown in each step
• ✅ Use ${CLAUDE_PLUGIN_ROOT}/scripts/ for all operations
• ✅ Follow the step order: 1 → 2 → 3 → 4 → 5 → 6

---

Step 1: Check Project Directory

YOU MUST run this command first:

Copyls *.xcodeproj 2>/dev/null || ls *.xcworkspace 2>/dev/null || echo "NO_PROJECT"

If output is "NO_PROJECT": STOP and tell user:

"No Xcode project found. Please run Claude from your project directory."

---

Step 2: Read Config

YOU MUST run:

Copycat .smart-build.json 2>/dev/null || echo "NO_CONFIG"

If "NO_CONFIG": Tell user to run /swiftui-smart-build:setup first, then STOP.

If config exists: Parse the JSON and continue.

---

Step 3: Get Build Settings

If "mode": "xcode":

YOU MUST run this script:

Copy${CLAUDE_PLUGIN_ROOT}/scripts/get-xcode-settings.sh

This returns JSON with scheme and destination. Use these values.

If "mode": "custom":

Use scheme and destination from .smart-build.json directly.

---

Step 4: Build

YOU MUST use the build script:

Copy${CLAUDE_PLUGIN_ROOT}/scripts/build.sh "<SCHEME>" "<DESTINATION>"

Where:

• <SCHEME> = scheme name from Step 3
• <DESTINATION> = destination string, e.g., platform=iOS Simulator,name=iPhone 16 Pro

Example:

Copy${CLAUDE_PLUGIN_ROOT}/scripts/build.sh "MyApp" "platform=iOS Simulator,name=iPhone 16 Pro"

If build fails: Show the error and offer to fix the code. Do NOT proceed to Step 5.

If build succeeds: Continue to Step 5.

---

Step 5: Find Built App

YOU MUST run this script:

Copy${CLAUDE_PLUGIN_ROOT}/scripts/find-app.sh "<SCHEME>" "<PLATFORM>"

Where:

• <SCHEME> = same scheme name
• <PLATFORM> = iphonesimulator or iphoneos

Example:

Copy${CLAUDE_PLUGIN_ROOT}/scripts/find-app.sh "MyApp" "iphonesimulator"

This returns JSON with app_path and bundle_id. Save these for Step 6.

---

Step 6: Mark Ready for Install

YOU MUST run this script to enable auto-deploy:

Copy${CLAUDE_PLUGIN_ROOT}/scripts/mark-ready-to-install.sh "<APP_PATH>" "<BUNDLE_ID>" "<DEVICE_TYPE>" "<DEVICE_UDID>" "<DEVICE_NAME>"

Where:

• <APP_PATH> = app_path from Step 5
• <BUNDLE_ID> = bundle_id from Step 5
• <DEVICE_TYPE> = simulator or device
• <DEVICE_UDID> = device UDID from Step 3
• <DEVICE_NAME> = device name from Step 3

Example:

Copy${CLAUDE_PLUGIN_ROOT}/scripts/mark-ready-to-install.sh \
  "/Users/.../MyApp.app" \
  "com.example.MyApp" \
  "simulator" \
  "12345678-ABCD-1234-ABCD-123456789ABC" \
  "iPhone 16 Pro"

After this step, tell user:

"✅ Build succeeded! Your app will automatically launch when this conversation ends."

---

Complete Example Flow

CopyUser: /swiftui-smart-build:run

Claude: [Step 1] Checking for Xcode project...
Claude: [Runs] ls *.xcodeproj
Claude: Found SmartBuildTest.xcodeproj

Claude: [Step 2] Reading config...
Claude: [Runs] cat .smart-build.json
Claude: Mode is "xcode"

Claude: [Step 3] Getting Xcode settings...
Claude: [Runs] ${CLAUDE_PLUGIN_ROOT}/scripts/get-xcode-settings.sh
Claude: Scheme: SmartBuildTest, Destination: iPhone 16 Pro (UDID: ABC123)

Claude: [Step 4] Building...
Claude: [Runs] ${CLAUDE_PLUGIN_ROOT}/scripts/build.sh "SmartBuildTest" "platform=iOS Simulator,name=iPhone 16 Pro"
Claude: ✅ Build succeeded

Claude: [Step 5] Finding app...
Claude: [Runs] ${CLAUDE_PLUGIN_ROOT}/scripts/find-app.sh "SmartBuildTest" "iphonesimulator"
Claude: Found at /Users/.../SmartBuildTest.app, Bundle ID: com.example.SmartBuildTest

Claude: [Step 6] Marking ready for install...
Claude: [Runs] ${CLAUDE_PLUGIN_ROOT}/scripts/mark-ready-to-install.sh "/Users/.../SmartBuildTest.app" "com.example.SmartBuildTest" "simulator" "ABC123" "iPhone 16 Pro"

Claude: ✅ Build succeeded! Your app will automatically launch when this conversation ends.

[User ends conversation]
[Stop hook runs auto-install.sh]
[App launches on iPhone 16 Pro simulator]

---

DO NOT

❌ Do NOT use osascript or AppleScript ❌ Do NOT construct xcodebuild commands manually ❌ Do NOT modify .smart-build.json unless user asks ❌ Do NOT skip steps ❌ Do NOT use different scripts or methods than specified above ❌ Do NOT run install or launch commands directly - use mark-ready-to-install.sh instead