---
title: "Trail of Bits Dimensional Analysis: review, setup & limitations · Undominated.ai"
canonical: https://undominated.ai/skills/trailofbits-dimensional-analysis/
description: "Coordinates unit discovery, source annotations and arithmetic review, with a manifest recording which files were validated or blocked."
---

# Trail of Bits Dimensional Analysis: review, setup & limitations · Undominated.ai

> Coordinates unit discovery, source annotations and arithmetic review, with a manifest recording which files were validated or blocked.

[← Explore all skills](/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.

 [See setup guidance ↓](#setup)[Original source ↗](https://github.com/trailofbits/skills/tree/8e54050ae63c2f62224c35b1616efe71865b4777/plugins/dimensional-analysis/skills/dimensional-analysis)

SOURCE REVIEW

 Reviewed 2026-10-14
 Evidence 7 linked sources
 Publisher Trail of Bits
 Licence [CC-BY-SA-4.0 ↗](https://github.com/trailofbits/skills/blob/8e54050ae63c2f62224c35b1616efe71865b4777/LICENSE)
 Revision 8e54050ae63c
 [Read what was—and wasn’t—checked ↓](#review)

“Annotates codebases with dimensional analysis comments documenting units, dimensions, and decimal scaling.”

 [Trail of Bits · upstream description ↗](https://github.com/trailofbits/skills/blob/8e54050ae63c2f62224c35b1616efe71865b4777/plugins/dimensional-analysis/skills/dimensional-analysis/SKILL.md) Our analysis follows below.

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.

### A good fit for

 - Reviewing fixed-point conversions across mixed-precision modules
- Adding explicit units and scale comments to an arithmetic-heavy codebase
- Track dimensional annotation and validation coverage across a defined arithmetic-file inventory.

### Weigh up before choosing

 - The workflow edits source comments and writes root-level manifests; it is not a read-only spot check.
- It requires specialised delegated agents and runs the full workflow; installing only SKILL.md omits those agents.
- Inferred units and severity judgements remain model-generated review output, not a proof, measured exploit or correctness guarantee.
- Coverage is relative to scanner patterns and exclusions, not proof every numeric bug was found. Specialized subagents and root-level manifest/vocabulary files are required; a single skill directory is not a complete orchestrator bundle.

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 ↗](https://github.com/trailofbits/skills/blob/8e54050ae63c2f62224c35b1616efe71865b4777/README.md)
 - 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

### Compatibility

Claude Code or Codex plugin host with the required tools

### Read source and write dimensional comments

 - Read source and write dimensional comments
- Create unit and scope manifests at the project root
- Delegate analysis and validation across specialised agents
- Reads arithmetic code, dispatches subagents and writes source comments plus DIMENSIONAL_SCOPE.json and DIMENSIONAL_UNITS.md.

### Cost model

The CC-BY-SA-4.0 plugin has no bundled service; repository-wide delegation can consume substantial agent usage.

04 / FOLLOW THE EVIDENCE

## The source trail.

Our notes are separate from the original resource. Check upstream before adopting a new version.

 - [Skill definition at reviewed revision ↗](https://github.com/trailofbits/skills/blob/8e54050ae63c2f62224c35b1616efe71865b4777/plugins/dimensional-analysis/skills/dimensional-analysis/SKILL.md) Checked 2026-10-14 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
- [Inspected source: plugins/dimensional-analysis/skills/dimensional-analysis/references/dimension-algebra.md ↗](https://github.com/trailofbits/skills/blob/8e54050ae63c2f62224c35b1616efe71865b4777/plugins/dimensional-analysis/skills/dimensional-analysis/references/dimension-algebra.md) Checked 2026-10-14 https://github.com/trailofbits/skills/blob/8e54050ae63c2f62224c35b1616efe71865b4777/plugins/dimensional-analysis/skills/dimensional-analysis/references/dimension-algebra.md Supports: review, install, limitations, access
- [Inspected source: plugins/dimensional-analysis/agents/dimension-validator.md ↗](https://github.com/trailofbits/skills/blob/8e54050ae63c2f62224c35b1616efe71865b4777/plugins/dimensional-analysis/agents/dimension-validator.md) Checked 2026-10-14 https://github.com/trailofbits/skills/blob/8e54050ae63c2f62224c35b1616efe71865b4777/plugins/dimensional-analysis/agents/dimension-validator.md Supports: review, install, limitations, access
- [Inspected source: plugins/dimensional-analysis/README.md ↗](https://github.com/trailofbits/skills/blob/8e54050ae63c2f62224c35b1616efe71865b4777/plugins/dimensional-analysis/README.md) Checked 2026-10-14 https://github.com/trailofbits/skills/blob/8e54050ae63c2f62224c35b1616efe71865b4777/plugins/dimensional-analysis/README.md Supports: review, install, limitations, access
- [Inspected source: README.md ↗](https://github.com/trailofbits/skills/blob/8e54050ae63c2f62224c35b1616efe71865b4777/README.md) Checked 2026-10-14 https://github.com/trailofbits/skills/blob/8e54050ae63c2f62224c35b1616efe71865b4777/README.md Supports: review, install, limitations, access
- [Inspected source: LICENSE ↗](https://github.com/trailofbits/skills/blob/8e54050ae63c2f62224c35b1616efe71865b4777/LICENSE) Checked 2026-10-14 https://github.com/trailofbits/skills/blob/8e54050ae63c2f62224c35b1616efe71865b4777/LICENSE Supports: license
- [Pinned plugins/dimensional-analysis/agents/arithmetic-scanner.md ↗](https://github.com/trailofbits/skills/blob/8e54050ae63c2f62224c35b1616efe71865b4777/plugins/dimensional-analysis/agents/arithmetic-scanner.md) Checked 2026-10-14 https://github.com/trailofbits/skills/blob/8e54050ae63c2f62224c35b1616efe71865b4777/plugins/dimensional-analysis/agents/arithmetic-scanner.md Supports: review, install, limitations, access

KEEP COMPARING

## Other approaches to consider.

Related by category or shared topics. These are alternatives to inspect, not a measured quality order.

 [### Undominated · Agent consensus cost audit ↗ Audits token costs and accuracy ROI of multi-agent consensus, majority voting, and debate protocols.](/skills/undominated-agent-consensus-cost-audit/)[### Undominated · Cache multiplier ↗ Keep a cache figure that is a multiplier distinct from an absolute rate.](/skills/undominated-cache-multiplier/)[### Undominated · Do not scale the invoice unit ↗ Refuse a scale factor or a restated invoice unit. A per-thousand row is not turned into a per-million row by multiplying. Amounts are not read.](/skills/undominated-unit-not-scaled/)

 [AI Tools ↗](/tools/)[Skills ↗](/skills/)[Agents ↗](/agents/)[MCP Servers ↗](/mcp-servers/)[Workflows ↗](/workflows/)

## Continue your investigation

 - [Choose a toolkit](/tools/)
- [Inspect execution hosts](/agents/)
- [Check tool access](/mcp-servers/)
- [Check project dependencies](/check-repo/)
