SECURITY REVIEW / Trail of Bits
Vulnerability Triage Brocards
Runs an incoming vulnerability report or automated finding through seven pass, dismiss or needs-more-info tests and returns a one-table triage summary with an accept, dismiss or needs-more-info verdict.
“This skill should be used when the user asks to "triage a vulnerability report", "assess a CVE", "evaluate a bug bounty submission", "decide if a finding is valid", "review a security finding", "dismiss a vulnerability", "should we fix this CVE", "prioritize a vulnerability report", or needs to determine whether an incoming vulnerability report warrants investigation. Applies 7 brocards (rules of thumb) to systematically accept, dismiss, or request more information on vulnerability reports, or needs to filter raw findings from agentic vulnerability discovery pipelines before human review.”
01 / THE REASONING
Why this made the selection.
- Each of the seven brocards is written as a falsifiable quick test, such as whether the report can say "an attacker with [capability] can [action] to achieve [impact]".
- It lists rationalizations to reject in both directions, from "It's only reachable in debug mode" to "It has a CVE, so it must be real".
- The criteria are adapted from William Woodruff's "Brocards for vulnerability triage", and the reference file works each brocard through examples and edge cases.
02 / THE REVIEW RECORD
What we actually inspected.
Source review has boundaries.
A clear record is more useful than a “safe” badge.
Material inspected
- plugins/vulnerability-triage-brocards/skills/vulnerability-triage-brocards/SKILL.md
- plugins/vulnerability-triage-brocards/skills/vulnerability-triage-brocards/references/brocards-detail.md (section headings and examples)
- plugins/vulnerability-triage-brocards/README.md
- plugins/vulnerability-triage-brocards/.claude-plugin/plugin.json
- README.md (installation and licence sections)
- LICENSE
Our findings
- The frontmatter declares no allowed-tools, so tool access is what the host grants.
- Each brocard records PASS, DISMISS or NEEDS-MORE-INFO, and the summary ends with an overall verdict, a reasoning line and a next step.
- Brocard 4 has a nuance: an implementation that claims a stricter posture than the standard and fails it is still vulnerable.
- Brocard 7 tells the reviewer to strip the CVE number and CVSS score and judge the technical description alone.
- The reference cites a CVE against pygments as a Brocard 6 dismissal where the report caused more disruption than the alleged flaw.
Not established by this review
- Not executed: it was not installed or run.
- No report was triaged with it.
The review applies to the material and revision named here. A newer upstream release can change its behavior.
03 / PUT IT TO WORK
Add a skill to your workflow.
- Run `/plugin marketplace add trailofbits/skills` in Claude Code. That adds every Trail of Bits plugin to the marketplace list; it does not install the brocards skill on its own.
- Choose the vulnerability-triage-brocards plugin, which contains only this skill, in `/plugin menu`.
- Alternatively, the plugin README loads a local copy with `claude --plugin-dir /path/to/vulnerability-triage-brocards`, replacing the path with the plugin directory.
Before you start
- Claude Code
- The vulnerability report, finding or advisory to triage, plus read access to the affected code for the reachability checks
04 / FOLLOW THE EVIDENCE
The source trail.
Our notes are separate from the original resource.
Check upstream before adopting a new version.
https://raw.githubusercontent.com/trailofbits/skills/8e54050ae63c2f62224c35b1616efe71865b4777/plugins/vulnerability-triage-brocards/skills/vulnerability-triage-brocards/SKILL.md
Supports: upstreamDescription, summary, whySelected, bestFor, limitations, access, review.findings
https://raw.githubusercontent.com/trailofbits/skills/8e54050ae63c2f62224c35b1616efe71865b4777/plugins/vulnerability-triage-brocards/skills/vulnerability-triage-brocards/references/brocards-detail.md
Supports: whySelected, review.findings
https://raw.githubusercontent.com/trailofbits/skills/8e54050ae63c2f62224c35b1616efe71865b4777/plugins/vulnerability-triage-brocards/README.md
Supports: install.steps, compatibility, limitations
https://raw.githubusercontent.com/trailofbits/skills/8e54050ae63c2f62224c35b1616efe71865b4777/plugins/vulnerability-triage-brocards/.claude-plugin/plugin.json
Supports: review.inspected
- trailofbits/skills README ↗Checked
https://raw.githubusercontent.com/trailofbits/skills/8e54050ae63c2f62224c35b1616efe71865b4777/README.md
Supports: install, license
- trailofbits/skills LICENSE ↗Checked
https://raw.githubusercontent.com/trailofbits/skills/8e54050ae63c2f62224c35b1616efe71865b4777/LICENSE
Supports: license