Xcode Build Orchestrator

avdlee/xcode-build-optimization-agent-skill

This is the entry point you want when your Xcode builds are painfully slow and you need a systematic fix. It benchmarks first, runs specialist analysis skills across compilation, project settings, and SPM packages, then generates a prioritized plan you approve before anything changes. The workflow is split into recommend and execute phases, which matters because it won't touch your project files until you check the boxes. Every recommendation includes expected wall-clock impact, not just theoretical CPU savings. It knows the difference between parallel compile work and actual bottlenecks that block your wait time. If you've been cargo-culting build flags or guessing at optimizations, this gives you the evidence trail instead.

skills.sh installs: 3.7K
GitHub stars: 1.3K
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add avdlee/xcode-build-optimization-agent-skill --skill xcode-build-orchestrator --agent claude-code

Installs into .claude/skills of the current project.

Files

Xcode Build Orchestrator

Use this skill as the recommend-first entrypoint for end-to-end Xcode build optimization work.

Non-Negotiable Rules

Wall-clock build time (how long the developer waits) is the primary success metric. Every recommendation must state its expected impact on the developer's actual wait time.
Start in recommendation mode.
Benchmark before making changes.
Do not modify project files, source files, packages, or scripts without explicit developer approval.
Preserve the evidence trail for every recommendation.
Re-benchmark after approved changes and report the wall-clock delta.

Two-Phase Workflow

The orchestration is designed as two distinct phases separated by developer review.

Phase 1 -- Analyze (recommend-only)

Run this phase in agent mode because the agent needs to execute builds, run benchmark scripts, write benchmark artifacts, and generate the optimization report. However, treat Phase 1 as recommend-only: do not modify any project files, source files, packages, or build settings. The only files the agent creates during this phase are benchmark artifacts and the optimization plan inside .build-benchmark/.

SKILL.md on GitHub