SkillAgentSearch skills...

xcode-compilation-analyzer

Analyze Swift and mixed-language compile hotspots using build timing summaries and Swift frontend diagnostics, then produce a recommend-first source-level optimization plan

Install / Use

npx skills add AvdLee/Xcode-Build-Optimization-Agent-Skill --skill xcode-compilation-analyzer

Installs into whichever agent you are using.

About this skill
📄

SKILL.md

Installable skill definition

Quality Score

82/100

Supported Platforms

Universal

Tags

Our assessment of xcode-compilation-analyzer

xcode-compilation-analyzer scores 82/100 on our quality scale, 3376th of 4,698 Development & Engineering skills we index.

Its SKILL.md is 5.3 KB long, well organised into 8 sections and no code examples: a solid amount of guidance for an agent.

With 1,235 GitHub stars, it is one of the more widely adopted skills in the catalogue.

Substance
26/30
Structure
13/20
Description
15/15
Adoption
13/20
Freshness
15/15

Maintenance, license and trust

  • The repository was last updated about 2 months ago, so xcode-compilation-analyzer is actively maintained.
  • Our last check on 2026-11-07 found the source still online.
  • It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
  • Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.

Safety scan

No issues found

Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.

AI review by kimi-k2.7-code on 2026-10-03. Automated pattern scan on 2026-10-03. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.

xcode-compilation-analyzer compared with similar skills

All 4 of these similar skills score higher than xcode-compilation-analyzer; compare them before choosing.

SkillScoreStarsUpdatedFormat
xcode-compilation-analyzer (this skill)by AvdLee821.2k2mo agoSKILL.md
taste-skillby Leonxlnx100116.8k8d agoCLAUDE.md
ai-job-searchby ai-job-search-dev10072.1ktodayCLAUDE.md
claude-howtoby luongnv8910047.3k2d agoCLAUDE.md
lobehubby lobehub10085.6ktodayMCP Server

Frequently asked questions

How do I install xcode-compilation-analyzer?
Run npx skills add AvdLee/Xcode-Build-Optimization-Agent-Skill --skill xcode-compilation-analyzer. The install tabs above show the steps for each supported agent.
Which AI agents does xcode-compilation-analyzer work with?
It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
Is xcode-compilation-analyzer safe to use?
Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
Is xcode-compilation-analyzer still maintained?
The repository was last updated about 2 months ago, so xcode-compilation-analyzer is actively maintained.

name: xcode-compilation-analyzer description: Analyze Swift and mixed-language compile hotspots using build timing summaries and Swift frontend diagnostics, then produce a recommend-first source-level optimization plan. Use when a developer reports slow compilation, type-checking warnings, expensive clean-build compile phases, long CompileSwiftSources tasks, warn-long-function-bodies output, or wants to speed up Swift type checking.

Xcode Compilation Analyzer

Use this skill when compile time, not just general project configuration, looks like the bottleneck.

Core Rules

  • Start from evidence, ideally a recent .build-benchmark/ artifact or raw timing-summary output.
  • Prefer analysis-only compiler flags over persistent project edits during investigation.
  • Rank findings by expected wall-clock impact, not cumulative compile-time impact. When compile tasks are heavily parallelized (sum of compile categories >> wall-clock median), note that fixing individual hotspots may improve parallel efficiency without reducing build wait time.
  • When the evidence points to parallelized work rather than serial bottlenecks, label recommendations as "Reduces compiler workload (parallel)" rather than "Reduces build time."
  • Do not edit source or build settings without explicit developer approval.

What To Inspect

  • Build Timing Summary output from clean and incremental builds
  • long-running CompileSwiftSources or per-file compilation tasks
  • SwiftEmitModule time -- can reach 60s+ after a single-line change in large modules; if it dominates incremental builds, the module is likely too large or macro-heavy
  • Planning Swift module time -- if this category is disproportionately large in incremental builds (up to 30s per module), it signals unexpected input invalidation or macro-related rebuild cascading
  • ad hoc runs with:
    • -Xfrontend -warn-long-expression-type-checking=<ms>
    • -Xfrontend -warn-long-function-bodies=<ms>
  • deeper diagnostic flags for thorough investigation:
    • -Xfrontend -debug-time-compilation -- per-file compile times to rank the slowest files
    • -Xfrontend -debug-time-function-bodies -- per-function compile times (unfiltered, complements the threshold-based warning flags)
    • -Xswiftc -driver-time-compilation -- driver-level timing to isolate driver overhead
    • -Xfrontend -stats-output-dir <path> -- detailed compiler statistics (JSON) per compilation unit for root-cause analysis
  • mixed Swift and Objective-C surfaces that increase bridging work

Analysis Workflow

  1. Identify whether the main issue is broad compilation volume or a few extreme hotspots.
  2. Parse timing-summary categories and rank the biggest compile contributors.
  3. Run the diagnostics script to surface type-checking hotspots:
    python3 scripts/diagnose_compilation.py \
      --project App.xcodeproj \
      --scheme MyApp \
      --configuration Debug \
      --destination "platform=iOS Simulator,name=iPhone 16" \
      --threshold 100 \
      --output-dir .build-benchmark
    
    This produces a ranked list of functions and expressions that exceed the millisecond threshold. Use the diagnostics artifact alongside source inspection to focus on the most expensive files first.
  4. Map the evidence to a concrete recommendation list.
  5. Separate code-level suggestions from project-level or module-level suggestions.

Apple-Derived Checks

Look for these patterns first:

  • missing explicit type information in expensive expressions
  • complex chained or nested expressions that are hard to type-check
  • delegate properties typed as AnyObject instead of a concrete protocol
  • oversized Objective-C bridging headers or generated Swift-to-Objective-C surfaces
  • header imports that skip framework qualification and miss module-cache reuse
  • classes missing final that are never subclassed
  • overly broad access control (public/open) on internal-only symbols
  • monolithic SwiftUI body properties that should be decomposed into subviews
  • long method chains or closures without intermediate type annotations

Reporting Format

For each recommendation, include:

  • observed evidence
  • likely affected file or module
  • expected wait-time impact (e.g. "Expected to reduce your clean build by ~2s" or "Reduces parallel compile work but unlikely to reduce build wait time")
  • confidence
  • whether approval is required before applying it

If the evidence points to project configuration instead of source, hand off to xcode-project-analyzer by reading its SKILL.md and applying its workflow to the same project context.

Preferred Tactics

  • Suggest ad hoc flag injection through the build command before recommending persistent build-setting changes.
  • Prefer narrowing giant view builders, closures, or result-builder expressions into smaller typed units.
  • Recommend explicit imports and protocol typing when they reduce compiler search space.
  • Call out when mixed-language boundaries are the real issue rather than Swift syntax alone.

Additional Resources

Related Skills

View on GitHub
GitHub Stars1.2k
CategoryDevelopment
Updated2mo ago
Forks48

Languages

Python

Trust signals

100/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

No cautions