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
npx skills add tuist/agent-skills --skill compare-generations -a claude-codeWhat 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-code2Manually: put the files in place
~/.claude/skills/compare-generations/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/compare-generations/
1Skills CLI (Vercel)
npx skills add tuist/agent-skills --skill compare-generations -a codex2Manually: put the files in place
.agents/skills/compare-generations/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add tuist/agent-skills --skill compare-generations -a cursor2Manually: put the files in place
.cursor/skills/compare-generations/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install tuist/agent-skills skills/compare-generations2Manually: put the files in place
.github/skills/compare-generations/SKILL.md1Skills CLI (Vercel)
npx skills add tuist/agent-skills --skill compare-generations -a gemini-cli2Platform CLI
gemini skills install https://github.com/tuist/agent-skills --path skills/compare-generationsManually: put the files in place
.devin/skills/compare-generations/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add tuist/agent-skills --skill compare-generations -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
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.