Skip to main content
skill CX Codex

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

compare-generations compares two Tuist generation runs to pinpoint cache hit drops and uncover which modules caused invalidation cascades.

no license 300 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-generations -a claude-code
Open on GitHub

What compare-generations does

This skill inspects Tuist project generation metrics using run IDs, dashboard links, or git branch names. When branch arguments are omitted, it defaults to comparing the current branch against main. The assistant pulls data via tuist generate show to evaluate run duration, execution status, and target cache hit rates.

To trace invalidation causes, the agent connects changed files from git diff to specific project targets. This isolates direct edits in sources or build settings from secondary downstream misses triggered by dependency hash updates. The skill requires the Tuist command-line tool available in your environment.

The final summary reports timing differences, the cache rate delta, affected target counts, and architectural suggestions like splitting heavily linked modules.

What it helps with

  • diagnose cache hit rate drops between Tuist runs
  • compare project generation duration across git branches
  • pinpoint root-cause targets that trigger invalidation cascades
  • inspect whether build setting changes caused unexpected misses

Example prompts for the agent

  • Compare Tuist generation between main and the current branch
  • Investigate why cache hit rate dropped between gen-123 and gen-456
  • Check generation performance for branch feature-onboarding against main

How to install compare-generations

1Skills CLI (Vercel)

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

2Manually: put the files in place

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

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

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

Questions about compare-generations

How to install compare-generations in Claude Code?

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

What does compare-generations do?

It retrieves data from two Tuist generation runs, calculates the cache hit delta, and traces cascading invalidations back to root modules.

What is required to run this skill?

You need the Tuist CLI configured with project access and a local git repository to calculate file diffs between revisions.

Similar skills

All skills for Mobile →

From the same set12

The whole set →
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 compare-builds compare-builds analyzes two Xcode runs to spot build duration regressions, cache hit rate drops, and new compile issues via Tuist. CX Codex +1 317installs 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-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 compare-test-runs compare-test-runs compares two Tuist test executions to spot fresh failures, newly flaky suites, and execution duration spikes. CX Codex +1 265installs compare-test-case compare-test-case compares one test case across two branches: pass/fail, duration, flakiness and failure details. Useful when a feature branch seems to have broken a test. CX Codex +1 255installs

Project sponsors

Companies that keep this analytics open