← Explore all skills

SECURITY REVIEW / Trail of Bits

Trailmark Finding Triage

Triages a single finding, SARIF result, weAudit annotation, suspicious function or report excerpt with Trailmark reachability, entrypoint-path, taint, privilege-boundary, blast-radius and caller/callee evidence, returning one of four verdicts: Promote, Needs manual review, Deprioritize or Blocked.

“Performs graph-assisted triage of a single security finding, SARIF result, weAudit annotation, suspicious function, or report excerpt using Trailmark reachability, entrypoint paths, taint, privilege-boundary, blast-radius, caller/callee, and neighborhood evidence. Use when deciding whether one candidate issue is reachable, prioritizing a finding before PoC work, preparing evidence for exploit validation, or checking whether a static-analysis result is actionable.”

01 / THE REASONING

Why this made the selection.

  • Triages one finding with reachability, entrypoint paths, taint, privilege-boundary, blast-radius and caller/callee evidence from the graph.
  • It stops and asks for a concrete code anchor when none is given, and says graph reachability is not proof of exploitability.
  • Its bundled scripts/evidence_packet.py builds the graph and pre-analysis once for several file:line findings and leaves the verdict to the reviewer.

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/trailmark/skills/trailmark-finding-triage/SKILL.md
  • plugins/trailmark/skills/trailmark-finding-triage/scripts/evidence_packet.py
  • plugins/trailmark/README.md (prerequisites and version notes)
  • plugins/trailmark/agents/code-slice-worker.md (host note)
  • README.md (installation and licence sections)
  • LICENSE

Our findings

  • Trailmark Finding Triage's SKILL.md declares allowed-tools Bash, Read, Grep, Glob and Write.
  • If no concrete code anchor is given, it stops and asks for one.
  • It emits one verdict — Promote, Needs manual review, Deprioritize or Blocked — and warns that reachability is not exploitability.
  • A finding that binds to nothing comes back from evidence_packet.py with bound_node: null and the reason.

Not established by this review

  • Not executed: it was not installed or run.
  • The Trailmark Finding Triage skill and any bundled scripts were not run.

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. `/plugin marketplace add trailofbits/skills` (repository README) adds the whole Trail of Bits marketplace, not one skill.
  2. Install the `trailmark` plugin from `/plugin menu`; it bundles the Trailmark Finding Triage skill with the other trailmark skills listed in the trailmark plugin README.
  3. `uv tool install trailmark` (trailmark plugin README) installs the Trailmark CLI that this skill drives.

Before you start

  • The Trailmark CLI, installed with `uv tool install trailmark` (trailmark plugin README)
  • uv
  • Python 3.12+ for the bundled evidence_packet.py

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/f0dd11d2b1da17a1ff8c403741fbe1f6bca0f871/plugins/trailmark/skills/trailmark-finding-triage/SKILL.md

    Supports: upstreamDescription, summary, whySelected, bestFor, limitations, access, review.findings

  2. https://raw.githubusercontent.com/trailofbits/skills/f0dd11d2b1da17a1ff8c403741fbe1f6bca0f871/plugins/trailmark/skills/trailmark-finding-triage/scripts/evidence_packet.py

    Supports: whySelected, limitations, access.permissions, install.prerequisites

  3. trailmark plugin README ↗Checked

    https://raw.githubusercontent.com/trailofbits/skills/f0dd11d2b1da17a1ff8c403741fbe1f6bca0f871/plugins/trailmark/README.md

    Supports: install.prerequisites, install.steps

  4. https://raw.githubusercontent.com/trailofbits/skills/f0dd11d2b1da17a1ff8c403741fbe1f6bca0f871/plugins/trailmark/agents/code-slice-worker.md

    Supports: compatibility

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

    Supports: install.steps, license

  6. https://raw.githubusercontent.com/trailofbits/skills/f0dd11d2b1da17a1ff8c403741fbe1f6bca0f871/LICENSE

    Supports: license

Evidence & Ask