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

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

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

[← Explore all skills](/skills/)

SECURITY REVIEW / Trail of Bits

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

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

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 full Trailmark structural analysis by building a graph, running `preanalysis()`, and reporting hotspots, taint, blast radius, privilege boundaries, attack surface, and version-gated Trailmark 0.4+/0.5+ data such as proxy counts, subgraph edges, type/reference summaries, and entrypoint attributes. Use when vivisect needs detailed structural data for a target. Triggers: structural analysis, blast radius, taint analysis, complexity hotspots, proxy nodes, type references.”

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

01 / THE REASONING

## Why this made the selection.

 - Builds a graph and runs engine.preanalysis() for hotspots, taint, blast radius, privilege boundaries and attack surface, enriched by 0.4+/0.5+ data when present.
- Probes v0.4-only methods with hasattr() because users may still have Trailmark 0.2.x installed.

### A good fit for

 - Produce full structural data: hotspots, taint, blast radius, privilege boundaries and attack surface
- Feed vivisect detailed pre-analysis output
- Read 0.4+/0.5+ proxy counts and type/reference summaries when that Trailmark is installed

### Weigh up before choosing

 - Trailmark Structural Analysis's SKILL.md declares allowed-tools Bash, Read, Grep and Glob, with no Write.
- If trailmark is missing it reports "trailmark is not installed" and returns, without running any install command.
- Its Python snippets fall back to `uv run --with trailmark python -`, which resolves the trailmark package through uv.
- v0.4+/0.5+ fields appear only when that Trailmark is installed; it probes with hasattr() before using them.
- Installs with the whole `trailmark` plugin, not as a standalone Trailmark Structural Analysis skill; the user installs the Trailmark CLI (`uv tool install trailmark`).
- Last commit touching plugins/trailmark/skills/trailmark-structural 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-structural/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

 - It runs all four pre-analysis passes through engine.preanalysis().
- The JSON payload includes languages, summary, preanalysis, hotspots, proxy_nodes and subgraphs; empty subgraphs are normal.
- On Trailmark 0.5.0+, attack_surface entries may carry an attributes object, which is passed through unchanged.

### Not established by this review

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

### Runs Trailmark structural analysis over a target directory

 - Trailmark Structural Analysis declares allowed-tools Bash, Read, Grep and Glob
- Run trailmark analyze and a QueryEngine snippet with preanalysis() over the target
- Run no install command; Trailmark Structural Analysis reports a missing trailmark and returns

### Cost model

CC-BY-SA-4.0. The Trailmark Structural Analysis 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 Structural Analysis SKILL.md ↗](https://raw.githubusercontent.com/trailofbits/skills/8e54050ae63c2f62224c35b1616efe71865b4777/plugins/trailmark/skills/trailmark-structural/SKILL.md) Checked 2026-10-22 https://raw.githubusercontent.com/trailofbits/skills/8e54050ae63c2f62224c35b1616efe71865b4777/plugins/trailmark/skills/trailmark-structural/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 ↗ 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.](/skills/trailofbits-trailmark/)[### Trailmark Summary ↗ Runs a Trailmark summary over a codebase and returns the auto-detected languages, an entry-point count and a dependency list as a quick structural overview.](/skills/trailofbits-trailmark-summary/)

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