← Explore all skills

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.

Upstream setup instructions ↗
  1. Install the complete dimensional-analysis plugin from the Trail of Bits marketplace in a host that supports its delegated agents.
  2. Work in a reviewable checkout and agree the arithmetic scope; expect source-comment changes plus DIMENSIONAL_UNITS.md and DIMENSIONAL_SCOPE.json.
  3. Inspect both the annotation diff and coverage manifest. Independently confirm important arithmetic findings with project tests or calculations.
  4. 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.

  1. 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

  2. https://github.com/trailofbits/skills/blob/8e54050ae63c2f62224c35b1616efe71865b4777/plugins/dimensional-analysis/skills/dimensional-analysis/references/dimension-algebra.md

    Supports: review, install, limitations, access

  3. https://github.com/trailofbits/skills/blob/8e54050ae63c2f62224c35b1616efe71865b4777/plugins/dimensional-analysis/agents/dimension-validator.md

    Supports: review, install, limitations, access

  4. https://github.com/trailofbits/skills/blob/8e54050ae63c2f62224c35b1616efe71865b4777/plugins/dimensional-analysis/README.md

    Supports: review, install, limitations, access

  5. https://github.com/trailofbits/skills/blob/8e54050ae63c2f62224c35b1616efe71865b4777/README.md

    Supports: review, install, limitations, access

  6. https://github.com/trailofbits/skills/blob/8e54050ae63c2f62224c35b1616efe71865b4777/LICENSE

    Supports: license

  7. https://github.com/trailofbits/skills/blob/8e54050ae63c2f62224c35b1616efe71865b4777/plugins/dimensional-analysis/agents/arithmetic-scanner.md

    Supports: review, install, limitations, access

Evidence & Ask