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.
“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.”
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.
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.
- `/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
04 / FOLLOW THE EVIDENCE
The source trail.
Our notes are separate from the original resource.
Check upstream before adopting a new version.
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 ↗Checked
https://raw.githubusercontent.com/trailofbits/skills/8e54050ae63c2f62224c35b1616efe71865b4777/plugins/trailmark/README.md
Supports: install.prerequisites, install.steps
https://raw.githubusercontent.com/trailofbits/skills/8e54050ae63c2f62224c35b1616efe71865b4777/plugins/trailmark/agents/code-slice-worker.md
Supports: compatibility
- trailofbits/skills README ↗Checked
https://raw.githubusercontent.com/trailofbits/skills/8e54050ae63c2f62224c35b1616efe71865b4777/README.md
Supports: install.steps, license
- trailofbits/skills LICENSE ↗Checked
https://raw.githubusercontent.com/trailofbits/skills/8e54050ae63c2f62224c35b1616efe71865b4777/LICENSE
Supports: license