CODE CORRECTNESS / Trail of Bits
Trail of Bits Dimensional Analysis
Coordinates unit discovery, source annotations and arithmetic review, with a manifest recording which files were validated or blocked.
“Annotates codebases with dimensional analysis comments documenting units, dimensions, and decimal scaling.”
01 / THE REASONING
Why this made the selection.
- Tracks semantic units separately from decimal scaling across arithmetic and function boundaries.
- Preserves blocked files and refuted candidates in the coverage/reporting process instead of silently dropping them.
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/dimensional-analysis/skills/dimensional-analysis/SKILL.md
- plugins/dimensional-analysis/skills/dimensional-analysis/references/dimension-algebra.md
- plugins/dimensional-analysis/agents/dimension-validator.md
- plugins/dimensional-analysis/README.md
- README.md
- LICENSE
- plugins/dimensional-analysis/agents/arithmetic-scanner.md
Our findings
- The controller separates scanning, vocabulary discovery, annotation, propagation and validation into named agent roles.
- DIMENSIONAL_SCOPE.json carries per-file outcomes, reasons and retry counts; unprocessed files must agree with the final report.
- The algebra reference checks unit compatibility and scaling, while the validator checks assignments, return paths and cross-module assumptions.
- The scanner inventories source before pattern scoring, paginates searches and avoids blanket lib exclusions; the controller preserves blocked reasons/retries and separates discovery focus from total processing scope.
Not established by this review
- No skill installation, consuming-agent workflow or external service operation was executed.
- Source inspection does not establish runtime compatibility, security certification or workload performance.
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.
- Install the complete dimensional-analysis plugin from the Trail of Bits marketplace in a host that supports its delegated agents.
- Work in a reviewable checkout and agree the arithmetic scope; expect source-comment changes plus DIMENSIONAL_UNITS.md and DIMENSIONAL_SCOPE.json.
- Inspect both the annotation diff and coverage manifest. Independently confirm important arithmetic findings with project tests or calculations.
- Retain scanner and specialist dependencies, inspect source-inventory exclusions and verify per-file annotation, propagation and validation states before reporting completion.
Before you start
- Compatible plugin host with delegation and file editing
- An arithmetic-heavy source tree with permission to annotate it
04 / FOLLOW THE EVIDENCE
The source trail.
Our notes are separate from the original resource.
Check upstream before adopting a new version.
https://github.com/trailofbits/skills/blob/8e54050ae63c2f62224c35b1616efe71865b4777/plugins/dimensional-analysis/skills/dimensional-analysis/SKILL.md
Supports: summary, upstreamDescription, whySelected, bestFor, limitations, review, install, compatibility, access
https://github.com/trailofbits/skills/blob/8e54050ae63c2f62224c35b1616efe71865b4777/plugins/dimensional-analysis/skills/dimensional-analysis/references/dimension-algebra.md
Supports: review, install, limitations, access
https://github.com/trailofbits/skills/blob/8e54050ae63c2f62224c35b1616efe71865b4777/plugins/dimensional-analysis/agents/dimension-validator.md
Supports: review, install, limitations, access
https://github.com/trailofbits/skills/blob/8e54050ae63c2f62224c35b1616efe71865b4777/plugins/dimensional-analysis/README.md
Supports: review, install, limitations, access
https://github.com/trailofbits/skills/blob/8e54050ae63c2f62224c35b1616efe71865b4777/README.md
Supports: review, install, limitations, access
- Inspected source: LICENSE ↗Checked
https://github.com/trailofbits/skills/blob/8e54050ae63c2f62224c35b1616efe71865b4777/LICENSE
Supports: license
https://github.com/trailofbits/skills/blob/8e54050ae63c2f62224c35b1616efe71865b4777/plugins/dimensional-analysis/agents/arithmetic-scanner.md
Supports: review, install, limitations, access