---
title: "Trailmark Variant Neighborhood: review, setup & limitations · Undominated.ai"
canonical: https://undominated.ai/skills/trailofbits-trailmark-variant-neighborhood/
description: "Expands one confirmed or suspected vulnerability into a Trailmark graph neighborhood of variant candidates — siblings, shared callers and callees, common sinks, common entrypoint paths, interface implementations and overrides — then ranks them for follow-up."
---

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

> Expands one confirmed or suspected vulnerability into a Trailmark graph neighborhood of variant candidates — siblings, shared callers and callees, common sinks, common entrypoint paths, interface implementations and overrides — then ranks them for follow-up.

[← Explore all skills](/skills/)

SECURITY REVIEW / Trail of Bits

# Trailmark Variant Neighborhood

Expands one confirmed or suspected vulnerability into a Trailmark graph neighborhood of variant candidates — siblings, shared callers and callees, common sinks, common entrypoint paths, interface implementations and overrides — then ranks them for follow-up.

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

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)

“Expands one confirmed or suspected vulnerability into a Trailmark graph neighborhood of variant candidates by finding sibling functions, shared callers and callees, common sensitive sinks, common entrypoint paths, interface implementations, override relationships, type/reference neighbors, and structurally similar nodes. Use after one issue is found to seed variant-analysis, semgrep-rule-creator, static-analysis, or manual review with graph-derived candidate locations.”

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

01 / THE REASONING

## Why this made the selection.

 - Expands one confirmed issue into a graph neighborhood of variants: shared callers and callees, sinks, entrypoint-path neighbours, interface and override siblings, and taint or boundary peers.
- Ranks the candidates and separates what to search for syntactically from what needs semantic review, naming variant-analysis, semgrep-rule-creator or static-analysis as the handoff.

### A good fit for

 - Seed variant-analysis or semgrep-rule-creator with graph-derived candidate locations after one bug is found
- Find functions that share callers or sinks with a confirmed vulnerability
- List interface implementations and overrides structurally close to a seed issue

### Weigh up before choosing

 - Trailmark Variant Neighborhood's SKILL.md declares allowed-tools that include Write; it writes a handoff packet (references/output-format.md).
- It generates review targets, not confirmed findings.
- It stops without a graph binding, when the candidate count is too high with an underspecified root cause, when Trailmark cannot analyse the language, or when the seed is only in test, generated or vendor code the user did not scope in.
- Installs with the whole `trailmark` plugin — and the Trailmark CLI via `uv tool install trailmark` — not as a standalone Trailmark Variant Neighborhood skill.
- Last commit touching plugins/trailmark/skills/trailmark-variant-neighborhood 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-variant-neighborhood/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 Variant Neighborhood's SKILL.md declares allowed-tools Bash, Read, Grep, Glob and Write.
- Expansion is bounded to avoid candidate floods.
- Step 4 separates syntactic search guidance from what needs semantic review and names the handoff skill.

### Not established by this review

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

### Expands a seed issue with Trailmark and writes a handoff packet

 - Trailmark Variant Neighborhood declares allowed-tools Bash, Read, Grep, Glob and Write
- Run Trailmark to bind the seed and expand its graph neighbourhood
- Write a ranked handoff packet of candidates, exclusions and limitations

### Cost model

CC-BY-SA-4.0. The Trailmark Variant Neighborhood 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 Variant Neighborhood SKILL.md ↗](https://raw.githubusercontent.com/trailofbits/skills/8e54050ae63c2f62224c35b1616efe71865b4777/plugins/trailmark/skills/trailmark-variant-neighborhood/SKILL.md) Checked 2026-10-22 https://raw.githubusercontent.com/trailofbits/skills/8e54050ae63c2f62224c35b1616efe71865b4777/plugins/trailmark/skills/trailmark-variant-neighborhood/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.

 [### Audit Augmentation ↗ Overlays external findings — SARIF static-analysis results, weAudit annotation files and Trailmark 0.4.x binary-analysis exports — onto a Trailmark code graph by file and line overlap and builds severity-based subgraphs.](/skills/trailofbits-trailmark-audit-augmentation/)[### 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 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/)

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