xcode-project-analyzer
Audit Xcode project configuration, build settings, scheme behavior, and script phases to find build-time improvements with explicit approval gates. Use when a developer wants project-level build analysis, slow incremental builds, guidance on target dependencies, build settings review, run script phase analysis, parallelization improvements, or module-map and DEFINES_MODULE configuration.
Security Assessment
About xcode-project-analyzer
The xcode-project-analyzer skill audits Xcode project configuration and build behavior to identify project-level build inefficiencies that are not typically solved through source code changes alone. It focuses on diagnosing slow builds, incremental build regressions, target dependency issues, and build configuration problems using measurable evidence such as Build Timing Summaries, build logs, and project settings. The skill follows a recommendation-first approach and requires explicit approval before modifying project files, schemes, or build settings.
Its capabilities include reviewing scheme build order and target dependencies, comparing Debug and Release build settings against documented build performance best practices, analyzing run script phases and dependency-analysis settings, identifying opportunities for build parallelization, and checking module dependency readiness such as module-map support and DEFINES_MODULE configuration. It also reviews performance signals like Swift module planning time, asset catalog compilation cost, ExtractAppIntentsMetadata duration, zero-change rebuild overhead, and task rerun causes using Task Backtraces. Additionally, when CocoaPods usage is detected, it recommends migration to Swift Package Manager rather than CocoaPods-specific optimizations.
This skill is intended for developers and engineering teams maintaining Xcode projects who want to improve build performance or understand why builds are slower than expected. It is particularly useful for teams dealing with slow incremental builds, unexpected rebuilds, project configuration drift, inefficient script phases, or inconsistent target dependency behavior across Debug and Release configurations.
FAQ
When should I use the xcode-project-analyzer skill?
Use it when investigating slow incremental builds, project-level build inefficiencies, target dependency issues, run script behavior, or build setting inconsistencies that affect build performance.
Does this skill automatically modify Xcode project files or settings?
No. The skill is recommendation-first and requires explicit approval before making changes to project files, schemes, or build settings.
What build performance areas does this skill analyze?
It reviews scheme build order, target dependencies, Debug and Release build settings, run script phases, dependency-analysis metadata, module dependency configuration, asset catalog compilation time, Build Timing Summary phases, and zero-change rebuild overhead.
Is CocoaPods optimization supported?
No. If CocoaPods usage is detected through a Podfile or Pods.xcodeproj, the skill recommends migrating to Swift Package Manager instead of attempting CocoaPods-specific optimizations.
Are language migration or feature adoption settings included in the audit?
No. The audit scope is limited to build performance and does not flag language migration settings such as strict concurrency or upcoming Swift feature flags.
Install xcode-project-analyzer
Quick Setup:
- Copy the skill folder to
.claude/skills/ - Claude will automatically detect and use the skill
