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

inspect-asset

Inspect USD stage files and generate structured JSON inspection reports.

31|4|Updated May 21, 2026
Search Tags:#asset optimization#usd#bounding box#stage inspection#geometry stats#animation detection#preflight analysis
One-click install
npx skills add https://github.com/NVIDIA-Omniverse/usd-optimize --skill inspect-asset
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: inspect-asset
Source: https://github.com/NVIDIA-Omniverse/usd-optimize/tree/main/.agents/skills/inspect-asset
Command: npx skills add https://github.com/NVIDIA-Omniverse/usd-optimize --skill inspect-asset

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Inspecting a USD asset can be slow and error-prone when you need quick insight into stage scale, composition, and geometry before running validators or optimizations.

Core Features & Use Cases

  • Stage overview: reports file size, meters-per-unit, up-axis, and default prim presence.
  • Scene composition counts: counts total prims, per-type distribution, meshes, materials, instances, and skeleton roots.
  • Geometry statistics: computes total vertex and face counts across all mesh prims.
  • Animation hint: detects whether time-sampled attributes appear (sample-capped scan for speed).
  • Bounding box: calculates an aligned world-space bounding box for default/render purposes.
  • Use case: before optimizing or running operations, quickly determine whether the asset has meshes, is animated, uses instancing heavily, and roughly how large it is.

Quick Start

Use the inspect-asset skill with the full path to your USD file to get a structured JSON report and a readable summary of stage scale and key counts.

Frequently Asked Questions about inspect-asset

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

FAQPage Schema
How do I get a quick USD stage inspection report before running validators?▼

Inspecting a USD stage file extracts metadata, prim counts, mesh geometry totals, and a computed aligned bounding box into a structured JSON payload. This provides fast, non-destructive insight for preflight workflows before running validators or optimizations.

What geometry stats and scene composition details can I extract from a USD file?▼

Extracting geometry stats from a USD file yields total vertex and face counts, per-type prim distribution, instancing counts, skeleton roots, and material-binding presence. A sample-capped scan also detects time-sampled animation hints for rapid scene composition analysis.

Do I need Python pxr bindings to inspect USD asset metadata and bounding boxes?▼

Yes, a Python environment with the pxr bindings available is required to inspect USD asset metadata and bounding boxes. You must also provide a valid USD path to generate the structured JSON report with stage scale and composition details.

Can I detect animation hints in a USD stage without loading the full timeline?▼

Yes, detecting animation hints in a USD stage is done via a sample-capped scan for time-sampled attributes. This method avoids loading the full timeline, providing a fast, non-destructive check to determine if the asset is animated before deeper analysis.

Does USD preflight analysis calculate world-space bounding box for default and render purposes?▼

Yes, USD preflight analysis calculates an aligned world-space bounding box for default and render purposes. This computation helps determine the rough scale of the asset alongside stage metadata before running optimization operations or parameter tuning.

Related Skills

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

print-usd

Print USD scene hierarchy and prim metadata from readable input files.

Official
Intermediate
memectmemect
13

entity-extraction

Extract domain-specific entities from documents using regex and LLM methods.

Community
Advanced
NVIDIA-OmniverseNVIDIA-Omniverse
31

create-proxy

Generate USD proxy siblings with decimated meshes or bounding boxes and wire render/proxy purposes.

Official
Advanced
NVIDIA-OmniverseNVIDIA-Omniverse
31

deduplicate-hierarchies

Collapse duplicate USD prim hierarchies into internal instanceable references.

Official
Intermediate