← Explore all skills

SECURITY REVIEW / Trail of Bits

Trailmark Summary

Runs a Trailmark summary over a codebase and returns the auto-detected languages, an entry-point count and a dependency list as a quick structural overview.

“Runs a Trailmark summary analysis on a codebase. Returns auto-detected languages, entry point count, and dependency list. Use when vivisect or galvanize needs a quick structural overview. Triggers: trailmark summary, code summary, structural overview.”

01 / THE REASONING

Why this made the selection.

  • Returns auto-detected languages, an entry-point count and a dependency list, and reports a gap rather than fabricate any of the three.
  • Is a v0.2-safe workflow that does not require Trailmark 0.4.0 and records the version only if the installed build supports it.

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-summary/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 `trailmark analyze --language auto --summary` on the target directory.
  • The output must include the detected languages, the Entrypoints: line and the Dependencies: line; a missing one is reported, not fabricated.
  • A version string is recorded only when the installed build supports --version.

Not established by this review

  • Not executed: it was not installed or run.
  • The Trailmark Summary 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 Summary 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-summary/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