gpd-dimensional-analysis

Audits every equation in a physics derivation for dimensional consistency and reports anomalies.

Updated Mar 18, 2026
One-click install
npx skills add https://github.com/MichaelsEngineering/sentinel-multiscale-field-dynamics --skill gpd-dimensional-analysis-michaelsengineering
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gpd-dimensional-analysis
Source: https://github.com/MichaelsEngineering/sentinel-multiscale-field-dynamics/tree/main/.agents/skills/gpd-dimensional-analysis
Command: npx skills add https://github.com/MichaelsEngineering/sentinel-multiscale-field-dynamics --skill gpd-dimensional-analysis-michaelsengineering

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Dimensional errors in multi-step physics derivations propagate silently until final results are off by orders of magnitude. This Skill performs a systematic dimensional analysis audit on every equation in a derivation, computation, or research phase, catching inconsistencies that informal checks miss. ## Core Features & Use Cases - Term-by-Term Verification: Checks that all terms in sums and both sides of equalities share identical dimensions, and that transcendental function arguments are dimensionless. - Unit System Awareness: Loads the project's convention lock (natural units, SI, CGS) from GPD project state, or establishes the unit system interactively for standalone use. - Structured Audit Report: Generates a DIMENSIONAL-ANALYSIS.md report classifying each anomaly by severity (CRITICAL, WARNING, NOTE) with location, expected versus found dimensions, and likely cause. - Use Case: After drafting phase 3 of a quantum field theory derivation, run the audit to catch a dropped factor of hbar on line 12 before it corrupts downstream results. ## Quick Start Ask the AI to run a dimensional analysis audit on phase 3 of the current derivation and report any dimensional anomalies.

Frequently Asked Questions about gpd-dimensional-analysis

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check dimensional consistency of physics equations?▼

Run the dimensional analysis audit on a phase number or file path. It identifies every equation, builds a dimensional assignments table, and verifies term-by-term that all sums, equalities, and function arguments are dimensionally consistent.

What does a dimensional analysis audit catch in derivations?▼

It catches dropped constants like hbar, wrong integration measures, non-dimensionless arguments to exp or log, incorrect delta function dimensions, and mismatched tensor indices. The report flags the first step where dimensions become inconsistent.

Does the audit support natural units and SI units?▼

Yes. It loads the unit system from the project's convention lock, supporting natural units, SI, Gaussian CGS, and others. For standalone usage it asks the user to specify the unit system and independent dimensions before analyzing.

Can I run dimensional analysis on a single file instead of a phase?▼

Yes. Pass a file path as the argument to analyze equations in that specific file, or a phase number to analyze all equations in that phase. If no argument is given, the Skill prompts for a target.

What happens when dimensional anomalies are found?▼

Each anomaly is classified by severity (CRITICAL, WARNING, or NOTE) with its location, expected versus found dimensions, and likely cause. The report suggests next steps such as debugging the anomaly or fixing obvious causes directly.