# patching-bugs

The patching-bugs skill takes one known bug through reproduction, a patch, independent proof, regression checks, and a local report.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 699 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/patching-bugs/SKILL.md
- Updated: 2026-10-24
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/patching-bugs

## What it does

\`patching-bugs` is built for one named bug or testable bug theory in the current checkout. It records the baseline, turns the report into a finding, checks the behavior before edits, and sends implementation and proof to separate fresh agents. A regression campaign then covers `baseline..patch_commit`.

The workflow keeps JSON records, attempt directories, manifests, and generated HTML reports. Bundled scripts run through `uv run --no-project`, while conclusions are copied from retained receipts rather than agent summaries. The skill stops at blocked or inconclusive stages and does not push changes, open a pull request, or file an issue.

The project needs a clean Git worktree, its normal build command, and `regression-hunt` installed. A blocking preflight or record-check failure stops the run before a patch is accepted.

## Install

### Claude Code (native platform)

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

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

### Codex

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

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

### Cursor

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

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

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

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

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

### OpenCode

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

## When to use it
- reproduce a reported bug
- prepare a patch with independent proof
- check a fix for regressions
- preserve evidence in JSON records
- render a local review report

## Example prompts
- Use `patching-bugs` to investigate the upload-directory traversal bug, prove the behavior, and prepare a reviewable patch.
- Take this compiler failure as one finding, validate the repair with a separate agent, and run the regression campaign.
- Apply `patching-bugs` to the current Git repository, then produce the local reports without pushing changes.

## Similar
- [diagnosing-bugs](https://affpapa.org/en/nevibecode/skills/diagnosing-bugs.md) — skill · 834802 installs
- [find-bugs](https://affpapa.org/en/nevibecode/skills/find-bugs.md) — skill · 944 installs
- [nvshmem-troubleshoot-and-report-bugs](https://affpapa.org/en/nevibecode/skills/nvshmem-troubleshoot-and-report-bugs.md) — skill · ★ 4106 repo stars
- [find-skills](https://affpapa.org/en/nevibecode/skills/find-skills.md) — skill · 4400000 installs
- [frontend-design](https://affpapa.org/en/nevibecode/skills/frontend-design.md) — skill · 1025790 installs
- [agent-browser](https://affpapa.org/en/nevibecode/skills/vercel-labs-agent-browser.md) — skill · 1600000 installs
- [design-taste-frontend](https://affpapa.org/en/nevibecode/skills/design-taste-frontend.md) — skill · 802600 installs
- [grill-me](https://affpapa.org/en/nevibecode/skills/grill-me.md) — skill · 1424476 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
