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

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

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.

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 ↗
  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 Variant Neighborhood 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-variant-neighborhood/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