[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-74304":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":16,"subscribersCount":16,"size":16,"stars1d":17,"stars7d":18,"stars30d":19,"stars90d":16,"forks30d":16,"starsTrendScore":20,"compositeScore":21,"rankGlobal":10,"rankLanguage":10,"license":22,"archived":23,"fork":23,"defaultBranch":24,"hasWiki":23,"hasPages":23,"topics":25,"createdAt":10,"pushedAt":10,"updatedAt":32,"readmeContent":33,"aiSummary":34,"trendingCount":16,"starSnapshotCount":16,"syncStatus":35,"lastSyncTime":36,"discoverSource":37},74304,"Xcode-Build-Optimization-Agent-Skill","AvdLee\u002FXcode-Build-Optimization-Agent-Skill","AvdLee","An Agent Skill helping you to optimize Xcode incremental and clean builds by running benchmarks and optimizing build settings.","https:\u002F\u002Fwww.rocketsim.app",null,"Python",1124,43,5,1,0,16,41,78,48,17.93,"MIT License",false,"main",[26,27,28,29,30,31],"agent","agent-skills","ios","ios-development","skills","xcode","2026-06-12 02:03:25","\u003Ca href=\"https:\u002F\u002Fwww.rocketsim.app\">\u003Cimg src=\"assets\u002Fxcode-build-optimization-banner.jpg\" alt=\"Xcode Build Optimization Agent Skills - Monitor your build performance with RocketSim\" \u002F>\u003C\u002Fa>\n\n# Xcode Build Optimization Agent Skills\n\nOpen-source Agent Skills for benchmarking and optimizing Xcode build performance across clean builds, incremental builds, compile hotspots, project settings, and Swift Package Manager overhead.\n\n## Quick Start\n\nInstall all six skills (the orchestrator needs the specialist skills to work):\n\n```bash\nnpx skills add https:\u002F\u002Fgithub.com\u002Favdlee\u002Fxcode-build-optimization-agent-skill\n```\n\nThen open your Xcode project in your AI coding tool and say:\n\n> Use the \u002Fxcode-build-orchestrator skill to analyze build performance and come up with a plan for improvements.\n\nThe agent will benchmark your clean and incremental builds, audit build settings, find compile hotspots, and produce an optimization plan at `.build-benchmark\u002Foptimization-plan.md`. No project files are modified until you explicitly approve changes.\n\nFor long-term monitoring across days, machines, Xcode versions, and teams, use [RocketSim Build Insights](https:\u002F\u002Fwww.rocketsim.app\u002Fdocs\u002Ffeatures\u002Fbuild-insights\u002Fbuild-insights\u002F) and [Team Build Insights](https:\u002F\u002Fwww.rocketsim.app\u002Fdocs\u002Ffeatures\u002Fbuild-insights\u002Fteam-build-insights\u002F).\n\n## Every Second Counts\n\nA 1-second improvement on a 30-second incremental build sounds small. At 50 builds a day, that adds up to **3.5 hours per developer per year** -- or **35 hours across a team of ten**.\n\nMost projects have several seconds of easy wins hiding in build settings, script phases, and compiler flags. This skill finds them.\n\n## How It Works\n\nThe orchestrator coordinates five specialist skills in a recommend-first workflow. Nothing is modified until you approve.\n\n```mermaid\nflowchart LR\n    Orchestrator --> Benchmark[\"Benchmark\\n(clean + incremental)\"]\n    Benchmark --> Compilation[\"Compilation\\nAnalyzer\"]\n    Benchmark --> Project[\"Project\\nAnalyzer\"]\n    Benchmark --> SPM[\"SPM\\nAnalyzer\"]\n    Compilation --> Plan[\"Optimization\\nPlan\"]\n    Project --> Plan\n    SPM --> Plan\n    Plan --> You{{\"You review\\n& approve\"}}\n    You --> Fixer[\"Build\\nFixer\"]\n    Fixer --> ReBenchmark[\"Re-benchmark\\n& verify\"]\n```\n\n**Phase 1 -- Analyze.** The orchestrator benchmarks your project, runs the three specialist analyzers, and produces a prioritized optimization plan at `.build-benchmark\u002Foptimization-plan.md`. No project files are modified.\n\n> Use the Xcode build orchestrator to analyze build performance and come up with a plan for improvements.\n\n**Phase 2 -- Fix.** Review the plan, check the approval boxes for the items you want, and ask the agent to apply them. The fixer implements only approved changes and re-benchmarks to verify.\n\n> Implement the approved items from the optimization plan at .build-benchmark\u002Foptimization-plan.md, then re-benchmark to verify the improvements.\n\nThe plan file is your evidence trail -- shareable with teammates, reviewable in PRs, and diffable over time.\n\n## What It Checks\n\nThe agent runs [over 40 individual checks](OPTIMIZATION-CHECKS.md) across build settings, project configuration, source code, and package dependencies.\n\n| Check | What the agent looks for | |\n|-------|--------------------------|---|\n| Build settings audit | Debug\u002FRelease\u002FGeneral settings against best practices (compilation mode, optimization level, eager linking, compilation caching) | [Details](OPTIMIZATION-CHECKS.md#build-settings-audit) |\n| Script phase analysis | Missing input\u002Foutput declarations, scripts running unnecessarily, debug\u002Fsimulator guards | [Details](OPTIMIZATION-CHECKS.md#script-phase-analysis) |\n| Compile hotspot detection | Long type-checks, complex expressions, compiler diagnostic flags | [Details](OPTIMIZATION-CHECKS.md#compile-hotspot-detection) |\n| Zero-change build overhead | Fixed-cost phases (codesign, validation, scripts) inflating incremental builds | [Details](OPTIMIZATION-CHECKS.md#zero-change-build-overhead) |\n| Target dependency review | Accuracy, parallelism blockers, monolithic targets | [Details](OPTIMIZATION-CHECKS.md#target-dependency-review) |\n| Module variant detection | Config drift across targets causing duplicate module builds | [Details](OPTIMIZATION-CHECKS.md#module-variant-detection) |\n| SPM graph analysis | Plugin overhead, branch pins, package layering, circular dependencies | [Details](OPTIMIZATION-CHECKS.md#spm-graph-analysis) |\n| Swift macro impact | Cascading rebuilds, swift-syntax universal builds | [Details](OPTIMIZATION-CHECKS.md#swift-macro-impact) |\n| SwiftUI view decomposition | Monolithic body properties, result builder complexity | [Details](OPTIMIZATION-CHECKS.md#swiftui-view-decomposition) |\n| Asset catalog parallelism | Single-threaded compilation bottleneck, splitting for parallel builds | [Details](OPTIMIZATION-CHECKS.md#asset-catalog-parallelism) |\n| Access control optimization | Missing `final`, overly broad visibility inflating compiler work | [Details](OPTIMIZATION-CHECKS.md#access-control-optimization) |\n| Incremental build diagnostics | Planning Swift module, SwiftEmitModule, Task Backtraces | [Details](OPTIMIZATION-CHECKS.md#incremental-build-diagnostics) |\n\n## Community Results\n\nReal-world improvements reported by developers who used these skills. Add your own by opening a pull request.\n\nThe `xcode-build-orchestrator` generates your table row at the end of every optimization run, so contributing is a single copy-paste.\n\n> [!NOTE]\n> A small clean-build increase is normal when enabling compilation caching -- the first cold build populates the cache. Cached clean builds (branch switching, pulling changes) and incremental builds are where the real gains show up.\n\n| App | Clean Build | Incremental Build |\n|-----|------------|-------------------|\n| [Helm for App Store Connect](https:\u002F\u002Fhelm-app.com) | 86s → 91s (+5s \u002F within noise) | 70s → 9s (-61s \u002F 87% faster) |\n| [Stock Analyzer](https:\u002F\u002Fwww.stock-analyzer.app) | 41.5s → 33.2s (-8.3s \u002F 20% faster) | 5.3s → 3.6s (-1.7s \u002F 32% faster) |\n| [Enchanted](https:\u002F\u002Fgithub.com\u002Fgluonfield\u002Fenchanted\u002Fpull\u002F216) | 19.4s → 16.6s (-2.8s \u002F 14% faster) | 2.5s → 2.2s (-0.3s \u002F 12% faster) |\n| [Wikipedia iOS](https:\u002F\u002Fgithub.com\u002Fwikimedia\u002Fwikipedia-ios\u002Fpull\u002F5740) | 48.7s → 46.5s (-2.2s \u002F 5% faster) | 12.9s → 12.2s (-0.7s \u002F 5% faster) |\n| [Kickstarter iOS](https:\u002F\u002Fgithub.com\u002Fkickstarter\u002Fios-oss\u002Fpull\u002F2808) | 83.4s → 83.5s (~0s \u002F within noise) | 10.9s → 10.6s (-0.3s \u002F 3% faster) |\n| [Dash](https:\u002F\u002Fdashworkouts.app) | 67.8s → 66.9s (-0.9s \u002F within noise) | 6.7s → 7.1s (+0.4s \u002F within noise) |\n| [Klivvr](https:\u002F\u002Fklivvr.com\u002F) | 247ss → 167s (-80s \u002F 32% faster) | 48s → 48s (same) |\n\n## Who This Is For\n\n- iOS and macOS teams with slow local build loops\n- developers investigating a recent build-time regression\n- teams that want evidence-backed Xcode build optimization instead of guesswork\n- developers who want a reusable Agent Skills package, not a one-off script\n\n## Included Skills\n\n| Skill | Purpose |\n|-------|---------|\n| `xcode-build-orchestrator` | End-to-end workflow: benchmark, analyze, prioritize, approve, fix, re-benchmark |\n| `xcode-build-benchmark` | Repeatable clean and incremental build benchmarks with timestamped artifacts |\n| `xcode-compilation-analyzer` | Swift compile hotspot analysis and source-level recommendations |\n| `xcode-project-analyzer` | Build settings, scheme, script phase, and target dependency auditing |\n| `spm-build-analysis` | Package graph, plugin overhead, and module variant review |\n| `xcode-build-fixer` | Apply approved optimization changes and verify with benchmarks |\n\nThe orchestrator is the recommended starting point -- it coordinates the other five skills automatically. Install all six skills so the orchestrator can access each specialist.\n\n## Installation Options\n\n### Option A: Using skills.sh\n\nInstall all six skills (required -- the orchestrator depends on the specialist skills):\n\n```bash\nnpx skills add https:\u002F\u002Fgithub.com\u002Favdlee\u002Fxcode-build-optimization-agent-skill\n```\n\nTo install a single skill for standalone use, add the `--skill` flag:\n\n```bash\nnpx skills add https:\u002F\u002Fgithub.com\u002Favdlee\u002Fxcode-build-optimization-agent-skill --skill xcode-project-analyzer\n```\n\nAvailable individual skills: `xcode-build-benchmark`, `xcode-compilation-analyzer`, `xcode-project-analyzer`, `spm-build-analysis`, `xcode-build-orchestrator`, `xcode-build-fixer`. Note that the orchestrator requires all other skills to be installed.\n\n### Option B: Claude Code Plugin\n\n1. Add the marketplace:\n\n```bash\n\u002Fplugin marketplace add AvdLee\u002FXcode-Build-Optimization-Agent-Skill\n```\n\n2. Install the plugin:\n\n```bash\n\u002Fplugin install xcode-build-skills@xcode-build-skills\n```\n\nTo enable for everyone in a repository, add to your project configuration:\n\n```json\n{\n  \"enabledPlugins\": {\n    \"xcode-build-skills@xcode-build-skills\": true\n  },\n  \"extraKnownMarketplaces\": {\n    \"xcode-build-skills\": {\n      \"source\": {\n        \"source\": \"github\",\n        \"repo\": \"AvdLee\u002FXcode-Build-Optimization-Agent-Skill\"\n      }\n    }\n  }\n}\n```\n\n### Option C: Cursor Plugin (coming soon)\n\nThis repository is packaged for Cursor plugin submission, but the marketplace listing is not live yet.\n\nOnce approved, you'll be able to install it from the Cursor Marketplace.\n\n### Option D: Codex \u002F OpenAI-compatible tools\n\nThis repository includes an `agents\u002Fopenai.yaml` manifest. Copy or symlink the skill folders into your Codex skills directory:\n\n```bash\ncp -R skills\u002F \"$CODEX_HOME\u002Fskills\u002F\"\n```\n\nSee [Codex skills documentation](https:\u002F\u002Fdevelopers.openai.com\u002Fcodex\u002Fskills\u002F#where-to-save-skills) for details on where to save skills.\n\n### Option E: Using pi package manager\n\nInstall via [pi](https:\u002F\u002Fgithub.com\u002Fmariozechner\u002Fpi-mono):\n```bash\npi install https:\u002F\u002Fgithub.com\u002FAvdLee\u002FXcode-Build-Optimization-Agent-Skill\n```\n\nThe skills will be available automatically in pi sessions.\n\n### Option F: Manual Install\n\n1. Clone this repository.\n2. Install or symlink the specific skill folder from `skills\u002F` that you want.\n3. Ask your AI coding tool to use the corresponding skill.\n\nUseful docs: [Codex Skills](https:\u002F\u002Fdevelopers.openai.com\u002Fcodex\u002Fskills\u002F#where-to-save-skills) | [Claude Code Agent Skills](https:\u002F\u002Fcode.claude.com\u002Fen\u002Fskills) | [Cursor Skills](https:\u002F\u002Fcursor.com\u002Fdocs\u002Fcontext\u002Fskills#enabling-skills)\n\n## Why Clean And Incremental Builds Both Matter\n\nClean builds expose:\n\n- package and module setup cost\n- full project graph overhead\n- target structure and explicit-module issues\n\nIncremental builds expose:\n\n- edit-loop pain\n- run script bottlenecks\n- cache invalidation problems\n- repeated package-plugin overhead\n\nThat distinction is central to this repo and follows both Apple's Xcode guidance and the SwiftLee workflow in [Build performance analysis for speeding up Xcode builds](https:\u002F\u002Fwww.avanderlee.com\u002Foptimization\u002Fanalysing-build-performance-xcode\u002F).\n\n## See Also My Other Skills\n\n- [Swift Concurrency Expert](https:\u002F\u002Fgithub.com\u002FAvdLee\u002FSwift-Concurrency-Agent-Skill)\n- [SwiftUI Expert](https:\u002F\u002Fgithub.com\u002FAvdLee\u002FSwiftUI-Agent-Skill)\n- [Core Data Expert](https:\u002F\u002Fgithub.com\u002FAvdLee\u002FCore-Data-Agent-Skill)\n- [Swift Testing Expert](https:\u002F\u002Fgithub.com\u002FAvdLee\u002FSwift-Testing-Agent-Skill)\n\n## Shared Support Layer\n\nEach skill bundles its own copies of the scripts, references, and schemas it needs so it works after standalone installation. The canonical copies live at the repo root:\n\n- `scripts\u002F` -- helper scripts for benchmarking, timing-summary parsing, compilation diagnostics, report generation, and recommendation rendering\n- `references\u002F` -- build settings best practices, artifact format, recommendation format, and source citations\n- `schemas\u002F` -- JSON schema for benchmark output\n\nWhen a root-level file changes, the corresponding copies inside each skill that uses it must be updated (see [CONTRIBUTING.md](CONTRIBUTING.md)).\n\n## Skill Structure\n\u003C!-- BEGIN SKILL STRUCTURE -->\n```text\nskills\u002F\n  xcode-build-benchmark\u002F\n    SKILL.md\n    references\u002F\n      benchmark-artifacts.md\n      benchmarking-workflow.md\n  xcode-compilation-analyzer\u002F\n    SKILL.md\n    references\u002F\n      build-optimization-sources.md\n      code-compilation-checks.md\n      recommendation-format.md\n  xcode-project-analyzer\u002F\n    SKILL.md\n    references\u002F\n      build-optimization-sources.md\n      build-settings-best-practices.md\n      project-audit-checks.md\n      recommendation-format.md\n  spm-build-analysis\u002F\n    SKILL.md\n    references\u002F\n      build-optimization-sources.md\n      recommendation-format.md\n      spm-analysis-checks.md\n  xcode-build-orchestrator\u002F\n    SKILL.md\n    references\u002F\n      benchmark-artifacts.md\n      build-settings-best-practices.md\n      orchestration-report-template.md\n      recommendation-format.md\n  xcode-build-fixer\u002F\n    SKILL.md\n    references\u002F\n      build-settings-best-practices.md\n      fix-patterns.md\n      recommendation-format.md\n```\n\u003C!-- END SKILL STRUCTURE -->\n\n## Research Basis\n\nAll checks are grounded in Apple documentation, WWDC sessions, and proven community practices. See [OPTIMIZATION-CHECKS.md](OPTIMIZATION-CHECKS.md) for the full list of checks with references to each source.\n\nThe stored reference summaries live in `references\u002Fbuild-optimization-sources.md`.\n\n## RocketSim Positioning\n\nThis repo helps you optimize point-in-time build performance with an agent-guided workflow.\n\nRocketSim complements it by monitoring build performance over time:\n\n- automatic clean vs incremental build tracking\n- duration trends and percentile metrics\n- machine, Xcode, and macOS comparisons\n- team-wide visibility without custom build scripts\n\nIf you want to catch regressions earlier and see whether your build times are improving over weeks or months, use [RocketSim Build Insights](https:\u002F\u002Fwww.rocketsim.app\u002Fdocs\u002Ffeatures\u002Fbuild-insights\u002Fbuild-insights\u002F) after you apply the improvements from this repo.\n\n## Contributing\n\nContributions are welcome when they keep the repo focused on Xcode build optimization and Agent Skills format quality.\n\nPlease read [CONTRIBUTING.md](CONTRIBUTING.md) for:\n\n- skill-authoring guidance\n- repo scope and quality standards\n- workflow notes for scripts and README sync\n\n## About The Author\n\nCreated by [Antoine van der Lee](https:\u002F\u002Fwww.avanderlee.com), creator of SwiftLee and RocketSim. The practical build workflow in this repository is informed by the SwiftLee article [Build performance analysis for speeding up Xcode builds](https:\u002F\u002Fwww.avanderlee.com\u002Foptimization\u002Fanalysing-build-performance-xcode\u002F) and ongoing work on RocketSim Build Insights.\n\n## License\n\nThis repository is available under the MIT License. See [LICENSE](LICENSE) for details.\n","Xcode Build Optimization Agent Skills 是一个帮助优化 Xcode 项目构建性能的工具，通过运行基准测试和调整构建设置来提高增量构建和完全构建的速度。它使用 Python 编写，包含六个技能模块，由一个协调器统一管理，能够自动分析编译热点、项目设置以及 Swift Package Manager 的开销，并生成详细的优化方案。该工具适用于 iOS 开发团队，特别是那些希望在不直接修改项目文件的情况下持续监控并改善构建效率的场景。无论是单个开发者还是整个团队，都可以从中受益，显著减少构建时间，提升开发效率。",2,"2026-06-11 03:49:54","high_star"]