# validate-bug

validate-bug — a skill for Claude Code that runs an independent rerun and judgment of a bug PoC package before patching.

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

## What it does

The agent starts this skill after the reproduction phase to independently test the bug package and verify the diagnostic assertion. It reads `finding.json`, reruns the baseline compiler or runtime PoC without modifications, and saves execution outputs into `validate/receipts/`. If an observation is unreliable, it returns an inconclusive status.

The procedure forbids editing the PoC or inferring results from the reproducer transcript. It requires `uv` to manifest the `validate/` directory and run the record checker script.

## Install

### Claude Code (native platform)

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

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

### Codex

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

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

### Cursor

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

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

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

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

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

### OpenCode

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

## When to use it
- run an independent rerun of a bug PoC package
- write the validation outcome into validate.json
- store stdout, stderr, and execution timings in receipts
- check records using the built-in script

## Example prompts
- Rerun the bug PoC package independently
- Validate the finding and PoC before writing a patch
- Check the reproduction package and record the outcome

## Similar
- [exhaustive-systems-analysis](https://affpapa.org/en/nevibecode/skills/exhaustive-systems-analysis.md) — skill · 185 installs
- [bug-bounty](https://affpapa.org/en/nevibecode/skills/bug-bounty.md) — skill · 682 installs
- [api-fuzzing-bug-bounty](https://affpapa.org/en/nevibecode/skills/api-fuzzing-bug-bounty.md) — skill · 139 installs
- [ghost-validate](https://affpapa.org/en/nevibecode/skills/ghost-validate.md) — skill · 4200 installs
- [lint-and-validate](https://affpapa.org/en/nevibecode/skills/lint-and-validate.md) — skill · 96 installs
- [Bug Discovery Code Assistant](https://affpapa.org/en/nevibecode/prompts/bug-discovery-code-assistant.md) — prompt · ★ 178201 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
