---
title: "Trailmark: review, setup & limitations · Undominated.ai"
canonical: https://undominated.ai/skills/trailofbits-trailmark/
description: "Parses a codebase into a queryable graph of functions, classes and calls and runs pre-analysis passes for blast radius, taint, privilege boundaries and entry points, so later trailmark skills can ask structural questions instead of reading files."
---

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

> Parses a codebase into a queryable graph of functions, classes and calls and runs pre-analysis passes for blast radius, taint, privilege boundaries and entry points, so later trailmark skills can ask structural questions instead of reading files.

[← Explore all skills](/skills/)

SECURITY REVIEW / Trail of Bits

# Trailmark

Parses a codebase into a queryable graph of functions, classes and calls and runs pre-analysis passes for blast radius, taint, privilege boundaries and entry points, so later trailmark skills can ask structural questions instead of reading files.

 [See setup guidance ↓](#setup)[Original source ↗](https://github.com/trailofbits/skills/tree/f0dd11d2b1da17a1ff8c403741fbe1f6bca0f871/plugins/trailmark/skills/trailmark)

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/f0dd11d2b1da17a1ff8c403741fbe1f6bca0f871/LICENSE)
 Revision f0dd11d2b1da
 [Read what was—and wasn’t—checked ↓](#review)

“Builds and queries multi-language source and binary code graphs for security analysis. Includes pre-analysis passes for blast radius, taint propagation, privilege boundaries, entry point enumeration, proxy/unresolved-call tracking, type/reference queries, structural traversal, graph diffs, audit augmentation, declared cross-language/FFI/external links via `.trailmark/links.toml`, and SQL schema graphs. Use when analyzing call paths, mapping attack surface, finding complexity hotspots, enumerating entry points, tracing taint propagation, measuring blast radius, importing SARIF/weAudit/binary findings, linking source graphs across language or RPC boundaries, or building a code graph for audit prioritization. Feature-gate version-specific Trailmark APIs before using them; prefer `trailmark.parse.detect_languages()` or `--language auto` when the target language is unknown or polyglot.”

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

01 / THE REASONING

## Why this made the selection.

 - Builds one queryable source/binary graph and runs preanalysis() for blast radius, entry points, privilege boundaries and taint, storing the results as annotations and named subgraphs.
- Tells the agent to check the installed Trailmark version, or probe with hasattr(), before using v0.4+/v0.5+ features, because many environments still run Trailmark 0.2.x.

### A good fit for

 - Map call paths and attack surface for a codebase before hunting bugs
- Enumerate entry points and measure blast radius from the built graph
- Trace taint propagation across a polyglot codebase with --language auto

### Weigh up before choosing

 - It is static analysis; the skill lists runtime behaviour analysis under When NOT to Use.
- Mutation-testing triage is left to the genotoxic skill, which calls trailmark internally.
- A `uv tool install trailmark` provides the CLI only; the skill's Python snippets run under `uv run --with trailmark python -`.
- Installs with the whole `trailmark` plugin — and the Trailmark CLI via `uv tool install trailmark` — not as a standalone Trailmark skill.
- Last commit touching plugins/trailmark/skills/trailmark at the pinned revision: 2026-10-14.
- 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/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's SKILL.md frontmatter declares no allowed-tools.
- Its Installation section is marked MANDATORY: if trailmark is not found, run `uv tool install trailmark` before anything else, and report a failed install rather than read source by hand.
- Pre-analysis must run before handing off to genotoxic; the skill says diagramming-code builds its own graph and does not use it.
- Its When to Use list includes adding LLM-inferred annotations, such as assumptions and preconditions, to code units.

### Not established by this review

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

### Installs and runs the Trailmark CLI over local source

 - Trailmark declares no allowed-tools, so tool use follows the host's settings
- Install the Trailmark CLI with `uv tool install trailmark` when it is not found
- Run the Trailmark CLI, and Python snippets under `uv run --with trailmark python -`, to parse and query local source
- Read the repository being graphed

### Cost model

CC-BY-SA-4.0. The Trailmark 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 SKILL.md ↗](https://raw.githubusercontent.com/trailofbits/skills/f0dd11d2b1da17a1ff8c403741fbe1f6bca0f871/plugins/trailmark/skills/trailmark/SKILL.md) Checked 2026-10-22 https://raw.githubusercontent.com/trailofbits/skills/f0dd11d2b1da17a1ff8c403741fbe1f6bca0f871/plugins/trailmark/skills/trailmark/SKILL.md Supports: upstreamDescription, summary, whySelected, bestFor, limitations, access, review.findings
- [trailmark plugin README ↗](https://raw.githubusercontent.com/trailofbits/skills/f0dd11d2b1da17a1ff8c403741fbe1f6bca0f871/plugins/trailmark/README.md) Checked 2026-10-22 https://raw.githubusercontent.com/trailofbits/skills/f0dd11d2b1da17a1ff8c403741fbe1f6bca0f871/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/f0dd11d2b1da17a1ff8c403741fbe1f6bca0f871/plugins/trailmark/agents/code-slice-worker.md) Checked 2026-10-22 https://raw.githubusercontent.com/trailofbits/skills/f0dd11d2b1da17a1ff8c403741fbe1f6bca0f871/plugins/trailmark/agents/code-slice-worker.md Supports: compatibility
- [trailofbits/skills README ↗](https://raw.githubusercontent.com/trailofbits/skills/f0dd11d2b1da17a1ff8c403741fbe1f6bca0f871/README.md) Checked 2026-10-22 https://raw.githubusercontent.com/trailofbits/skills/f0dd11d2b1da17a1ff8c403741fbe1f6bca0f871/README.md Supports: install.steps, license
- [trailofbits/skills LICENSE ↗](https://raw.githubusercontent.com/trailofbits/skills/f0dd11d2b1da17a1ff8c403741fbe1f6bca0f871/LICENSE) Checked 2026-10-22 https://raw.githubusercontent.com/trailofbits/skills/f0dd11d2b1da17a1ff8c403741fbe1f6bca0f871/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.

 [### Trailmark Structural Analysis ↗ Builds a Trailmark graph and runs engine.preanalysis() to report complexity hotspots, taint, blast radius, privilege boundaries and attack surface, with extra 0.4+/0.5+ fields when that Trailmark is installed.](/skills/trailofbits-trailmark-structural/)[### 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/)[### Slicing Code Context ↗ Uses Trailmark to cut a bounded, graph-informed slice of source around a function, class, caller, callee, call path, entry point or line range and hands it to a smaller worker model that may only propose edits.](/skills/trailofbits-trailmark-slicing-code-context/)

 [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/)
