# reproduce-bug

The reproduce-bug Claude Code skill checks whether a named compiler or runtime bug can be reproduced in a local repository. It runs against the project baseline before any edits.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 692 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/patching-bugs/skills/reproduce-bug/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/reproduce-bug

## What it does

The skill tests a reported compiler or runtime failure in a local repository and records what happened. It needs a `finding.json` file and a local baseline checkout. The agent builds that version with the project’s own command, then exercises the planned inputs before editing and saves command output, exit status, and timing.

For runtime issues, the check runs against the built artifact; for compiler issues, it captures the diagnostic from a failed build. Results and invocation details go into `reproduce.json`, with source materials stored under `reproduce/`. The manifest is created with `uv run --no-project <script> manifest <reproduce-step-dir>`. When the build or environment prevents a valid test, the outcome is `blocked` and the finding stays a hypothesis.

## Install

### Claude Code (native platform)

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

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

### Codex

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

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

### Cursor

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

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install trailofbits/skills plugins/patching-bugs/skills/reproduce-bug
```

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

### Gemini CLI

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

2. **Platform CLI**
```bash
gemini skills install https://github.com/trailofbits/skills --path plugins/patching-bugs/skills/reproduce-bug
```

### Windsurf (Devin Desktop)

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

### OpenCode

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

## When to use it
- test whether a compiler failure occurs on the baseline
- run a PoC against a built runtime artifact
- record command output and reproduction status
- document a blocker that prevents a valid run

## Example prompts
- Check the runtime issue in `finding.json` against the project baseline.
- Reproduce the compiler failure and record the outcome in `reproduce.json`.
- Run the PoC check and create a manifest for `reproduce/`.

## Similar
- [gui-reproduce-bug-report-local](https://affpapa.org/en/nevibecode/skills/gui-reproduce-bug-report-local.md) — skill · ★ 720 repo stars
- [mantis-reproduce](https://affpapa.org/en/nevibecode/skills/mantis-reproduce.md) — skill · 1600 installs
- [bug-reproduction-brief](https://affpapa.org/en/nevibecode/skills/bug-reproduction-brief.md) — skill · 62 installs
- [reproduce-and-fix-issues](https://affpapa.org/en/nevibecode/skills/reproduce-and-fix-issues.md) — skill · 865 installs
- [evidence-hygiene](https://affpapa.org/en/nevibecode/skills/evidence-hygiene.md) — skill · ★ 16193 repo stars
- [sast-hunter](https://affpapa.org/en/nevibecode/skills/sast-hunter.md) — skill · ★ 1298 repo stars

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
