AvdLee/Xcode-Build-Optimization-Agent-Skill
An Agent Skill helping you to optimize Xcode incremental and clean builds by running benchmarks and optimizing build settings.
What it solves
This project addresses slow Xcode build times for iOS and macOS developers. It replaces guesswork with an evidence-backed workflow to identify and fix bottlenecks in clean builds, incremental builds, and Swift Package Manager (SPM) overhead, which can otherwise cost developers hours of productivity per year.
How it works
It provides a suite of "Agent Skills" designed for AI coding tools. An orchestrator coordinates five specialist skills through a two-phase process:
- Analyze: The agent benchmarks the project, runs analyzers for compilation, project settings, and SPM, and generates a prioritized optimization plan in a Markdown file.
- Fix: After the user reviews and approves specific items in the plan, a fixer skill implements the changes and re-benchmarks the project to verify the performance gains.
Who it’s for
- iOS and macOS development teams struggling with slow local build loops.
- Developers investigating specific build-time regressions.
- Teams seeking a structured, reusable way to optimize Xcode builds rather than using one-off scripts.
Highlights
- Comprehensive Auditing: Performs over 40 individual checks across build settings, script phases, target dependencies, and SwiftUI view complexity.
- Safe Workflow: No project files are modified until the user explicitly approves the recommended changes.
- Multi-Tool Support: Compatible with various AI coding environments including Claude Code, Cursor, and OpenAI-compatible tools.
- Evidence-Based: Grounded in Apple documentation, WWDC sessions, and community best practices.
Related
- Project
- Project
- Project
- Project
- Project