skills.rest
NVIDIA-Omniverse
NVIDIA-OmniverseOFFICIAL
Explore all skills by this author →
Website𝕏@nvidiaomniverseGitHub

compare-stages

Compare two USD stages and output before/after metric deltas.

31|4|Updated May 21, 2026
Search Tags:#usd#stage diff#optimization verification#geometry metrics#validator comparison#before after
One-click install
npx skills add https://github.com/NVIDIA-Omniverse/usd-optimize --skill compare-stages
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: compare-stages
Source: https://github.com/NVIDIA-Omniverse/usd-optimize/tree/main/.agents/skills/compare-stages
Command: npx skills add https://github.com/NVIDIA-Omniverse/usd-optimize --skill compare-stages

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Scene optimization changes large USD scenes in ways that are hard to verify by inspection, and you need a reliable before/after summary to confirm the optimization actually helped and didn’t break anything.

Core Features & Use Cases

  • Before/After Metrics: Computes a structured comparison of file size, prim counts, mesh counts, vertex/face totals, material counts, and instance counts between two USD stages.
  • Optional Validator Deltas: Diffs validator summaries (or CSV-derived totals) to show whether issues improved after optimization.
  • Optional Prim-Level Changes: Reports added/removed prim paths on request to help locate what changed in the stage structure.

Quick Start

Use compare-stages with two USD file paths to produce a before/after metrics report, optionally adding validator diffs with the --validators flag.

Frequently Asked Questions about compare-stages

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

FAQPage Schema
How do I verify USD optimization changes between two stages?▼

To verify USD optimization changes, compare before and after stages by measuring file size, prim counts, mesh counts, vertex/face totals, and material instances to ensure the optimization reduced overhead without introducing regressions.

What is a USD stage diff and how does it work?▼

A USD stage diff is a structured comparison between two USD files that reads both layers with pxr to calculate metric deltas in geometry, materials, and instances, providing a clear summary of what changed across pipeline runs.

Can I compare USD validator summaries before and after optimization?▼

Yes, you can compare saved validator summary artifacts or CSV-derived totals using the --validators flag to generate consistent rule-set reporting that shows whether validation issues improved after the stage optimization.

How do I track added or removed prim paths in a USD stage?▼

You can request prim-level change reporting to identify added or removed prim paths between two USD stages, helping you locate exactly what structural elements shifted during optimization or troubleshooting.

Does compare-stages require any external dependencies?▼

No external dependencies are required. The skill operates independently by reading both input USD layers directly with pxr to output structured metric deltas for regression-free optimization assessment.

Related Skills

Explore More Data & Analytics Skills→
NVIDIA-OmniverseNVIDIA-Omniverse
31

interpret-validators

Convert saved USD validator artifacts into tier-classified failure reports.

Official
Intermediate
rshelekhovrshelekhov

qa

Automate QA testing and structured bug fixes for web applications.

Community
Advanced
okgoogle13okgoogle13
1

project-health-checker

Run sequential diagnostic scripts and report project health summaries.

Community
Intermediate
NVIDIA-OmniverseNVIDIA-Omniverse
31

inspect-asset

Inspect USD stage files and generate structured JSON inspection reports.

Official
Basic