dimensional-analysis

SKILL.md

Dimensional Analysis Skill

This skill orchestrates a dimensional-analysis pipeline for codebases that perform numeric computations with mixed units, precisions, or scaling factors. The main skill context is a workflow controller only: it delegates scanning, vocabulary discovery, annotation, propagation, and validation to specialized subagents, then manages batching, persistence, retries, coverage gates, and final reporting.

When to Use

Annotating a codebase with unit/dimension comments (e.g., D18{tok}, D27{UoA/tok})

Performing dimensional analysis on DeFi protocols, financial code, or scientific computations

Hunting for arithmetic bugs caused by unit mismatches, missing scaling, or precision loss

Auditing codebases with mixed decimal precisions or fixed-point arithmetic

When NOT to Use

Codebases with no numeric arithmetic or unit conversions — there is nothing to annotate

Pure integer counting logic (loop indices, array lengths) with no physical or financial dimensions

When you only need a quick spot-check of a single formula — read the code directly instead of running the full pipeline

Execution Mode