xcode-build-fixer

The xcode-build-fixer skill helps developers implement approved Xcode build optimization changes and validate their impact through benchmarking. It is designed to work alongside an existing optimization workflow, applying only explicitly approved changes from an optimization plan or direct developer instructions. The skill focuses on improving build performance, reducing unnecessary compilation overhead, and ensuring that modifications remain reviewable, reversible, and measurable. After each optimization is applied, the skill re-runs benchmarks and reports the exact changes made, the files affected, and the measured performance delta.

The skill supports multiple categories of build optimization fixes. It can modify Xcode build settings within project.pbxproj files, optimize run script phases by adding dependency analysis guards and input/output declarations, and apply source-level Swift compilation improvements to reduce compiler and type-checking overhead. It also supports Swift Package Manager restructuring tasks such as splitting oversized modules, reducing dependency complexity, aligning build options across targets, and pinning dependencies to deterministic versions or revisions. Verification steps such as checking build settings with xcodebuild and validating package resolution are included as part of the workflow.

This skill is intended for iOS and macOS developers, build engineers, and teams managing large Xcode projects with slow builds or inefficient compilation behavior. It is especially useful after build analysis has already identified bottlenecks and generated optimization recommendations. Typical use cases include improving debug build performance, reducing incremental build times, optimizing SwiftUI-heavy codebases, and restructuring Swift package dependencies to improve parallelism and rebuild isolation.