avdlee/xcode-build-optimization-agent-skill
6 skills14.4k installs6.7k starsGitHub
Install
npx skills add https://github.com/avdlee/xcode-build-optimization-agent-skillSkills in this repo
1Xcode Build OrchestratorXcode Build Orchestrator is an agent skill from the Xcode build optimization toolkit that standardizes how you measure iOS build performance before and after changes. It instructs specialists to write all evidence under `.build-benchmark/`, including timestamped JSON for each scheme and matching clean, cached-clean, and incremental logs so comparisons stay reproducible. A critical distinction is baked in: median wall-clock seconds reflect what developers actually wait on, while Xcode’s aggregated timing categories sum parallel work and can dwarf real elapsed time—so agents must not label SwiftCompile as the bottleneck from category totals alone. Solo indie iOS developers use it when local builds feel slow, when toggling compilation cache or modularization, or when validating that a refactor did not regress CI. It pairs with other repo skills that interpret the artifacts; this orchestrator defines the measurement contract. Advanced familiarity with Xcode schemes and Build Timing Summary is assumed.2.5kinstalls2Xcode Build Fixerxcode-build-fixer is a reference-driven checker skill for indie iOS and macOS developers who lose hours to slow Xcode rebuilds. It walks an agent through Xcode build settings keys—compilation mode, Swift and GCC optimization levels, and related performance knobs—comparing project values to documented best practices for Debug and Release. The scope is deliberately narrow: faster builds, not adopting Swift concurrency migration settings. Agents produce an actionable checklist with explicit mismatches so you can fix `.pbxproj` or target settings without guessing. Use when a project feels fine functionally but edit-compile-test loops drag, or before you tune CI caches and parallel builds. Intermediate familiarity with Xcode’s Build Settings UI helps; the skill does not replace profiling runtime performance on devices.2.4kinstalls3Xcode Project AnalyzerXcode Project Analyzer is an agent skill for solo and indie iOS and macOS builders who ship with Xcode and want faster, more predictable incremental builds without guessing. It walks your project against Apple’s published build-optimization guidance: measure with timing summaries before changing structure, tighten target dependencies for correctness and parallelism, and make run-script phases declare inputs and outputs (including via .xcfilelist when lists are long). It looks for module-friendly setups—DEFINES_MODULE, module maps, and consistent compiler flags across related sources—and coding habits that reduce compiler churn, such as framework-qualified imports, slimmer Objective-C bridging, explicit types where inference is costly, and delegate protocols instead of overly generic delegates. Use it when local or CI builds balloon after small edits, when monolithic targets force full rebuilds, or when you are splitting features into better-scoped modules. It is analysis and prioritization, not a substitute for profiling on your machine or reviewing Security Audits on this catalog page before install.2.4kinstalls4Xcode Compilation AnalyzerXcode Compilation Analyzer is a research-backed agent skill that turns Apple’s official build-efficiency documentation into actionable checks for indie iOS and macOS developers tired of slow incremental builds. It is for solo builders maintaining Xcode workspaces who need a structured lens on timing summaries, target dependencies, run-script phases, explicit modules, and Swift typing habits—not random Stack Overflow toggles. Use it during active feature work when rebuilds dominate your loop, and again before release when you want compile time and CI cost under control. The skill consolidates consistent citations to Apple’s incremental-build, coding-practice, and explicit-module guides so your agent recommends changes that match platform intent. That matters because wasted compile cycles steal Ship-phase velocity; measuring first and scoping modules correctly compounds across every session.2.4kinstalls5Xcode Build Benchmarkxcode-build-benchmark is an agent skill from the Xcode build optimization family that tells specialists exactly how to store and interpret measured build evidence. Solo indie iOS developers waiting on SwiftCompile-heavy schemes get a shared contract: timestamped JSON under `.build-benchmark/`, paired clean-run logs, and optional cached-clean runs when compilation caching is enabled. The documentation stresses a common trap—Xcode’s aggregated task times can exceed wall-clock because tasks run in parallel—so agents should not declare SwiftCompile the bottleneck from category totals alone. Instead they compare category diagnostics against median wall-clock seconds across repeated cleans. Use this skill when you are optimizing modules, CI macOS runners, or local M-series machines and need agents to read prior benchmarks without rerunning identical schemes. It complements sibling optimization skills by making historical runs legible for later analysis.2.3kinstalls6Spm Build AnalysisSPM Build Analysis is an agent skill that turns Apple’s official Xcode and Swift Package Manager build-efficiency documentation into a repeatable audit for indie mobile developers. Solo builders often lose hours to opaque full rebuilds; this skill anchors recommendations in cited sources such as improving incremental build speed, build-efficient coding practices, and explicit module dependencies. It prioritizes measurement with timing summaries, then walks dependencies, run script transparency, module maps, target granularity, and Swift/Objective-C patterns that reduce type-checking cost. Use it when you are iterating on a native app in Xcode, tuning CI xcodebuild jobs, or asking an agent to explain why one scheme rebuilds the world. It does not replace profiling runtime performance on device; it focuses on compile graph hygiene and Apple’s documented levers so you ship faster feedback loops before launch and App Store packaging work.2.3kinstalls