---
title: "Graph Evolution: review, setup & limitations · Undominated.ai"
canonical: https://undominated.ai/skills/trailofbits-trailmark-graph-evolution/
description: "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."
---

# Graph Evolution: review, setup & limitations · Undominated.ai

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

[← Explore all skills](/skills/)

SECURITY REVIEW / Trail of Bits

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

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

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)

“Compares Trailmark code graphs at two source code snapshots (git commits, tags, or directories) to surface security-relevant structural changes. Detects new attack paths, complexity shifts, blast radius growth, taint propagation changes, and privilege boundary modifications that text diffs miss. Use when comparing code between commits or tags, analyzing structural evolution, detecting attack surface growth, reviewing what changed between audit snapshots, or finding security-relevant changes that text diffs miss.”

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

01 / THE REASONING

## Why this made the selection.

 - Diffs Trailmark graphs at two snapshots (commits, tags or directories) to surface new attack paths, blast-radius growth, taint and privilege-boundary changes.
- Warns that `trailmark diff` defaults --language to python and exits 0 with empty arrays on other targets, so it says to pass --language explicitly before concluding nothing changed.

### A good fit for

 - Compare two commits or tags for new attack paths a text diff misses
- Review what changed structurally between two audit snapshots
- Detect blast-radius or privilege-boundary growth across a release

### Weigh up before choosing

 - An empty `trailmark diff` can mean the wrong language rather than no change, because --language defaults to python; the skill says to pass it explicitly and re-run.
- It creates two git worktrees in mktemp directories and removes them after the report; a two-directory comparison skips that phase.
- If either diff command fails or writes an empty JSON file, it stops and reports the error.
- Installs with the whole `trailmark` plugin — and the Trailmark CLI via `uv tool install trailmark` — not as a standalone Graph Evolution skill.
- Last commit touching plugins/trailmark/skills/graph-evolution 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/graph-evolution/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

 - Graph Evolution's SKILL.md frontmatter declares no allowed-tools.
- Phase 3 runs both `trailmark diff --json` and the bundled scripts/graph_diff.py for subgraph membership changes.
- Graph Evolution's Prerequisites tell the agent to run `uv tool install trailmark` if `uv run trailmark` fails, and not to compare snapshots by hand.
- The report is written to GRAPH_EVOLUTION_*.md.

### Not established by this review

 - Not executed: it was not installed or run.
- The Graph Evolution 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 Graph Evolution 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 Trailmark and graph_diff.py across two git snapshots

 - Graph Evolution declares no allowed-tools, so tool use follows the host's settings
- If `uv run trailmark` fails, install the Trailmark CLI with `uv tool install trailmark` before comparing snapshots
- Create and later remove git worktrees for the two refs in mktemp directories
- Run `trailmark diff` and the bundled scripts/graph_diff.py, writing diff JSON to a work directory and a GRAPH_EVOLUTION_*.md report

### Cost model

CC-BY-SA-4.0. The Graph Evolution 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.

 - [Graph Evolution SKILL.md ↗](https://raw.githubusercontent.com/trailofbits/skills/8e54050ae63c2f62224c35b1616efe71865b4777/plugins/trailmark/skills/graph-evolution/SKILL.md) Checked 2026-10-22 https://raw.githubusercontent.com/trailofbits/skills/8e54050ae63c2f62224c35b1616efe71865b4777/plugins/trailmark/skills/graph-evolution/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.

 [### 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/)[### 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 Review Gate ↗ Runs a Trailmark structural gate over a branch, pull request, fix commit, release diff or ref range and returns PASS, WARN, FAIL or UNKNOWN for new entrypoints, lost validation, privilege-boundary drift, blast-radius growth and newly reachable sinks.](/skills/trailofbits-trailmark-review-gate/)

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