Skip to main content
skill CX Codex

compare-builds — Claude Code skill: what it does, how to install

compare-builds analyzes two Xcode runs to spot build duration regressions, cache hit rate drops, and new compile issues via Tuist.

no license 317 installs ★ 35 updated 2026-03-27

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add tuist/agent-skills --skill compare-builds -a claude-code
Open on GitHub

What compare-builds does

This skill compares two Xcode runs using build identifiers, web dashboard URLs, or git branch names. When given a single identifier, it uses the repository default branch as the baseline and identifies the current branch with git rev-parse.

The skill fetches build records with tuist build show --json, then queries targets, issues, and cache tasks. It computes the total cache hit rate and tracks target runtimes. An increase in duration greater than 10% is marked as a regression.

Execution requires a functional tuist CLI in your environment. Comparing an incremental run against a clean build skews performance numbers. The output flags mismatched build categories so you avoid misleading conclusions.

What it helps with

  • detect Xcode build slowdowns across different branches
  • isolate target-level drops in Tuist cache hit rates
  • catch newly introduced warnings or compiler errors
  • verify whether dependency changes broke cache validity

Example prompts for the agent

  • Compare the build for feature-checkout against main
  • Inspect build runs bld_abc123 and bld_def456 to see why build time increased
  • Analyze cache misses between the latest run and the default branch

How to install compare-builds

1Skills CLI (Vercel)

npx skills add tuist/agent-skills --skill compare-builds -a claude-code

2Manually: put the files in place

~/.claude/skills/compare-builds/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/compare-builds/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about compare-builds

How do I install compare-builds in Claude Code?

Run npx skills add tuist/agent-skills --skill compare-builds -a claude-code in your terminal.

What does the compare-builds skill do?

It queries Tuist build records via JSON commands, checks target durations and cache statistics, and presents a verdict explaining any build slowdowns.

What prerequisites are required for accurate comparisons?

You need the tuist CLI installed. Runs should share the same scheme, configuration, and category, because comparing clean runs against incremental ones produces inaccurate conclusions.

Similar skills

All skills for Mobile →

From the same set12

The whole set →
using-tuist-generated-projects using-tuist-generated-projects guides coding agents through Tuist-generated Xcode workspaces, optimizing xcodebuild testing routines, selective target generation, and buildable folder structures. CX Codex +1 629installs debug-generated-project debug-generated-project troubleshoots Tuist project generation failures, build errors, and runtime crashes. It sets up isolated reproductions and verifies fixes against the main branch. CX Codex +1 543installs fix-flaky-tests The fix-flaky-tests skill reads a test's failure history in Tuist, works out the root cause and patches the test. Useful when a test passes and fails at random. CX Codex +1 529installs migrating-to-tuist-generated-projects migrating-to-tuist-generated-projects is a Claude Code skill that moves an existing Xcode project into Tuist-generated files. It runs during a Tuist adoption and checks that the app builds and launches. CX Codex +1 521installs analyze-selective-testing analyze-selective-testing diagnoses Tuist selective test runs in Xcode to spot skipped targets and identify cache invalidation causes. CX Codex +1 310installs compare-generations compare-generations compares two Tuist generation runs to pinpoint cache hit drops and uncover which modules caused invalidation cascades. CX Codex +1 300installs compare-bundles compare-bundles evaluates two application packages via Tuist to spot size growth and heavy files. Helpful for catching build regressions early. CX Codex +1 296installs compare-cache-runs compare-cache-runs is a Claude Code skill that compares two Tuist cache runs, revealing hit-rate changes, root causes, and cascade effects through dependencies. CX Codex +1 291installs

Project sponsors

Companies that keep this analytics open