Dimensional Analysis Skill

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

This skill runs in one mode only: full-auto. This is a workflow-based skill that delegates step-specific work to specialized agents via the Task tool. You orchestrate the overall process, manage coverage and state persistence, and ensure that every in-scope file is processed through each step of the pipeline.

• Always run the full pipeline in this order: Step 1 -> Step 2 -> Step 3 -> Step 4.
• The main skill context must not perform repository-wide dimensional analysis, annotation, propagation, or bug validation itself when a dedicated subagent exists for that step.
• The main skill context may inspect artifacts, manifests, and subagent outputs only as needed to route work, build prompts, persist state, and determine completion.
• Any mode argument provided by the caller is ignored.
• Report all results at the end in a single summary.

When you start a step, report it:

Starting Step: Step {n}

Scope and Coverage Guarantees

This skill must audit all in-scope arithmetic files, including large repositories.

• In-scope files are defined by Step 1 scanner output (files array), across all priority tiers (CRITICAL, HIGH, MEDIUM, LOW).
• If Step 1 narrows inputs for vocabulary discovery (for example, CRITICAL/HIGH only), that narrowing applies to discovery only. It never reduces annotation or validation scope.