model-equivariance-auditor

Audit neural networks for equivariance under specified symmetry groups.

16|Updated Dec 28, 2025
One-click install
npx skills add https://github.com/Hongyu-yu/matsci-ai-skills --skill model-equivariance-auditor-hongyu-yu
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: model-equivariance-auditor
Source: https://github.com/Hongyu-yu/matsci-ai-skills/tree/main/skills/model-equivariance-auditor
Command: npx skills add https://github.com/Hongyu-yu/matsci-ai-skills --skill model-equivariance-auditor-hongyu-yu

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps verify that a neural network implementation respects the intended symmetries by providing systematic audits and debugging guidance.

Core Features & Use Cases

  • End-to-end equivariance testing to validate model outputs under symmetry transformations.
  • Layer-wise probing to pinpoint where equivariance may be broken and guide fixes.
  • Gradient-equivariance checks to ensure training dynamics preserve symmetry.
  • Comprehensive audit reports with structured outputs and actionable recommendations.

Quick Start

Run the equivariance audit on your model to generate a diagnostic report.

Frequently Asked Questions about model-equivariance-auditor

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

FAQPage Schema
How do I test if my neural network is equivariant to SO3 or SE3 transformations?

You can test neural network equivariance by applying specified symmetry group transforms to inputs and measuring output deviations. This skill automates end-to-end equivariance testing across common symmetry groups like SO3, SE3, and permutation, generating structured diagnostic reports.

Why does my model break equivariance and how can I pinpoint the broken layer?

To pinpoint broken equivariance, use layer-wise probing to measure symmetry deviations at each layer. This skill provides layer-wise analysis to identify exactly where equivariance is broken in your neural network and offers actionable recommendations to guide fixes.

Can I audit gradient equivariance to ensure training dynamics preserve symmetry?

Yes, you can audit gradient equivariance to verify that training dynamics preserve symmetry. This skill performs gradient-equivariance checks to ensure that gradients respect the intended symmetry groups during model training, producing automated diagnostic reports.

What is the best way to generate a diagnostic report for model symmetry violations?

The best way to generate a diagnostic report for model symmetry violations is to run an automated equivariance audit. This skill computes absolute and relative error metrics across symmetry transforms and produces a structured audit report with actionable debugging recommendations.

Does equivariance testing work for permutation symmetries or only geometric rotations?

Equivariance testing works for both geometric rotations and permutation symmetries. This skill supports auditing neural networks with respect to common symmetry groups including SO3, SE3, and permutation transformations, covering both geometric and discrete symmetries.

What do I need to set up before running an equivariance audit on my model?

To run an equivariance audit, you need a test harness capable of applying input and output transforms and computing error metrics. This skill requires a test harness setup that can apply symmetry group transforms and collect results for automated report generation.