# regression-hunt

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

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 685 installs · ★ 8341 repo stars
- Author: trailofbits
- License: CC-BY-SA-4.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/trailofbits/skills/tree/HEAD/plugins/regression-hunt/skills/regression-hunt/SKILL.md
- Updated: 2026-10-24
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/regression-hunt

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

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add trailofbits/skills --skill regression-hunt -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add trailofbits/skills --skill regression-hunt -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add trailofbits/skills --skill regression-hunt -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install trailofbits/skills plugins/regression-hunt/skills/regression-hunt
```

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

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add trailofbits/skills --skill regression-hunt -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/trailofbits/skills --path plugins/regression-hunt/skills/regression-hunt
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add trailofbits/skills --skill regression-hunt -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/trailofbits/skills/tree/HEAD/plugins/regression-hunt/skills/regression-hunt/SKILL.md

## When to use it
- investigate regressions in PRs
- coordinate error-hunting campaigns
- resume interrupted agent work

## Example prompts
- Run `regression-hunt` to analyze regressions in this PR
- Resume the campaign from `progress.md`

## Similar
- [regression-triage](https://affpapa.org/en/nevibecode/commands/regression-triage.md) — command · 25 installs
- [ai-regression-testing](https://affpapa.org/en/nevibecode/skills/ai-regression-testing.md) — skill · 6400 installs
- [prompt-regression](https://affpapa.org/en/nevibecode/skills/prompt-regression.md) — skill · ★ 33 repo stars
- [skill-regression-evaluator](https://affpapa.org/en/nevibecode/skills/skill-regression-evaluator.md) — skill · ★ 529 repo stars
- [regression-case-author](https://affpapa.org/en/nevibecode/skills/regression-case-author.md) — skill · ★ 529 repo stars
- [prompt-regression-tester](https://affpapa.org/en/nevibecode/skills/prompt-regression-tester.md) — skill · 265 installs

From the same set: [trailofbits/skills](https://affpapa.org/en/nevibecode/by/trailofbits/skills.md) — 95 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
