ios-build-speed-skills

Claude Code skills that audit and fix common causes of slow iOS/Xcode build times.

Each skill scans your project, reports findings by severity, and applies fixes with your confirmation.

Skills

Diagnostics

Skill	What it does
build-timeline	Build log analysis — find the Top 10 slowest-compiling files and functions

IDE & Build Settings

Skill	What it does
xcode-settings	Xcode IDE preferences — concurrent tasks, DerivedData location, indexing
build-settings	Build flags — SWIFT_COMPILATION_MODE, EAGER_LINKING, explicit modules, sanitizers
concurrency-settings	Swift Concurrency overhead — SWIFT_STRICT_CONCURRENCY Debug/Release split
script-phases	Run Script phases — input/output declarations, sandboxing, phase ordering
link-settings	Linker config — static vs dynamic frameworks, EXPORTED_SYMBOLS_FILE, unused deps

Architecture

Skill	What it does
modular-architecture	SPM module boundaries — reduce recompilation blast radius
protocol-separation	Extract protocols to dedicated files — break unnecessary cross-file dependencies
type-annotations	Explicit type annotations — reduce type-inference work at compile time
preview-isolation	SwiftUI preview extraction — move #Preview and PreviewProvider to dedicated files

Dependencies

Skill	What it does
pods-settings	CocoaPods linkage — use_frameworks! :linkage => :static and pod audit

Caching & CI

Skill	What it does
xcode-cache	Local cache — llbuild, ccache, .gitignore, Xcode 16 compilation cache
ci-cache	CI/CD cache — DerivedData and SPM cache configuration for GitHub Actions, Bitrise, etc.
ci-workflow	GitHub Actions — runner version, concurrency, and job structure

Requirements

• Claude Code CLI
• Xcode 14+ (Xcode 16 recommended for full feature support)
• macOS 13+

Install

One-liner (installs globally, available in all Claude Code sessions):

curl -fsSL https://raw.githubusercontent.com/cruisediary/ios-build-speed-skills/main/install.sh | bash -s -- --global

Or clone and run interactively:

git clone https://github.com/cruisediary/ios-build-speed-skills.git
cd ios-build-speed-skills
./install.sh

All install options

./install.sh              # Interactive: prompts global vs local
./install.sh --global     # Install to ~/.claude/skills/ios-build-speed/
./install.sh --local      # Install to ./.claude/skills/ios-build-speed/
./install.sh --force      # Overwrite without prompt
./install.sh --uninstall --global
./install.sh --uninstall --local

Restart Claude Code after installing to activate the skills.

Usage

Open Claude Code in your Xcode project directory and describe your problem:

My Xcode build is getting slower

or invoke directly:

/ios-build-speed

Every skill follows the same flow:

1. Detects Xcode/Swift version and package manager
2. Audits the project for relevant issues
3. Reports findings with severity levels (🔴 Critical → 🔵 Low)
4. Proposes changes and asks for confirmation before modifying any files

Recommended order

Skills build on each other. For a full audit, run them in this sequence:

Step	Skill	Depends on
1	build-timeline	— (baseline measurement)
2	xcode-settings	—
3	build-settings	—
4	concurrency-settings	—
5	script-phases	—
6	modular-architecture	—
7	pods-settings	—
8	link-settings	Step 6 module structure, Step 7 pods resolved
9	protocol-separation	Step 6 module structure
10	preview-isolation	Step 6 module structure
11	type-annotations	Step 9 protocol boundaries
12	xcode-cache	Steps 1–11 in place
13	ci-cache	Step 2 DerivedData location
14	ci-workflow	Step 13 caching in place

You can run individual skills in any order — the table above is the recommended sequence when starting from scratch.

Safety

All file-modifying skills create a git stash checkpoint before making changes:

ios-build-speed: pre-<skill-name> checkpoint

To undo all changes made by a skill:

git stash pop

Version support

Xcode	Swift	Support
16+	6+	Full
15	5.9+	Full
14	5.7+	Core features
< 14	< 5.7	Guidance only (no automated changes)

Contributing

See CONTRIBUTING.md.

License

MIT — cruisediary