← Explore all skills

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.

Upstream setup instructions ↗
  1. 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.
  2. Choose the vulnerability-triage-brocards plugin, which contains only this skill, in `/plugin menu`.
  3. 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.

  1. 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

  2. https://raw.githubusercontent.com/trailofbits/skills/8e54050ae63c2f62224c35b1616efe71865b4777/plugins/vulnerability-triage-brocards/skills/vulnerability-triage-brocards/references/brocards-detail.md

    Supports: whySelected, review.findings

  3. https://raw.githubusercontent.com/trailofbits/skills/8e54050ae63c2f62224c35b1616efe71865b4777/plugins/vulnerability-triage-brocards/README.md

    Supports: install.steps, compatibility, limitations

  4. https://raw.githubusercontent.com/trailofbits/skills/8e54050ae63c2f62224c35b1616efe71865b4777/plugins/vulnerability-triage-brocards/.claude-plugin/plugin.json

    Supports: review.inspected

  5. https://raw.githubusercontent.com/trailofbits/skills/8e54050ae63c2f62224c35b1616efe71865b4777/README.md

    Supports: install, license

  6. https://raw.githubusercontent.com/trailofbits/skills/8e54050ae63c2f62224c35b1616efe71865b4777/LICENSE

    Supports: license

Evidence & Ask