# Xcode Build Benchmark

Benchmark Xcode clean and incremental builds with repeatable inputs, timing summaries...

- Repository: https://github.com/AvdLee/Xcode-Build-Optimization-Agent-Skill (1268 stars)
- Category: Mobile
- License: MIT
- Last updated: 2026-09-14
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add AvdLee/Xcode-Build-Optimization-Agent-Skill --skill xcode-build-benchmark -g -a claude-code -y`
Codex: `npx skills add AvdLee/Xcode-Build-Optimization-Agent-Skill --skill xcode-build-benchmark -g -a codex -y`
Cursor: `npx skills add AvdLee/Xcode-Build-Optimization-Agent-Skill --skill xcode-build-benchmark -g -a cursor -y`
Gemini CLI: `npx skills add AvdLee/Xcode-Build-Optimization-Agent-Skill --skill xcode-build-benchmark -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add AvdLee/Xcode-Build-Optimization-Agent-Skill`

## Description

Benchmark Xcode clean and incremental builds with repeatable inputs, timing summaries, and timestamped `.build-benchmark/` artifacts. Use when a developer wants a baseline, wants to compare before and after changes, asks to measure build performance, mentions build times, build duration, how long builds take, or wants to know if builds got faster or slower.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Xcode Build Benchmark

Use this skill to produce a repeatable Xcode build baseline before anyone tries to optimize build times.

## Core Rules

- Measure before recommending changes.
- Capture clean and incremental builds separately.
- Keep the command, destination, configuration, scheme, and warm-up rules consistent across runs.
- Write a timestamped JSON artifact to `.build-benchmark/`.
- Do not change project files as part of benchmarking.

## Inputs To Collect

Confirm or infer:

- workspace or project path
- scheme
- configuration
- destination
- whether the user wants simulator or device numbers
- whether a custom `DerivedData` path is needed

If the project has both clean-build and incremental-build pain, benchmark both. That is the default.

## Worktree Considerations

When benchmarking inside a git worktree, SPM packages with `exclude:` paths that reference gitignored directories (e.g., `__Snapshots__`) will cause `xcodebuild -resolvePackageDependencies` to crash. Create those missing directories before running any builds.

## Default Workflow

The rest: https://github.com/AvdLee/Xcode-Build-Optimization-Agent-Skill/blob/HEAD/skills/xcode-build-benchmark/SKILL.md