tuist avatar

Compare Cache Runs

When your CI cache hit rates tank after a merge, this skill helps you figure out why. It compares two tuist cache runs (by ID, dashboard URL, or branch name), calculates hit rate deltas, and traces which modules triggered the invalidation cascade. The real value is in the root cause analysis: it distinguishes between targets with direct source changes versus the dozen downstream modules that got invalidated just because their dependency hash changed. You get a breakdown showing duration regression, cache metrics, and specific recommendations like splitting fat modules or warming caches after rebasing. Saves you from manually diffing JSON output and guessing which changed file nuked your cache warming strategy.

skills.sh installs
284
GitHub stars
35
last updated
Aug 21, 2026

Install

$ npx -y skills add tuist/agent-skills --skill compare-cache-runs --agent claude-code

Installs into .claude/skills of the current project.

Files

Compare Cache Runs

Quick Start

You'll typically receive two cache run identifiers. Follow these steps:

  1. Run tuist cache-run list --json to find cache runs on each branch.
  2. Run tuist cache-run show <id> --json for both base and head cache runs.
  3. Compare duration, status, and cache hit rates.
  4. Summarize cache changes with root cause analysis.

Step 1: Resolve Cache Runs

If base/head are cache run IDs or dashboard URLs

Fetch each directly:

tuist cache-run show <base-id> --json
tuist cache-run show <head-id> --json

If base/head are branch names

List recent cache runs on each branch:

tuist cache-run list --git-branch <base-branch> --json --page-size 1
tuist cache-run list --git-branch <head-branch> --json --page-size 1

Then fetch full details with tuist cache-run show <id> --json.

Defaults

  • If no base is provided, use the project's default branch (usually main).
  • If no head is provided, detect the current git branch.

Step 2: Compare Top-Level Metrics

After fetching both cache runs, compare:

Sponsors

Details

Repository
github.com/tuist/agent-skills
Categories
Git & Pull Requests, AI & Agent Building
First seen
Jun 3, 2026

More from tuist/agent-skills

All 9
1davila7 avatarrailway-servicedavila7/claude-code-templatesCheck service status, rename services, change service icons, link services, or create services with Docker images. For creating services with local code, prefer282skills.sh installs
2patricio0312rev avatarsecrets-scannerpatricio0312rev/skillsDetects leaked API keys, tokens, passwords, and credentials in code with pre-commit hooks, CI checks, scanning rules, and remediation procedures. Use for "secre282skills.sh installs
3everyinc avatarproofeveryinc/compound-engineering-pluginCreate, edit, comment on, share, and run human-in-the-loop iteration loops over markdown documents via Proof's web API. Use when asked to "proof", "share a doc"277skills.sh installs
4pedronauck avatardevops-engineerpedronauck/skillsCreates Dockerfiles, configures CI/CD pipelines, writes Kubernetes manifests, and generates Terraform/Pulumi infrastructure templates. Handles deployment automa264skills.sh installs
5paperclipai avatarreleasepaperclipai/paperclipCoordinate a full Paperclip release across engineering verification, npm, GitHub, smoke testing, and announcement follow-up. Use when leadership asks to ship a 262skills.sh installs
6patricio0312rev avatarpostmortem-writerpatricio0312rev/skillsCreates comprehensive post-incident documents with timeline, root cause analysis, contributing factors, action items, and ownership. Follows SRE best practices 261skills.sh installs