Xcode Build Fixer

avdlee/xcode-build-optimization-agent-skill

This is the implementation companion to xcode-build-orchestrator. Once you've got an approved optimization plan, this skill applies the changes one at a time, then re-benchmarks to verify the delta. It handles build settings (like switching to dwarf debug symbols or enabling compilation caching), script phase guards, source-level compilation fixes (type annotations, breaking up complex expressions), and SPM restructuring. The revert logic is nuanced: it knows that certain Apple-recommended settings like COMPILATION_CACHE_ENABLE_CACHING should stay even if the initial benchmark shows no win, because they compound over real workflows. Speculative changes get reverted if they regress. Good if you want to stop guessing at build fixes and actually measure what works.

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-fixer --agent claude-code

Installs into .claude/skills of the current project.

Files

Xcode Build Fixer

Use this skill to implement approved build optimization changes and verify them with a benchmark.

Core Rules

Only apply changes that have explicit developer approval.
Apply one logical fix at a time so changes are reviewable and reversible.
Re-benchmark after applying changes to verify improvement.
Report exactly what changed, which files were touched, and the measured delta.
If a change produces no improvement or causes a regression, flag it immediately.

Inputs

The fixer expects one of:

An approved optimization plan at .build-benchmark/optimization-plan.md with checked approval boxes.
An explicit developer instruction describing the fix to apply (e.g., "set DEBUG_INFORMATION_FORMAT to dwarf for Debug").

When working from an optimization plan, read the approval checklist and implement only the checked items.