← Explore all 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.

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

Upstream setup instructions ↗
  1. `/plugin marketplace add trailofbits/skills` (repository README) adds the whole Trail of Bits marketplace, not one skill.
  2. 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.
  3. `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.

  1. https://raw.githubusercontent.com/trailofbits/skills/8e54050ae63c2f62224c35b1616efe71865b4777/plugins/trailmark/skills/trailmark-structural/SKILL.md

    Supports: upstreamDescription, summary, whySelected, bestFor, limitations, access, review.findings

  2. trailmark plugin README ↗Checked

    https://raw.githubusercontent.com/trailofbits/skills/8e54050ae63c2f62224c35b1616efe71865b4777/plugins/trailmark/README.md

    Supports: install.prerequisites, install.steps

  3. https://raw.githubusercontent.com/trailofbits/skills/8e54050ae63c2f62224c35b1616efe71865b4777/plugins/trailmark/agents/code-slice-worker.md

    Supports: compatibility

  4. https://raw.githubusercontent.com/trailofbits/skills/8e54050ae63c2f62224c35b1616efe71865b4777/README.md

    Supports: install.steps, license

  5. https://raw.githubusercontent.com/trailofbits/skills/8e54050ae63c2f62224c35b1616efe71865b4777/LICENSE

    Supports: license

Evidence & Ask