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.
- `/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 Summary 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
04 / FOLLOW THE EVIDENCE
The source trail.
Our notes are separate from the original resource.
Check upstream before adopting a new version.
- Trailmark Summary SKILL.md ↗Checked
https://raw.githubusercontent.com/trailofbits/skills/8e54050ae63c2f62224c35b1616efe71865b4777/plugins/trailmark/skills/trailmark-summary/SKILL.md
Supports: upstreamDescription, summary, whySelected, bestFor, limitations, access, review.findings
- trailmark plugin README ↗Checked
https://raw.githubusercontent.com/trailofbits/skills/8e54050ae63c2f62224c35b1616efe71865b4777/plugins/trailmark/README.md
Supports: install.prerequisites, install.steps
https://raw.githubusercontent.com/trailofbits/skills/8e54050ae63c2f62224c35b1616efe71865b4777/plugins/trailmark/agents/code-slice-worker.md
Supports: compatibility
- trailofbits/skills README ↗Checked
https://raw.githubusercontent.com/trailofbits/skills/8e54050ae63c2f62224c35b1616efe71865b4777/README.md
Supports: install.steps, license
- trailofbits/skills LICENSE ↗Checked
https://raw.githubusercontent.com/trailofbits/skills/8e54050ae63c2f62224c35b1616efe71865b4777/LICENSE
Supports: license