prove-patch — Claude Code skill: what it does, install
prove-patch — a skill for Claude Code validates a local security patch with scoped cases and a three-arm comparison. It runs when a patch commit needs independent proof.
CC-BY-SA-4.0 676 installs ★ 8,341 updated 2026-10-24
npx skills add trailofbits/skills --skill prove-patch -a claude-codeWhat prove-patch does
The skill tests a security patch against the original baseline and the final patch commit, keeping the harness, inputs, and command consistent between both trees. Cases inside the declared scope should fail before the fix and pass after it; valid controls should pass on both sides. Raw output, exit status, timing, commands, and harness source go into receipts/.
It also checks the reverted tree: baseline must fail, the patch must pass, and a complete revert must fail again. Project checks are retained, then prove.json and a manifest are created and validated with uv run --no-project <script>. An uncommitted tree is not validated; setup errors, timeouts, missing markers, and ambiguous observations become evidence gaps.
What it helps with
- verify a fix across baseline and patch commits
- compare failing cases with a valid control
- confirm behavior after a complete patch revert
- retain raw test output and harness commands
- create and validate the proof manifest
Example prompts for the agent
- Check this local security patch against the baseline and patch commits, and keep every receipt in
receipts/. - Run the three-arm proof: baseline should fail, the patch should pass, and the reverted tree should fail again.
- Create
prove.json, build the manifest, and validate it withuv run --no-project <script>.
How to install prove-patch
1Skills CLI (Vercel)
npx skills add trailofbits/skills --skill prove-patch -a claude-code2Manually: put the files in place
~/.claude/skills/prove-patch/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/prove-patch/
1Skills CLI (Vercel)
npx skills add trailofbits/skills --skill prove-patch -a codex2Manually: put the files in place
.agents/skills/prove-patch/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add trailofbits/skills --skill prove-patch -a cursor2Manually: put the files in place
.cursor/skills/prove-patch/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install trailofbits/skills plugins/patching-bugs/skills/prove-patch2Manually: put the files in place
.github/skills/prove-patch/SKILL.md1Skills CLI (Vercel)
npx skills add trailofbits/skills --skill prove-patch -a gemini-cli2Platform CLI
gemini skills install https://github.com/trailofbits/skills --path plugins/patching-bugs/skills/prove-patchManually: put the files in place
.devin/skills/prove-patch/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add trailofbits/skills --skill prove-patch -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 prove-patch
How do I install prove-patch in Claude Code?
Run npx skills add trailofbits/skills --skill prove-patch -a claude-code, then use ~/.claude/skills/prove-patch/SKILL.md.
What does prove-patch do?
It checks a scoped security patch on the baseline and patched trees, runs relevant project checks, and stores raw evidence in receipts/. It also compares the original, patched, and fully reverted states.
How does prove-patch perform the three-arm check?
The baseline must fail, the patch must pass, and the fully reverted tree must fail again. The skill also checks build identity and that the reverted tree matches the original baseline tree.