---
title: "Trailmark Review Gate: review, setup & limitations · Undominated.ai"
canonical: https://undominated.ai/skills/trailofbits-trailmark-review-gate/
description: "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."
---

# Trailmark Review Gate: review, setup & limitations · Undominated.ai

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

[← Explore all skills](/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.

 [See setup guidance ↓](#setup)[Original source ↗](https://github.com/trailofbits/skills/tree/8e54050ae63c2f62224c35b1616efe71865b4777/plugins/trailmark/skills/trailmark-review-gate)

SOURCE REVIEW

 Reviewed 2026-10-22
 Evidence 5 linked sources
 Publisher Trail of Bits
 Licence [CC-BY-SA-4.0 ↗](https://raw.githubusercontent.com/trailofbits/skills/8e54050ae63c2f62224c35b1616efe71865b4777/LICENSE)
 Revision 8e54050ae63c
 [Read what was—and wasn’t—checked ↓](#review)

“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.”

 [Trail of Bits · upstream description ↗](https://raw.githubusercontent.com/trailofbits/skills/8e54050ae63c2f62224c35b1616efe71865b4777/plugins/trailmark/skills/trailmark-review-gate/SKILL.md) Our analysis follows below.

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.

### A good fit for

 - Check a PR or branch diff for new entrypoints, removed validation and privilege-boundary drift before merge
- Gate a remediation commit on graph-level regressions
- Flag newly reachable sensitive sinks in a release diff

### Weigh up before choosing

 - Trailmark Review Gate's SKILL.md declares allowed-tools that include Write; it writes a gate packet (references/output-format.md) for the branch reviewer.
- UNKNOWN is a distinct verdict for failed Trailmark analysis or incomplete evidence; the skill says never to report PASS in that case.
- It does not replace line-level review; it produces structural evidence reviewers cite.
- Installs with the whole `trailmark` plugin — and the Trailmark CLI via `uv tool install trailmark` — not as a standalone Trailmark Review Gate skill.
- Last commit touching plugins/trailmark/skills/trailmark-review-gate at the pinned revision: 2026-09-16.
- Not executed: it was not installed or run.

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 ↗](https://raw.githubusercontent.com/trailofbits/skills/8e54050ae63c2f62224c35b1616efe71865b4777/README.md)
 - `/plugin marketplace add trailofbits/skills` (repository README) adds the whole Trail of Bits marketplace, not one skill.
- 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.
- `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

### Compatibility

Claude Code

### Builds Trailmark before/after evidence for a diff and writes a gate packet

 - Trailmark Review Gate declares allowed-tools Bash, Read, Grep, Glob and Write
- Use git diff, git show and git worktrees for before/after snapshots without mutating the working branch
- Run Trailmark before/after graph analysis, through graph-evolution or equivalent
- Write the gate packet for the branch reviewer

### Cost model

CC-BY-SA-4.0. The Trailmark Review Gate skill's files name no paid service.

04 / FOLLOW THE EVIDENCE

## The source trail.

Our notes are separate from the original resource. Check upstream before adopting a new version.

 - [Trailmark Review Gate SKILL.md ↗](https://raw.githubusercontent.com/trailofbits/skills/8e54050ae63c2f62224c35b1616efe71865b4777/plugins/trailmark/skills/trailmark-review-gate/SKILL.md) Checked 2026-10-22 https://raw.githubusercontent.com/trailofbits/skills/8e54050ae63c2f62224c35b1616efe71865b4777/plugins/trailmark/skills/trailmark-review-gate/SKILL.md Supports: upstreamDescription, summary, whySelected, bestFor, limitations, access, review.findings
- [trailmark plugin README ↗](https://raw.githubusercontent.com/trailofbits/skills/8e54050ae63c2f62224c35b1616efe71865b4777/plugins/trailmark/README.md) Checked 2026-10-22 https://raw.githubusercontent.com/trailofbits/skills/8e54050ae63c2f62224c35b1616efe71865b4777/plugins/trailmark/README.md Supports: install.prerequisites, install.steps
- [trailmark code-slice-worker agent (names Claude Code as host) ↗](https://raw.githubusercontent.com/trailofbits/skills/8e54050ae63c2f62224c35b1616efe71865b4777/plugins/trailmark/agents/code-slice-worker.md) Checked 2026-10-22 https://raw.githubusercontent.com/trailofbits/skills/8e54050ae63c2f62224c35b1616efe71865b4777/plugins/trailmark/agents/code-slice-worker.md Supports: compatibility
- [trailofbits/skills README ↗](https://raw.githubusercontent.com/trailofbits/skills/8e54050ae63c2f62224c35b1616efe71865b4777/README.md) Checked 2026-10-22 https://raw.githubusercontent.com/trailofbits/skills/8e54050ae63c2f62224c35b1616efe71865b4777/README.md Supports: install.steps, license
- [trailofbits/skills LICENSE ↗](https://raw.githubusercontent.com/trailofbits/skills/8e54050ae63c2f62224c35b1616efe71865b4777/LICENSE) Checked 2026-10-22 https://raw.githubusercontent.com/trailofbits/skills/8e54050ae63c2f62224c35b1616efe71865b4777/LICENSE Supports: license

KEEP COMPARING

## Other approaches to consider.

Related by category or shared topics. These are alternatives to inspect, not a measured quality order.

 [### Graph Evolution ↗ Diffs Trailmark code graphs built at two source snapshots (commits, tags or directories) to surface new attack paths, blast-radius growth, taint changes and privilege-boundary shifts that a text diff does not show.](/skills/trailofbits-trailmark-graph-evolution/)[### 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.](/skills/trailofbits-trailmark-finding-triage/)[### Claude Security ↗ Runs Anthropic's Claude Security scans inside a Claude Code session: a whole-repository or scoped scan, a scan of a branch, pull request or commit, and suggested fixes as patch files the user applies.](/skills/anthropic-claude-security/)

 [AI Tools ↗](/tools/)[Skills ↗](/skills/)[Agents ↗](/agents/)[MCP Servers ↗](/mcp-servers/)[Workflows ↗](/workflows/)

## Continue your investigation

 - [Choose a toolkit](/tools/)
- [Inspect execution hosts](/agents/)
- [Check tool access](/mcp-servers/)
- [Check project dependencies](/check-repo/)
