SECURITY REVIEW / Trail of Bits
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.
“Augments Trailmark code graphs with external audit findings from SARIF static analysis results, weAudit annotation files, and version-gated Trailmark 0.4.x binary-analysis graph exports. Maps findings to graph nodes by file and line overlap, creates severity-based subgraphs, and enables cross-referencing findings with pre-analysis data (blast radius, taint, etc.). Use when projecting SARIF results onto a code graph, overlaying weAudit annotations, importing binary graph findings, cross-referencing Semgrep, CodeQL, or binary-analysis findings with call graph data, or visualizing audit findings in the context of code structure.”
01 / THE REASONING
Why this made the selection.
- Maps SARIF results, weAudit annotations and v0.4 binary-analysis exports onto Trailmark graph nodes by file and line overlap and builds severity-based subgraphs.
- Cross-references findings with pre-analysis data such as blast radius and taint after running engine.preanalysis().
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/audit-augmentation/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
- Audit Augmentation's SKILL.md frontmatter declares no allowed-tools.
- Its Installation section is marked MANDATORY: if `uv run trailmark` fails, install trailmark first with `uv tool install trailmark`.
- Findings become annotations and severity subgraphs such as sarif:error and weaudit:high.
Not established by this review
- Not executed: it was not installed or run.
- The Audit Augmentation 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 Audit Augmentation 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.
https://raw.githubusercontent.com/trailofbits/skills/8e54050ae63c2f62224c35b1616efe71865b4777/plugins/trailmark/skills/audit-augmentation/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