trailmark-review-gate
An agent skill by trailofbits, from trailofbits/skills. Tags: analysis, code-review, security, trailmark.
What it does
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.
Install
With the skills CLI, which installs into Claude Code, Codex, Cursor and other agents:
npx skills add trailofbits/skills --skill trailmark-review-gate
Or copy the skill folder into Claude Code's skills directory by hand (~/.claude/skills for every project, or .claude/skills inside one):
git clone --depth 1 https://github.com/trailofbits/skills
cp -r skills/plugins/trailmark/skills/trailmark-review-gate ~/.claude/skills/trailmark-review-gate
Safety box score
Grade A, minimal risk: 7 of 100 risk points, rated 2026-10-20. The grade rates what the skill and its scripts can reach on the machine of whoever installs it, across eight categories from shell execution to secrets access. How the score works.
This skill is a git-based structural review workflow: it runs Trailmark graph comparisons over before/after refs and emits a review packet. Its main risk is limited shell execution inside the repo context, plus dependence on external Trailmark tooling that is not shipped here; it does not itself contain networked, secret-handling, or destructive actions.
| Category | Level | Why |
|---|---|---|
| Code & shell execution | 1 (low) | It explicitly tells the agent to run shell-based repo commands like `git diff`, `git show`, `git worktrees`, and `graph-evolution`, but the scope is bounded to analysis of refs and review evidence. |
| Network access | 0 (none) | The files do not instruct downloads, uploads, API calls, or any other remote communication. |
| Filesystem reach | 1 (low) | It can read and write review artifacts and use git worktrees, but it says `Never mutate the user's working branch while comparing refs` and otherwise stays within the repository context. |
| Secrets & credentials | 0 (none) | There is no instruction to read tokens, key files, `.env` files, browser sessions, or other credential stores. |
| Privilege & persistence | 0 (none) | No sudo, global install, service registration, shell startup edits, or OS-level configuration changes are requested. |
| Instruction hijack surface | 0 (none) | The text does not tell the agent to ignore higher-level instructions, hide actions, or follow fetched remote instructions. |
| Irreversible actions | 0 (none) | It is review-only and explicitly says `Do not use GitHub write actions unless the review process explicitly asks for them`. |
| Transparency | 0 (none) | The shipped files are readable markdown/YAML/SVG; there are no binaries, encoded blobs, or installer stubs. |
Before installing
- Verify the `graph-evolution`/Trailmark toolchain you expect to use is the one you trust, since it is referenced but not shipped here.
- Run it first on a scratch clone or throwaway branch to confirm it only reads refs and writes review artifacts.
- Check that your review process does not grant unnecessary GitHub write permissions, since the skill says not to use write actions unless explicitly requested.
Rated 2026-10-20 by an automated review of 6 files from the skill's repository.
Source
- Repository
- trailofbits/skills (all skills from this repository)
- Path
- plugins/trailmark/skills/trailmark-review-gate/SKILL.md
- Branch
- main
- Collection
- trailmark
- Updated
- 2026-09-19
Related skills
- audit-augmentation — Augments Trailmark code graphs with external audit findings from SARIF static analysis results, weAudit annotation files.
- graph-evolution — Compares Trailmark code graphs at two source code snapshots (git commits, tags, or directories) to surface security-relevant structural changes.
- trailmark — Builds and queries multi-language source and binary code graphs for security analysis.
- trailmark-finding-triage — Performs graph-assisted triage of a single security finding, SARIF result, weAudit annotation, suspicious function.
- trailmark-structural — Runs full Trailmark structural analysis by building a graph, running `preanalysis()`, and reporting hotspots, taint, blast radius, privilege boundaries.
- trailmark-variant-neighborhood — Expands one confirmed or suspected vulnerability into a Trailmark graph neighborhood of variant candidates by finding sibling functions.