patching-bugs — Claude Code skill: setup
The patching-bugs skill takes one known bug through reproduction, a patch, independent proof, regression checks, and a local report.
CC-BY-SA-4.0 699 installs ★ 8,341 updated 2026-10-24
npx skills add trailofbits/skills --skill patching-bugs -a claude-codeWhat patching-bugs 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.
What it helps with
- 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 for the agent
- Use
patching-bugsto 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-bugsto the current Git repository, then produce the local reports without pushing changes.
How to install patching-bugs
1Skills CLI (Vercel)
npx skills add trailofbits/skills --skill patching-bugs -a claude-code2Manually: put the files in place
~/.claude/skills/patching-bugs/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/patching-bugs/
1Skills CLI (Vercel)
npx skills add trailofbits/skills --skill patching-bugs -a codex2Manually: put the files in place
.agents/skills/patching-bugs/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add trailofbits/skills --skill patching-bugs -a cursor2Manually: put the files in place
.cursor/skills/patching-bugs/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install trailofbits/skills plugins/patching-bugs/skills/patching-bugs2Manually: put the files in place
.github/skills/patching-bugs/SKILL.md1Skills CLI (Vercel)
npx skills add trailofbits/skills --skill patching-bugs -a gemini-cli2Platform CLI
gemini skills install https://github.com/trailofbits/skills --path plugins/patching-bugs/skills/patching-bugsManually: put the files in place
.devin/skills/patching-bugs/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add trailofbits/skills --skill patching-bugs -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 patching-bugs
How do I install patching-bugs in Claude Code?
Run npx skills add trailofbits/skills --skill patching-bugs -a claude-code. The skill will be available at ~/.claude/skills/patching-bugs/SKILL.md.
What does patching-bugs do?
It takes one known bug through reproduction, patching, independent proof, regression checking, and report generation using retained records.
What does patching-bugs require before it starts?
The target must be a Git repository with a clean worktree. Its normal build command and regression-hunt must also be available.