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
npx skills add trailofbits/skills --skill regression-hunt -a claude-codeWhat 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-huntto 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-code2Manually: put the files in place
~/.claude/skills/regression-hunt/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/regression-hunt/
1Skills CLI (Vercel)
npx skills add trailofbits/skills --skill regression-hunt -a codex2Manually: put the files in place
.agents/skills/regression-hunt/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add trailofbits/skills --skill regression-hunt -a cursor2Manually: put the files in place
.cursor/skills/regression-hunt/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install trailofbits/skills plugins/regression-hunt/skills/regression-hunt2Manually: put the files in place
.github/skills/regression-hunt/SKILL.md1Skills CLI (Vercel)
npx skills add trailofbits/skills --skill regression-hunt -a gemini-cli2Platform CLI
gemini skills install https://github.com/trailofbits/skills --path plugins/regression-hunt/skills/regression-huntManually: put the files in place
.devin/skills/regression-hunt/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add trailofbits/skills --skill regression-hunt -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 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.