validators

Document Scene Optimizer validator invocation on USD stages via omni.asset_validator.

31|4|Updated May 21, 2026
One-click install
npx skills add https://github.com/NVIDIA-Omniverse/usd-optimize --skill validators-nvidia-omniverse
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: validators
Source: https://github.com/NVIDIA-Omniverse/usd-optimize/tree/main/.agents/skills/validators
Command: npx skills add https://github.com/NVIDIA-Omniverse/usd-optimize --skill validators-nvidia-omniverse

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you understand and correctly use Scene Optimizer’s asset-validator performance rules for USD stages, including setup, rule selection, logging outputs, caching behavior, and common environment pitfalls.

Core Features & Use Cases

  • Reference validator infrastructure: Explains rule families, plugin registration, CLI invocation via omni_asset_validate, and programmatic invocation via register_all() and ValidationEngine().validate(stage).
  • Performance-aware behavior: Documents the analysis-result cache lifetime and the REQUIRES_MESH short-circuit that skips mesh-only checks on mesh-less stages.
  • Troubleshooting for libusd/pxr mismatches: Details how dual-libusd situations can break validator stage caching and how to align PYTHONPATH and LD_LIBRARY_PATH to prevent it.

Quick Start

Tell the system to run the performance validator workflow for an asset using the run-validators path, then interpret the produced report.

Frequently Asked Questions about validators

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

FAQPage Schema
How do I run performance validators on USD stages?

Run performance validators on USD stages using the omni_asset_validate CLI or programmatically via register_all() and ValidationEngine().validate(stage) to execute Scene Optimizer rules.

Why does USD validator stage caching break during performance profiling?

USD validator stage caching breaks when a dual-libusd environment causes pxr module mismatches. Align PYTHONPATH and LD_LIBRARY_PATH to ensure libusd compatibility and restore proper cache lifetime.

What logging formats does the USD asset validator support for performance reports?

The USD asset validator outputs performance profiling reports to supported logging sinks including CSV, JSON, and standard log formats for downstream analysis and troubleshooting.

Does the USD performance validator skip checks on stages without meshes?

Yes, the USD performance validator uses a REQUIRES_MESH short-circuit to automatically skip mesh-only checks on mesh-less stages, optimizing analysis-mode caching semantics and validation speed.

Do I need to configure plugin allow-listing to use USD asset validators?

Yes, you must configure entry-point isolation allow-listing for plugin registration to ensure correct validator discovery and execution when using pip-installed consumer workflows or developer integrations.