prepare-regression — Claude Code skill for regression prep
prepare-regression — a skill for Claude Code that pins source revisions and gathers commit or PR context for a regression investigation. It runs during investigation setup.
CC-BY-SA-4.0 670 installs ★ 8,341 updated 2026-10-24
npx skills add trailofbits/skills --skill prepare-regression -a claude-codeWhat prepare-regression does
The skill records the change boundaries and gathers material for a regression investigation. It takes a PR plus a registry assignment, or a repository with a commit or range. For an open PR, it uses the merge base and frozen head; for a merged PR, the boundary depends on how it was merged. An unclear range or missing baseline blocks preparation.
It preserves PR titles and discussion, reviews, inline comments, or commit messages, with URLs and collection times. It runs snapshot.py through uv run --no-project, or uses Git commands for special source needs. Dependency, submodule, and LFS revisions are retained; builds use separate copies. The sealed package contains prepare.json and source artifacts. It requires uv and Git, along with a PR or a repository and commit range, plus a registry assignment.
What it helps with
- pin the full change boundary for a regression investigation
- collect PR discussion, reviews, and inline comments
- preserve source and dependency revisions for comparison
- record evidence and blockers in
prepare.json
Example prompts for the agent
- Prepare the evidence for a regression investigation from this PR and registry assignment.
- Gather regression context for this repository and commit range.
- Pin the source revisions and create the
prepare.jsonpackage.
How to install prepare-regression
1Skills CLI (Vercel)
npx skills add trailofbits/skills --skill prepare-regression -a claude-code2Manually: put the files in place
~/.claude/skills/prepare-regression/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/prepare-regression/
1Skills CLI (Vercel)
npx skills add trailofbits/skills --skill prepare-regression -a codex2Manually: put the files in place
.agents/skills/prepare-regression/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add trailofbits/skills --skill prepare-regression -a cursor2Manually: put the files in place
.cursor/skills/prepare-regression/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install trailofbits/skills plugins/regression-hunt/skills/prepare-regression2Manually: put the files in place
.github/skills/prepare-regression/SKILL.md1Skills CLI (Vercel)
npx skills add trailofbits/skills --skill prepare-regression -a gemini-cli2Platform CLI
gemini skills install https://github.com/trailofbits/skills --path plugins/regression-hunt/skills/prepare-regressionManually: put the files in place
.devin/skills/prepare-regression/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add trailofbits/skills --skill prepare-regression -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 prepare-regression
How do I install prepare-regression in Claude Code?
Run npx skills add trailofbits/skills --skill prepare-regression -a claude-code. The skill file is at ~/.claude/skills/prepare-regression/SKILL.md.
What does prepare-regression do?
It establishes the change boundaries, collects PR or commit context, and stores source artifacts with a sealed prepare.json.
What does prepare-regression need to run?
It needs uv and Git, plus a PR and registry assignment, or a repository with a commit or range and registry assignment.