replay-regression — Claude Code skill: PoC replay
The replay-regression Claude Code skill independently tests a supplied PoC against fresh builds from before and after a change. It runs the same input on S0 and S1, then records what happened.
CC-BY-SA-4.0 668 installs ★ 8,341 updated 2026-10-24
npx skills add trailofbits/skills --skill replay-regression -a claude-codeWhat replay-regression does
The skill checks a complete reproduction package and runs the PoC in a context separate from the original reproducer. It builds and runs actual S0 and S1 inside its own attempt directory, then executes the unchanged PoC with the same input on both. Every build directory goes into build_dirs.
It tests whether the claimed user or attacker can reach the real interface, saving setup details, versions, commands, observations, and separate logs. It then writes and seals replay.json, linking it to the reproduction record and the original PoC and input. The attempt needs frozen source records, a complete sealed reproduction package, and a registry assignment; failed prerequisites stop execution. The skill does not write or repair a PoC. Any changed PoC needs a new reproduction and replay.
What it helps with
- independently replay a supplied PoC
- compare S0 and S1 using identical input
- test interface access with the claimed permissions
- record blockers or divergent results in
replay.json
Example prompts for the agent
- Replay this PoC independently against S0 and S1 from the reproduction package.
- Run the supplied PoC in a separate attempt and record the result in
replay.json. - Check interface access with the claimed user permissions and save the observations.
How to install replay-regression
1Skills CLI (Vercel)
npx skills add trailofbits/skills --skill replay-regression -a claude-code2Manually: put the files in place
~/.claude/skills/replay-regression/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/replay-regression/
1Skills CLI (Vercel)
npx skills add trailofbits/skills --skill replay-regression -a codex2Manually: put the files in place
.agents/skills/replay-regression/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add trailofbits/skills --skill replay-regression -a cursor2Manually: put the files in place
.cursor/skills/replay-regression/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install trailofbits/skills plugins/regression-hunt/skills/replay-regression2Manually: put the files in place
.github/skills/replay-regression/SKILL.md1Skills CLI (Vercel)
npx skills add trailofbits/skills --skill replay-regression -a gemini-cli2Platform CLI
gemini skills install https://github.com/trailofbits/skills --path plugins/regression-hunt/skills/replay-regressionManually: put the files in place
.devin/skills/replay-regression/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add trailofbits/skills --skill replay-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 replay-regression
How do I install replay-regression in Claude Code?
Run npx skills add trailofbits/skills --skill replay-regression -a claude-code. The skill file is at ~/.claude/skills/replay-regression/SKILL.md.
What does replay-regression do?
It independently runs a supplied PoC against S0 and S1, checks whether the claimed failure appears, and saves a sealed replay.json record.
Can replay-regression modify a PoC?
No. It tests the supplied PoC unchanged; edits require a new reproduction and replay.