reproduce-bug — Claude Code skill: purpose and installation
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.
CC-BY-SA-4.0 692 installs ★ 8,341 updated 2026-10-24
npx skills add trailofbits/skills --skill reproduce-bug -a claude-codeWhat reproduce-bug 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.
What it helps with
- 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 for the agent
- Check the runtime issue in
finding.jsonagainst the project baseline. - Reproduce the compiler failure and record the outcome in
reproduce.json. - Run the PoC check and create a manifest for
reproduce/.
How to install reproduce-bug
1Skills CLI (Vercel)
npx skills add trailofbits/skills --skill reproduce-bug -a claude-code2Manually: put the files in place
~/.claude/skills/reproduce-bug/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/reproduce-bug/
1Skills CLI (Vercel)
npx skills add trailofbits/skills --skill reproduce-bug -a codex2Manually: put the files in place
.agents/skills/reproduce-bug/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add trailofbits/skills --skill reproduce-bug -a cursor2Manually: put the files in place
.cursor/skills/reproduce-bug/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install trailofbits/skills plugins/patching-bugs/skills/reproduce-bug2Manually: put the files in place
.github/skills/reproduce-bug/SKILL.md1Skills CLI (Vercel)
npx skills add trailofbits/skills --skill reproduce-bug -a gemini-cli2Platform CLI
gemini skills install https://github.com/trailofbits/skills --path plugins/patching-bugs/skills/reproduce-bugManually: put the files in place
.devin/skills/reproduce-bug/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add trailofbits/skills --skill reproduce-bug -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 reproduce-bug
How do I install reproduce-bug in Claude Code?
Run npx skills add trailofbits/skills --skill reproduce-bug -a claude-code. The skill file is at ~/.claude/skills/reproduce-bug/SKILL.md.
What does reproduce-bug do?
It tests a reported bug against the local project’s baseline before edits, saves the observations, and records whether the issue was reproduced.
What does reproduce-bug need to run?
It needs a finding.json file, a local baseline checkout, and the project’s build command. Creating the manifest uses uv.