# compare-generations

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

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 300 installs · ★ 35 repo stars
- Author: tuist
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/tuist/agent-skills/tree/HEAD/skills/compare-generations/SKILL.md
- Updated: 2026-03-27
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/compare-generations

## What it 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.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add tuist/agent-skills --skill compare-generations -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/compare-generations/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/compare-generations/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add tuist/agent-skills --skill compare-generations -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/compare-generations/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add tuist/agent-skills --skill compare-generations -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/compare-generations/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install tuist/agent-skills skills/compare-generations
```

2. **Manually: put the files in place**
- File: `.github/skills/compare-generations/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add tuist/agent-skills --skill compare-generations -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/tuist/agent-skills --path skills/compare-generations
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/compare-generations/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add tuist/agent-skills --skill compare-generations -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/tuist/agent-skills/tree/HEAD/skills/compare-generations/SKILL.md

## When to use it
- 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
- 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

## Similar
- [limrun-xcode-bazel](https://affpapa.org/en/nevibecode/skills/limrun-xcode-bazel.md) — skill · 45300 installs
- [limrun-xcode](https://affpapa.org/en/nevibecode/skills/limrun-xcode.md) — skill · 45300 installs
- [asc-xcode-build](https://affpapa.org/en/nevibecode/skills/asc-xcode-build.md) — skill · 8000 installs
- [kotlin-tooling-kotlin-toolchain](https://affpapa.org/en/nevibecode/skills/kotlin-tooling-kotlin-toolchain.md) — skill · 753 installs
- [xcode-build-orchestrator](https://affpapa.org/en/nevibecode/skills/xcode-build-orchestrator.md) — skill · 3700 installs
- [xcode-build-benchmark](https://affpapa.org/en/nevibecode/skills/xcode-build-benchmark.md) — skill · 3500 installs

From the same set: [tuist/agent-skills](https://affpapa.org/en/nevibecode/by/tuist/agent-skills.md) — 12 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
