# replay-regression

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.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 668 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/replay-regression/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/replay-regression

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

## Install

### Claude Code (native platform)

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

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

### Codex

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

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

### Cursor

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

2. **Manually: put the files in place**
- File: `.cursor/skills/replay-regression/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/replay-regression
```

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

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

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

### OpenCode

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

## When to use it
- 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
- 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.

## Similar
- [browser-replay](https://affpapa.org/en/nevibecode/skills/browser-replay.md) — skill · 721 installs
- [agent-observability-replay-trace](https://affpapa.org/en/nevibecode/skills/agent-observability-replay-trace.md) — skill · 535 installs
- [ai-regression-testing](https://affpapa.org/en/nevibecode/skills/ai-regression-testing.md) — skill · 6400 installs
- [investigating-replay](https://affpapa.org/en/nevibecode/skills/investigating-replay.md) — skill · 424 installs
- [finding-replay-for-issue](https://affpapa.org/en/nevibecode/skills/finding-replay-for-issue.md) — skill · 407 installs
- [competition-custom-protocol-replay](https://affpapa.org/en/nevibecode/skills/competition-custom-protocol-replay.md) — skill · 109 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
