← Explore all skills

SECURITY REVIEW / Trail of Bits

Trailmark Review Gate

Runs a Trailmark structural gate over a branch, pull request, fix commit, release diff or ref range and returns PASS, WARN, FAIL or UNKNOWN for new entrypoints, lost validation, privilege-boundary drift, blast-radius growth and newly reachable sinks.

“Runs a Trailmark structural review gate over a branch, pull request, fix commit, release diff, or git ref range to detect new entrypoints, new tainted paths, removed validation or authorization calls, privilege-boundary drift, blast-radius growth, complexity growth, and newly reachable sensitive sinks. Use when reviewing a PR, branch, remediation commit, or release diff where graph-level security regressions should be checked before merge.”

01 / THE REASONING

Why this made the selection.

  • Applies PASS/WARN/FAIL/UNKNOWN gate rules over a branch, PR, fix commit, release diff or ref range, running engine.preanalysis() on both snapshots.
  • Its Requirements say never to report PASS when Trailmark failed and never to mutate the user's working branch while comparing refs.

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-review-gate/SKILL.md
  • 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 Review Gate's SKILL.md declares allowed-tools Bash, Read, Grep, Glob and Write.
  • Inputs are resolved with git diff, git show and git worktrees, following the graph-evolution snapshot workflow, without unnecessary checkouts.
  • Both snapshots run engine.preanalysis(); the Trailmark version and feature probes are recorded.
  • Every FAIL and WARN must name the exact changed nodes or paths.

Not established by this review

  • Not executed: it was not installed or run.
  • The Trailmark Review Gate 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 Review Gate 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

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/trailmark/skills/trailmark-review-gate/SKILL.md

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

  2. trailmark plugin README ↗Checked

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

    Supports: install.prerequisites, install.steps

  3. https://raw.githubusercontent.com/trailofbits/skills/8e54050ae63c2f62224c35b1616efe71865b4777/plugins/trailmark/agents/code-slice-worker.md

    Supports: compatibility

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

    Supports: install.steps, license

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

    Supports: license

Evidence & Ask