Skip to main content
skill CX Codex

regression-hunt — Claude Code skill: what it does, how to install

regression-hunt — a skill for Claude Code that investigates regressions in PRs and commits. It coordinates error-hunting campaigns and resumes saved progress.

CC-BY-SA-4.0 685 installs ★ 8,341 updated 2026-10-24

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add trailofbits/skills --skill regression-hunt -a claude-code
Open on GitHub

What regression-hunt does

This skill automates regression hunting by coordinating agent work on specific PRs or commits. It manages campaign state using scope.json and progress.md files while distributing tasks among isolated agents.

It requires the registry.py script to reserve assignments and attempt directories. You must save file copies linked to specific SHAs in the guidance/ folder, as the agent cannot reproduce behavior without exact revisions. It does not perform general audits or patching, focusing instead on verifying specific changes.

What it helps with

  • investigate regressions in PRs
  • coordinate error-hunting campaigns
  • resume interrupted agent work

Example prompts for the agent

  • Run regression-hunt to analyze regressions in this PR
  • Resume the campaign from progress.md

How to install regression-hunt

1Skills CLI (Vercel)

npx skills add trailofbits/skills --skill regression-hunt -a claude-code

2Manually: put the files in place

~/.claude/skills/regression-hunt/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/regression-hunt/

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

Questions about regression-hunt

How to install regression-hunt in Claude Code?

Run npx skills add trailofbits/skills --skill regression-hunt -a claude-code. Then access it via ~/.claude/skills/regression-hunt/SKILL.md.

What does regression-hunt do?

It automates regression investigation by coordinating agent tasks and tracking campaign progress.

What is required to run regression-hunt?

You need the registry.py script and properly configured scope.json and progress.md files.

Similar skills

All skills for Agent setup: memory, context, orchestration →

From the same set95

The whole set →
review-walkthrough review-walkthrough turns the current branch diff into an HTML walkthrough with logical steps, explanations and review findings. Run it by hand when you want to read a change properly. CX Codex +1 1,200installs patching-bugs The patching-bugs skill takes one known bug through reproduction, a patch, independent proof, regression checks, and a local report. CX Codex +1 699installs reproduce-bug The reproduce-bug Claude Code skill checks whether a named compiler or runtime bug can be reproduced in a local repository. It runs against the project baseline before any edits. CX Codex +1 692installs validate-bug validate-bug — a skill for Claude Code that runs an independent rerun and judgment of a bug PoC package before patching. CX Codex +1 691installs implement-patch implement-patch — a Claude Code skill for fixing confirmed bugs at the invariant level. Enforces variant searches, upfront regression tests, and isolated patch records. CX Codex +1 677installs prove-patch prove-patch — a skill for Claude Code validates a local security patch with scoped cases and a three-arm comparison. It runs when a patch commit needs independent proof. CX Codex +1 676installs hunt-regressions hunt-regressions — a skill for Claude Code that discovers potential regressions before reproduction. Runs when analyzing code changes and their callers. CX Codex +1 675installs reproduce-regression The reproduce-regression Claude Code skill reproduces a regression candidate on live systems before and after a change. It builds a PoC and compares both versions using the same input. CX Codex +1 671installs

Project sponsors

Companies that keep this analytics open