Generated banner for Omniverse Usd Performance Tuning
Generated logo for Omniverse Usd Performance Tuning

Omniverse Usd Performance Tuning

NVIDIAOfficialCreated by NVIDIA Omniverse

  • Skill
  • Workflow
  • Software development
  • Apache-2.0
  • Medium risk
  • Has scripts

From the author

Diagnose and optimize USD stages for slow loading, high memory, low FPS or validation; preserve asset boundaries and reuse shared definitions.
— the description by NVIDIA Omniverse

AutoGineer summary

Written by AutoGineer from the skill’s own files, not by the author

This skill provides a structured workflow for diagnosing and optimizing USD stages. It focuses on improving performance metrics like load times, memory footprint, and frame rates by identifying and optimizing unique asset definitions, reusing shared definitions, and pruning unnecessary data. The process emphasizes preserving original asset boundaries, animation, and interface requirements, ensuring that downstream applications remain functional after optimization.

What it does

  • Inspects USD stages to identify performance bottlenecks and structural inefficiencies.
  • Classifies assets into atomic, package, or aggregate structures to guide optimization.
  • Performs native USD optimization operations on disjoint scopes.
  • Publishes semantic libraries to enable efficient asset reuse.
  • Validates composition, ownership, and interface accessibility of the optimized output.
  • Profiles the final output against the original baseline to report measured improvements.

When to use it

  • When a USD stage suffers from slow loading times or high memory consumption.
  • When rendering performance (FPS) needs improvement in a production environment.
  • Before finalizing a USD assembly for downstream consumption.
  • When you need to standardize asset structures according to factory-level guidelines.

Advantages

  • Maintains asset boundaries and critical metadata during optimization.
  • Reduces scene complexity through intelligent reuse of shared definitions.
  • Provides verifiable reports on performance gains and composition integrity.
  • Supports large-scale scene optimization by processing independent definition scopes.

Usage examples

“Inspect the USD stage at /data/factory.usdc for performance issues and prepare a review workspace.”
The agent initializes the workspace, runs the inspection script, and provides a summary of candidates for optimization.
“Submit the optimization decisions for the factory stage based on the generated JSON.”
The agent processes the boundary decisions, executes the optimization operations, and generates the final optimized USD assembly.

Install

  1. Download the skill as a ZIP:

    https://autogineer.com/agent-skills/nvidia/omniverse-usd-performance-tuning/download
  2. Unzip it into the cross-client skills folder of your project:

    mkdir -p .agents/skills && unzip omniverse-usd-performance-tuning.zip -d .agents/skills

Documentation by NVIDIA Omniverse

Omniverse USD Performance Tuning

Purpose

Improve loading, memory use or rendering for the requested workload. Preserve the prim paths, appearance, placement and behavior required by downstream applications. Follow the component/subcomponent model in NVIDIA's Factory-Level USD Structuring guide. Apply the relevant parts of that model; a static asset does not need new animation or physics.

Inputs

Required: the source USD stage. When no workload is specified, use factory layout planning and visualization and record that assumption in the request/report. Explicit workload and preservation requirements take precedence. Optional: an output workspace, preservation requirements, physical error budget, existing library indexes and recorded runtime evidence. Use values from the current user request; reuse recorded values only while they remain applicable. Follow setup when no output path is supplied.

Prerequisites

Verify the selected runtime and required capabilities using setup. Keep its preflight record with the run; installation and remote access are conditional steps described there.

Instructions

  1. Inspect. Establish the workload, preservation requirements and output workspace. Set up progress and dashboard access before assessment. Verify setup and inspect the selected source configuration.

  2. Judge boundaries. Review equipment, service-system sections and architectural elements in the selected configuration, including animation and interiors. Record owners, editable interfaces, equipment categories and optional families using boundary guidance.

  3. Classify and author. Classify accepted assets children before parents. Capture or reuse the original profile before authoring. Prepare reusable definitions, materials and occurrence opinions using asset authoring.

  4. Optimize unique definitions. Run supported native operations concurrently on disjoint scopes with the recorded physical budget.

  5. Publish semantic libraries. Use one writer per category layer and remap consumer references.

  6. Check composition. Check authored ownership, references, bindings, placement, animation and interface accessibility through the written-output checks.

  7. Profile and report. Compare the final consumer with the original baseline under comparable conditions and report measured benefits, completion and operations by asset definition.

sequenceDiagram
    participant A as Agent
    participant T as USD tools
    participant W as Definition workers
    participant L as Library publisher
    participant D as Read-only progress dashboard
    Note over A,L: One compact progress state also renders text progress
    T-->>D: Recorded phase, assessment rounds, counters and decision reasons
    A->>T: Inspect original selected configuration
    T->>T: Collect cached child-to-parent summaries and repetition nominations
    T->>T: Load supplied indexes once and batch authored product clues
    T-->>A: Product review groups, member context, animation and reuse evidence
    loop Until boundaries and interiors are reviewed
        A->>A: Select asset boundaries, then identify required internal prims and properties
        A->>T: Submit boundary decisions with reviewed scope, required edits, category and optional family
        T->>T: Reuse unchanged source evidence, recompute boundary-dependent results
        opt Geometry ownership requires reconstruction
            T->>T: Regroup or native split, remap paths and reassess affected regions
        end
        T-->>A: Remaining candidates and member exceptions
    end
    T->>T: Classify selected child assets before parent assets, confirm reuse
    T->>T: Capture or reuse original baseline profile
    T->>T: Confirm accepted product identities from source and supplied indexes; reconcile complete parent-child groups
    T->>T: Skip worker inputs for confirmed groups; author remaining materials, editable prims and occurrence overrides
    T->>T: Determine merge groups on prepared interiors; preserve selected child assets and required prims
    T->>W: Read-only input USD layers for existing-library matching
    par Independent preparation jobs
        W->>W: Confirm remaining product, exact source or authorized normalized reuse; preserve occurrence placement
        W->>W: Consolidate accepted product or compatible exact/normalized leaf inputs; retain every occurrence
    end
    W-->>T: Confirmed library hits and definitions requiring optimization
    T->>W: Owned geometry prim paths in read-only input layers
    par Independent definition scopes
        W->>W: Remove small meshes when authorized; apply asset representation: reserve merge inputs or fit analytic prims; reduce, merge (native clustering if required), prune, flatten, prune
    end
    W->>L: Geometry outputs and assembly authoring outcomes
    L->>L: Share eligible static whole definitions within current category publication
    L->>L: Share remaining whole meshes; write USD reuse metadata and compact index
    L->>T: Output USD stage with rewritten references and dependencies
    T->>T: Check authored composition, ownership, animation and interfaces
    T->>T: Profile final output USD stage and report results by asset definition
    T-->>A: Measured changes, coverage and unresolved work
    T-->>D: Final verdict and report/library paths

Use the provided tools for traversal, native operations, authoring and checks; the agent supplies engineering judgments. Preserve current variant selections, authored animation, required materials and interfaces. Trust supported USD Optimize operations with valid settings and scopes. Deep geometric comparisons and whole-scene edit trials belong in development tests, not ordinary execution.

Complete when every unique definition has an executed or evidenced unchanged outcome, every asset has justified ownership and structure, and the written consumer passes composition checks. Retain native failures, unresolved judgments and missing required capabilities as incomplete work. Repeat only affected work when evidence changes.

Scope and authorization

  • Diagnosis and validation requests remain read-only. An optimization request authorizes work in a separate output workspace within its stated preservation limits.

  • Never overwrite source layers or inherited libraries without explicit authorization.

  • Reuse authorization already given. Ask only for a missing decision that changes identity, required appearance or a loss budget; explain the affected component and consequence.

  • Report only observed changes. Measure rendering before claiming higher FPS or lower GPU use.

Load only the relevant guidance

RequestRead
Validation onlySetup, then the validation section of operations
Approved operation chainSetup, operations, verification
Existing or persistent asset libraryAdd the library index requirements to the assessment
Missing standalone runtimeInstallation
Remote stageRemote access before the first open
Report from completed evidenceVerification

Use upstream package guidance for selected operation mechanics and proxy workflows. Keep large logs on disk as specified in setup.

Limitations

Convert CAD input with the source converter's workflow and NVIDIA's CAD conversion guidance. Render profiling requires NVIDIA/omniperf or the user's available profiler; USD open and traversal timings alone do not establish rendering improvements.

Troubleshooting

For unavailable imports, operations or remote assets, follow setup. For incomplete execution or failed composition checks, follow verification; retain the failed artifacts and report the missing capability or failed check.

Examples

After runtime preflight, use the verified Python interpreter from setup to inspect a stage:

python scripts/successor_assessment.py inspect --source /data/factory.usdc --workspace /data/factory-review

Review the generated candidates using boundary guidance, fill the generated decision template, then submit it:

python scripts/successor_assessment.py decide --workspace /data/factory-review --decisions /data/factory-review/decisions.json

These commands perform assessment; continue through the instructions above only when review is complete. Run from the skill directory; generated data stays in the workspace.

Output Format

Maintain live progress and editable steering throughout execution.

For end-to-end optimization, provide the written USD assembly, validated report JSON, and generated Markdown and HTML reports. State the runtime, operations actually executed, preservation and coverage results, measured changes, source-write status, and artifact paths. Diagnosis-only work may return a findings summary stating that no optimized stage was written.

Files

references/usd-validation-runner/references/validator-concepts.json

{
  "schema_version": "1.0.0",
  "$comment": "Canonical validator-concept registry for the USD performance-tuning workflow. Single binding layer between agent-facing concept names and runtime rule identity, tier, scope policy, and backing op. Curated by maintainers, not inferred. Resolution key is (package family of module, class_name): 'module' carries the current upstream path and 'module_aliases' the pre-rename paths, and the executor accepts either, so an upstream package rename does not break resolution. usd_validation_nvidia/omni.asset_validator are one family (oav); usd_optimize/omni.scene.optimizer are the other (so). Every (module, class_name) here resolves exactly against a live registry with both providers registered (usd-validation-nvidia 1.22.0 + usd-optimize 1.3.1), not hand-written. From usd-optimize 1.3 the so rules register as UsdOptimize<Name>; the bare names of 1.1.0 and earlier resolve to nothing. Category is informational. Tiers/costs are CPU-only worst-case from large-asset evidence (batch-additivity-findings.md); gpu_bound concepts relax on CUDA hosts. Governed by validator-concepts.schema.json.",
  "concepts": [
    {
      "canonical_name": "primvar_indexability",
      "display_name": "Indexed primvars",
      "role": "opportunity_detector",
      "backing_op": "optimizePrimvars",
      "tier": 2,
      "cost_class": "cheap",
      "gpu_bound": false,
      "scope_policy": "per_target_or_sample",
      "preferred_provider": "so",
      "implementations": [
        {
          "provider": "so",
          "module": "usd_optimize.validators.indexed_primvars_checker",
          "module_aliases": ["omni.scene.optimizer.validators.indexed_primvars_checker"],
          "class_name": "UsdOptimizeIndexedPrimvarChecker",
          "category": "Omni:Geometry",
          "use_for": ["performance_tuning"]
        },
        {
          "provider": "oav",
          "module": "usd_validation_nvidia.rules._geometry",
          "module_aliases": ["omni.asset_validator._geometry_checker"],
          "class_name": "IndexedPrimvarChecker",
          "category": "Geometry",
          "tier": 3,
          "use_for": ["conformance_audit"]
        }
      ],
      "notes": "Name collision: SO triage wrapper (0.3 s) vs OAV full audit (376 s). Resolve by module; SO is the perf-tuning default."
    },
    {
      "canonical_name": "primvar_unused",
      "display_name": "Unused UV/primvar sets",
      "role": "opportunity_detector",
      "backing_op": "removeUnusedUVs",
      "tier": 2,
      "cost_class": "cheap",
      "gpu_bound": false,
      "scope_policy": "per_target_or_sample",
      "preferred_provider": "so",
      "implementations": [
        {
          "provider": "so",
          "module": "usd_optimize.validators.unused_uvs_checker",
          "module_aliases": ["omni.scene.optimizer.validators.unused_uvs_checker"],
          "class_name": "UsdOptimizeUnusedUVsChecker",
          "category": "Usd:Performance",
          "use_for": ["performance_tuning"]
        },
        {
          "provider": "oav",
          "module": "usd_validation_nvidia.rules._geometry",
          "module_aliases": ["omni.asset_validator._geometry_checker"],
          "class_name": "UnusedPrimvarChecker",
          "category": "Geometry",
          "use_for": ["conformance_audit"]
        }
      ],
      "notes": "SO is UV-scoped and ties to removeUnusedUVs; OAV covers all primvars."
    },
    {
      "canonical_name": "vertex_weld",
      "display_name": "Colocated vertices",
      "role": "opportunity_detector",
      "backing_op": "meshCleanup",
      "tier": 2,
      "cost_class": "medium",
      "gpu_bound": false,
      "scope_policy": "per_target_or_sample",
      "preferred_provider": "so",
      "implementations": [
        {
          "provider": "so",
          "module": "usd_optimize.validators.colocated_vertices_checker",
          "module_aliases": ["omni.scene.optimizer.validators.colocated_vertices_checker"],
          "class_name": "UsdOptimizeColocatedVerticesChecker",
          "category": "Omni:Geometry",
          "use_for": ["performance_tuning"]
        },
        {
          "provider": "oav",
          "module": "usd_validation_nvidia.rules._geometry",
          "module_aliases": ["omni.asset_validator._geometry_checker"],
          "class_name": "WeldChecker",
          "category": "Geometry",
          "use_for": ["conformance_audit"]
        }
      ]
    },
    {
      "canonical_name": "topology_zero_area_faces",
      "display_name": "Zero-area faces",
      "role": "opportunity_detector",
      "backing_op": "meshCleanup",
      "tier": 2,
      "cost_class": "medium",
      "gpu_bound": false,
      "scope_policy": "per_target_or_sample",
      "preferred_provider": "so",
      "implementations": [
        {
          "provider": "so",
          "module": "usd_optimize.validators.zero_area_faces_checker",
          "module_aliases": ["omni.scene.optimizer.validators.zero_area_faces_checker"],
          "class_name": "UsdOptimizeZeroAreaFacesChecker",
          "category": "Omni:Geometry",
          "use_for": ["performance_tuning"]
        },
        {
          "provider": "oav",
          "module": "usd_validation_nvidia.rules._geometry",
          "module_aliases": ["omni.asset_validator._geometry_checker"],
          "class_name": "ZeroAreaFaceChecker",
          "category": "Geometry",
          "use_for": ["conformance_audit"]
        }
      ],
      "notes": "Class-name singular (OAV) vs plural (SO)."
    },
    {
      "canonical_name": "topology_manifold",
      "display_name": "Non-manifold topology",
      "role": "opportunity_detector",
      "backing_op": "meshCleanup",
      "tier": 3,
      "cost_class": "stage_dependent",
      "gpu_bound": false,
      "scope_policy": "per_target_or_sample",
      "preferred_provider": "so",
      "implementations": [
        {
          "provider": "so",
          "module": "usd_optimize.validators.nonmanifold_checker",
          "module_aliases": ["omni.scene.optimizer.validators.nonmanifold_checker"],
          "class_name": "UsdOptimizeNonManifoldChecker",
          "category": "Omni:Geometry",
          "use_for": ["performance_tuning"]
        },
        {
          "provider": "oav",
          "module": "usd_validation_nvidia.rules._geometry",
          "module_aliases": ["omni.asset_validator._geometry_checker"],
          "class_name": "ManifoldChecker",
          "category": "Geometry",
          "use_for": ["conformance_audit"]
        }
      ],
      "notes": "Skip for visualization-only targets; run only for simulation-ready intent. Inverse polarity between impls. Measure before promoting off Tier 3."
    },
    {
      "canonical_name": "normals_validity",
      "display_name": "Missing/invalid normals",
      "role": "opportunity_detector",
      "backing_op": "generateNormals",
      "tier": 3,
      "cost_class": "medium",
      "gpu_bound": false,
      "scope_policy": "per_target_or_sample",
      "preferred_provider": "so",
      "implementations": [
        {
          "provider": "so",
          "module": "usd_optimize.validators.normals_checker",
          "module_aliases": ["omni.scene.optimizer.validators.normals_checker"],
          "class_name": "UsdOptimizeNormalsChecker",
          "category": "Usd:Performance",
          "use_for": ["performance_tuning"]
        },
        {
          "provider": "oav",
          "module": "usd_validation_nvidia.rules._geometry",
          "module_aliases": ["omni.asset_validator._geometry_checker"],
          "class_name": "NormalsValidChecker",
          "category": "Geometry",
          "use_for": ["conformance_audit"]
        }
      ],
      "notes": "Run as Tier 3 only when normals quality is relevant enough to ask for a targeted check."
    },
    {
      "canonical_name": "normals_winding",
      "display_name": "Inconsistent face winding",
      "role": "opportunity_detector",
      "backing_op": "meshCleanup",
      "tier": 2,
      "cost_class": "medium",
      "gpu_bound": false,
      "scope_policy": "per_target_or_sample",
      "preferred_provider": "so",
      "implementations": [
        {
          "provider": "so",
          "module": "usd_optimize.validators.windings_checker",
          "module_aliases": ["omni.scene.optimizer.validators.windings_checker"],
          "class_name": "UsdOptimizeWindingsChecker",
          "category": "Usd:Performance",
          "use_for": ["performance_tuning"]
        },
        {
          "provider": "oav",
          "module": "usd_validation_nvidia.rules._geometry",
          "module_aliases": ["omni.asset_validator._geometry_checker"],
          "class_name": "NormalsWindingsChecker",
          "category": "Geometry",
          "use_for": ["conformance_audit"]
        }
      ]
    },
    {
      "canonical_name": "primitive_fit",
      "display_name": "Primitive-fittable meshes",
      "role": "opportunity_detector",
      "backing_op": "fitPrimitives",
      "tier": 2,
      "cost_class": "cheap",
      "gpu_bound": false,
      "scope_policy": "per_target_or_sample",
      "preferred_provider": "so",
      "implementations": [
        {
          "provider": "so",
          "module": "usd_optimize.validators.primitive_fit_checker",
          "module_aliases": ["omni.scene.optimizer.validators.primitive_fit_checker"],
          "class_name": "UsdOptimizePrimitiveFitChecker",
          "use_for": ["performance_tuning"]
        }
      ],
      "notes": "Mandatory default opportunity_detector for CAD/BIM/MEP optimization posture. Highest-value reduction for HOOPS-tessellated converted content. The detector sizes the win and does not gate the op: fitPrimitives runs at default args with a notice on piping and large-spatial targets, and prompts only on encapsulated-product or functional-precision ones. Carries no parameter_prerequisite on purpose - a tolerance question here is the ladder that talks an agent out of the fit. See operation-safety.md and the fitPrimitives entry in operations.json."
    },
    {
      "canonical_name": "geom_duplicates",
      "display_name": "Duplicate geometry (exact)",
      "role": "opportunity_detector",
      "backing_op": "deduplicateGeometry",
      "tier": 3,
      "cost_class": "stage_dependent",
      "gpu_bound": false,
      "scope_policy": "per_target_or_sample",
      "preferred_provider": "so",
      "implementations": [
        {
          "provider": "so",
          "module": "usd_optimize.validators.duplicate_geometry_checker",
          "module_aliases": ["omni.scene.optimizer.validators.duplicate_geometry_checker"],
          "class_name": "UsdOptimizeDuplicateGeometryChecker",
          "category": "Usd:Performance",
          "use_for": ["performance_tuning"]
        }
      ],
      "notes": "A few seconds on a large reference stage (hash short-circuit) but can be minutes with many similar meshes. Treat as Tier 3 default; promote to Tier 2 only after measuring on target stage."
    },
    {
      "canonical_name": "geom_duplicates_fuzzy",
      "display_name": "Duplicate geometry (fuzzy)",
      "role": "opportunity_detector",
      "backing_op": "deduplicateGeometry",
      "tier": 3,
      "cost_class": "stage_dependent",
      "gpu_bound": false,
      "scope_policy": "per_target_or_sample",
      "preferred_provider": "so",
      "implementations": [
        {
          "provider": "so",
          "module": "usd_optimize.validators.duplicate_geometry_fuzzy_checker",
          "module_aliases": ["omni.scene.optimizer.validators.duplicate_geometry_fuzzy_checker"],
          "class_name": "UsdOptimizeFuzzyDuplicateGeometryChecker",
          "category": "Usd:Performance",
          "use_for": ["performance_tuning"]
        }
      ],
      "notes": "Point-cloud distance comparison; can scale poorly. Same backing op, different threshold."
    },
    {
      "canonical_name": "material_duplicates",
      "display_name": "Duplicate materials",
      "role": "opportunity_detector",
      "backing_op": "optimizeMaterials",
      "tier": 1,
      "cost_class": "cheap",
      "gpu_bound": false,
      "scope_policy": "whole_stage",
      "preferred_provider": "so",
      "implementations": [
        {
          "provider": "so",
          "module": "usd_optimize.validators.duplicate_materials_checker",
          "module_aliases": ["omni.scene.optimizer.validators.duplicate_materials_checker"],
          "class_name": "UsdOptimizeDuplicateMaterialsChecker",
          "use_for": ["performance_tuning"]
        }
      ],
      "notes": "Material-network hash. High value on converted content where materials are duplicated per instance."
    },
    {
      "canonical_name": "topology_duplicate_faces",
      "display_name": "Duplicate faces",
      "role": "opportunity_detector",
      "backing_op": "meshCleanup",
      "tier": 2,
      "cost_class": "medium",
      "gpu_bound": false,
      "scope_policy": "per_target_or_sample",
      "preferred_provider": "so",
      "implementations": [
        {
          "provider": "so",
          "module": "usd_optimize.validators.duplicate_face_checker",
          "module_aliases": ["omni.scene.optimizer.validators.duplicate_face_checker"],
          "class_name": "UsdOptimizeDuplicateFaceChecker",
          "use_for": ["performance_tuning"]
        }
      ]
    },
    {
      "canonical_name": "topology_isolated_vertices",
      "display_name": "Isolated vertices",
      "role": "opportunity_detector",
      "backing_op": "meshCleanup",
      "tier": 2,
      "cost_class": "medium",
      "gpu_bound": false,
      "scope_policy": "per_target_or_sample",
      "preferred_provider": "so",
      "implementations": [
        {
          "provider": "so",
          "module": "usd_optimize.validators.isolated_vertices_checker",
          "module_aliases": ["omni.scene.optimizer.validators.isolated_vertices_checker"],
          "class_name": "UsdOptimizeIsolatedVerticesChecker",
          "use_for": ["performance_tuning"]
        }
      ]
    },
    {
      "canonical_name": "extents_zero",
      "display_name": "Zero-extent meshes",
      "role": "opportunity_detector",
      "backing_op": "removeSmallGeometry",
      "tier": 1,
      "cost_class": "cheap",
      "gpu_bound": false,
      "scope_policy": "whole_stage",
      "preferred_provider": "so",
      "implementations": [
        {
          "provider": "so",
          "module": "usd_optimize.validators.zero_extent_checker",
          "module_aliases": ["omni.scene.optimizer.validators.zero_extent_checker"],
          "class_name": "UsdOptimizeZeroExtentChecker",
          "use_for": ["performance_tuning"]
        }
      ],
      "notes": "Use computeExtents first when the cause is stale metadata rather than genuinely empty geometry."
    },
    {
      "canonical_name": "perf_rtx_mesh_count",
      "display_name": "RTX mesh count",
      "role": "opportunity_detector",
      "backing_op": "rtxMeshCount",
      "tier": 1,
      "cost_class": "medium",
      "gpu_bound": false,
      "scope_policy": "whole_stage",
      "preferred_provider": "so",
      "implementations": [
        {
          "provider": "so",
          "module": "usd_optimize.validators.rtx_mesh_count_checker",
          "module_aliases": ["omni.scene.optimizer.validators.rtx_mesh_count_checker"],
          "class_name": "UsdOptimizeRtxMeshCountChecker",
          "use_for": ["performance_tuning"]
        }
      ],
      "notes": "Around a minute and a half on a large reference stage — slowest Tier 1. Counts meshes through composition."
    },
    {
      "canonical_name": "perf_small_mesh",
      "display_name": "Small meshes",
      "role": "opportunity_detector",
      "backing_op": "removeSmallGeometry",
      "tier": 1,
      "cost_class": "cheap",
      "gpu_bound": false,
      "scope_policy": "whole_stage",
      "preferred_provider": "so",
      "implementations": [
        {
          "provider": "so",
          "module": "usd_optimize.validators.small_mesh_checker",
          "module_aliases": ["omni.scene.optimizer.validators.small_mesh_checker"],
          "class_name": "UsdOptimizeSmallMeshChecker",
          "use_for": ["performance_tuning"]
        }
      ]
    },
    {
      "canonical_name": "perf_sparse_mesh",
      "display_name": "Sparse meshes",
      "role": "opportunity_detector",
      "backing_op": "sparseMeshes",
      "tier": 1,
      "cost_class": "cheap",
      "gpu_bound": false,
      "scope_policy": "whole_stage",
      "preferred_provider": "so",
      "implementations": [
        {
          "provider": "so",
          "module": "usd_optimize.validators.sparse_mesh_checker",
          "module_aliases": ["omni.scene.optimizer.validators.sparse_mesh_checker"],
          "class_name": "UsdOptimizeSparseMeshChecker",
          "use_for": ["performance_tuning"]
        }
      ]
    },
    {
      "canonical_name": "perf_high_vertex_count",
      "display_name": "High vertex count",
      "role": "opportunity_detector",
      "backing_op": "countVertices",
      "tier": 1,
      "cost_class": "cheap",
      "gpu_bound": false,
      "scope_policy": "whole_stage",
      "preferred_provider": "so",
      "implementations": [
        {
          "provider": "so",
          "module": "usd_optimize.validators.high_vertex_count_checker",
          "module_aliases": ["omni.scene.optimizer.validators.high_vertex_count_checker"],
          "class_name": "UsdOptimizeHighVertexCountChecker",
          "use_for": ["performance_tuning"]
        }
      ],
      "notes": "Informational; lossless reducers first, decimateMeshes only after the upfront tolerance prompt."
    },
    {
      "canonical_name": "perf_redundant_timesamples",
      "display_name": "Redundant time samples",
      "role": "opportunity_detector",
      "backing_op": "optimizeTimeSamples",
      "tier": 1,
      "cost_class": "cheap",
      "gpu_bound": false,
      "scope_policy": "whole_stage",
      "preferred_provider": "so",
      "implementations": [
        {
          "provider": "so",
          "module": "usd_optimize.validators.redundant_timesamples_checker",
          "module_aliases": ["omni.scene.optimizer.validators.redundant_timesamples_checker"],
          "class_name": "UsdOptimizeRedundantTimeSamplesChecker",
          "use_for": ["performance_tuning"]
        }
      ]
    },
    {
      "canonical_name": "structure_empty_leaf",
      "display_name": "Empty leaf prims",
      "role": "opportunity_detector",
      "backing_op": "pruneLeaves",
      "tier": 1,
      "cost_class": "cheap",
      "gpu_bound": false,
      "scope_policy": "whole_stage",
      "preferred_provider": "so",
      "implementations": [
        {
          "provider": "so",
          "module": "usd_optimize.validators.empty_leaf_checker",
          "module_aliases": ["omni.scene.optimizer.validators.empty_leaf_checker"],
          "class_name": "UsdOptimizeEmptyLeafChecker",
          "use_for": ["performance_tuning"]
        }
      ]
    },
    {
      "canonical_name": "structure_flat_hierarchy",
      "display_name": "Flat hierarchies",
      "role": "target_scoping",
      "backing_op": "flattenHierarchy",
      "tier": 1,
      "cost_class": "cheap",
      "gpu_bound": false,
      "scope_policy": "whole_stage",
      "preferred_provider": "so",
      "implementations": [
        {
          "provider": "so",
          "module": "usd_optimize.validators.flat_hierarchies_checker",
          "module_aliases": ["omni.scene.optimizer.validators.flat_hierarchies_checker"],
          "class_name": "UsdOptimizeFlatHierarchiesChecker",
          "use_for": ["performance_tuning"]
        }
      ],
      "notes": "Analysis-only signal; fix is the flattenHierarchy operation (specialty follow-up)."
    },
    {
      "canonical_name": "structure_invisible",
      "display_name": "Invisible prims",
      "role": "opportunity_detector",
      "backing_op": "removePrims",
      "tier": 1,
      "cost_class": "cheap",
      "gpu_bound": false,
      "scope_policy": "whole_stage",
      "preferred_provider": "so",
      "implementations": [
        {
          "provider": "so",
          "module": "usd_optimize.validators.invisible_prims_checker",
          "module_aliases": ["omni.scene.optimizer.validators.invisible_prims_checker"],
          "class_name": "UsdOptimizeInvisiblePrimsChecker",
          "use_for": ["performance_tuning"]
        }
      ],
      "notes": "Confirm intent before removing; invisibility may be deliberate."
    },
    {
      "canonical_name": "spatial_occluded",
      "display_name": "Occluded (internal) meshes",
      "role": "opportunity_detector",
      "backing_op": "findOccludedMeshes",
      "tier": 3,
      "cost_class": "expensive",
      "gpu_bound": true,
      "scope_policy": "flagged_pairs_only",
      "preferred_provider": "so",
      "implementations": [
        {
          "provider": "so",
          "module": "usd_optimize.validators.occluded_meshes_checker",
          "module_aliases": ["omni.scene.optimizer.validators.occluded_meshes_checker"],
          "class_name": "UsdOptimizeOccludedMeshesChecker",
          "use_for": ["performance_tuning"]
        }
      ],
      "notes": "Two-step detect->act: feed occluded paths to removePrims. Scope to SA validation_scope.cross_component_pairs that aren't explicitly transparent (enclosure_opaque true or unset; boundary pairs nominated via candidate_source hash OR semantics; bbox confirmation-only, not a first-step containment sweep). 485 s full-stage on CPU; scope via paths=. Scoped probe runs without approval; only the removePrims deletion is intent-gated."
    },
    {
      "canonical_name": "spatial_overlapping",
      "display_name": "Overlapping meshes",
      "role": "target_scoping",
      "backing_op": "findOverlappingMeshes",
      "tier": 3,
      "cost_class": "expensive",
      "gpu_bound": true,
      "scope_policy": "flagged_pairs_only",
      "preferred_provider": "so",
      "implementations": [
        {
          "provider": "so",
          "module": "usd_optimize.validators.find_overlapping_meshes_checker",
          "module_aliases": ["omni.scene.optimizer.validators.find_overlapping_meshes_checker"],
          "class_name": "UsdOptimizeFindOverlappingMeshesChecker",
          "use_for": ["performance_tuning"]
        }
      ],
      "notes": ">3,600 s full-stage on CPU; paths=-scoped to 100 meshes = 72 s. Analysis-only; fix is review/merge. Mandatory scoped probe when SA flags routing pairs."
    },
    {
      "canonical_name": "spatial_coinciding",
      "display_name": "Coinciding geometry",
      "role": "target_scoping",
      "backing_op": "findCoincidingGeometry",
      "tier": 3,
      "cost_class": "expensive",
      "gpu_bound": true,
      "scope_policy": "flagged_pairs_only",
      "preferred_provider": "so",
      "implementations": [
        {
          "provider": "so",
          "module": "usd_optimize.validators.coinciding_geometry_checker",
          "module_aliases": ["omni.scene.optimizer.validators.coinciding_geometry_checker"],
          "class_name": "UsdOptimizeCoincidingGeometryChecker",
          "use_for": ["performance_tuning"]
        }
      ]
    },
    {
      "canonical_name": "composition_missing_ref",
      "display_name": "Missing references",
      "role": "safety_gate",
      "backing_op": null,
      "tier": 1,
      "cost_class": "cheap",
      "gpu_bound": false,
      "scope_policy": "whole_stage",
      "preferred_provider": "oav",
      "implementations": [
        {
          "provider": "oav",
          "module": "usd_validation_nvidia.rules._basic",
          "module_aliases": ["omni.asset_validator._base_rules"],
          "class_name": "MissingReferenceChecker",
          "use_for": ["safety_gate", "conformance_audit"]
        }
      ],
      "notes": "Manual fix. Common on converted assets with absolute paths. High-priority safety gate for CAD/BIM conversions."
    },
    {
      "canonical_name": "extents_general",
      "display_name": "Extents conformance",
      "role": "opportunity_detector",
      "backing_op": "computeExtents",
      "tier": 1,
      "cost_class": "cheap",
      "gpu_bound": false,
      "scope_policy": "whole_stage",
      "preferred_provider": "oav",
      "implementations": [
        {
          "provider": "oav",
          "module": "usd_validation_nvidia.rules._basic",
          "module_aliases": ["omni.asset_validator._base_rules"],
          "class_name": "ExtentsChecker",
          "use_for": ["performance_tuning", "conformance_audit"]
        }
      ],
      "notes": "Broader than SO ZeroExtentChecker."
    },
    {
      "canonical_name": "kind_metadata",
      "display_name": "Kind metadata",
      "role": "safety_gate",
      "backing_op": null,
      "tier": 1,
      "cost_class": "cheap",
      "gpu_bound": false,
      "scope_policy": "whole_stage",
      "preferred_provider": "oav",
      "implementations": [
        {
          "provider": "oav",
          "module": "usd_validation_nvidia.rules._basic",
          "module_aliases": ["omni.asset_validator._base_rules"],
          "class_name": "KindChecker",
          "use_for": ["safety_gate", "conformance_audit"]
        }
      ],
      "notes": "Manual fix via USD API."
    },
    {
      "canonical_name": "type_metadata",
      "display_name": "Prim type metadata",
      "role": "safety_gate",
      "backing_op": null,
      "tier": 1,
      "cost_class": "cheap",
      "gpu_bound": false,
      "scope_policy": "whole_stage",
      "preferred_provider": "oav",
      "implementations": [
        {
          "provider": "oav",
          "module": "usd_validation_nvidia.rules._basic",
          "module_aliases": ["omni.asset_validator._base_rules"],
          "class_name": "TypeChecker",
          "use_for": ["safety_gate", "conformance_audit"]
        }
      ]
    },
    {
      "canonical_name": "stage_metadata",
      "display_name": "Stage metadata",
      "role": "safety_gate",
      "backing_op": null,
      "tier": 1,
      "cost_class": "cheap",
      "gpu_bound": false,
      "scope_policy": "whole_stage",
      "preferred_provider": "oav",
      "implementations": [
        {
          "provider": "oav",
          "module": "usd_validation_nvidia.rules._basic",
          "module_aliases": ["omni.asset_validator._base_rules"],
          "class_name": "StageMetadataChecker",
          "use_for": ["safety_gate", "conformance_audit"]
        }
      ]
    },
    {
      "canonical_name": "prim_encapsulation",
      "display_name": "Prim encapsulation",
      "role": "safety_gate",
      "backing_op": null,
      "tier": 1,
      "cost_class": "cheap",
      "gpu_bound": false,
      "scope_policy": "whole_stage",
      "preferred_provider": "oav",
      "implementations": [
        {
          "provider": "oav",
          "module": "usd_validation_nvidia.rules._basic",
          "module_aliases": ["omni.asset_validator._base_rules"],
          "class_name": "PrimEncapsulationChecker",
          "use_for": ["safety_gate", "conformance_audit"]
        }
      ]
    },
    {
      "canonical_name": "layout_default_prim",
      "display_name": "Default prim",
      "role": "safety_gate",
      "backing_op": null,
      "tier": 1,
      "cost_class": "cheap",
      "gpu_bound": false,
      "scope_policy": "whole_stage",
      "preferred_provider": "oav",
      "implementations": [
        {
          "provider": "oav",
          "module": "usd_validation_nvidia.rules._layout",
          "module_aliases": ["omni.asset_validator._layout_checker"],
          "class_name": "DefaultPrimChecker",
          "use_for": ["safety_gate", "conformance_audit"]
        }
      ]
    },
    {
      "canonical_name": "layout_dangling_over",
      "display_name": "Dangling over prims",
      "role": "safety_gate",
      "backing_op": null,
      "tier": 1,
      "cost_class": "cheap",
      "gpu_bound": false,
      "scope_policy": "whole_stage",
      "preferred_provider": "oav",
      "implementations": [
        {
          "provider": "oav",
          "module": "usd_validation_nvidia.rules._layout",
          "module_aliases": ["omni.asset_validator._layout_checker"],
          "class_name": "DanglingOverPrimChecker",
          "use_for": ["safety_gate", "conformance_audit"]
        }
      ]
    },
    {
      "canonical_name": "material_path",
      "display_name": "Material asset paths",
      "role": "safety_gate",
      "backing_op": null,
      "tier": 1,
      "cost_class": "cheap",
      "gpu_bound": false,
      "scope_policy": "whole_stage",
      "preferred_provider": "oav",
      "implementations": [
        {
          "provider": "oav",
          "module": "usd_validation_nvidia.rules._materials",
          "module_aliases": ["omni.asset_validator._material_checker"],
          "class_name": "MaterialPathChecker",
          "use_for": ["safety_gate", "conformance_audit"]
        }
      ],
      "notes": "info:mdl:sourceAsset pointing at missing files. Common on converted assets."
    },
    {
      "canonical_name": "material_dangling_binding",
      "display_name": "Dangling material bindings",
      "role": "safety_gate",
      "backing_op": null,
      "tier": 1,
      "cost_class": "cheap",
      "gpu_bound": false,
      "scope_policy": "whole_stage",
      "preferred_provider": "oav",
      "implementations": [
        {
          "provider": "oav",
          "module": "usd_validation_nvidia.rules._materials",
          "module_aliases": ["omni.asset_validator._material_checker"],
          "class_name": "UsdDanglingMaterialBinding",
          "use_for": ["safety_gate", "conformance_audit"]
        }
      ]
    },
    {
      "canonical_name": "texture_bind",
      "display_name": "Texture asset paths",
      "role": "safety_gate",
      "backing_op": null,
      "tier": 1,
      "cost_class": "cheap",
      "gpu_bound": false,
      "scope_policy": "whole_stage",
      "preferred_provider": "oav",
      "implementations": [
        {
          "provider": "oav",
          "module": "usd_validation_nvidia.rules._basic",
          "module_aliases": ["omni.asset_validator._base_rules"],
          "class_name": "TextureChecker",
          "use_for": ["safety_gate", "conformance_audit"]
        }
      ]
    },
    {
      "canonical_name": "texture_normalmap",
      "display_name": "Normal-map textures",
      "role": "safety_gate",
      "backing_op": null,
      "tier": 1,
      "cost_class": "cheap",
      "gpu_bound": false,
      "scope_policy": "whole_stage",
      "preferred_provider": "oav",
      "implementations": [
        {
          "provider": "oav",
          "module": "usd_validation_nvidia.rules._basic",
          "module_aliases": ["omni.asset_validator._base_rules"],
          "class_name": "NormalMapTextureChecker",
          "use_for": ["safety_gate", "conformance_audit"]
        }
      ]
    },
    {
      "canonical_name": "layer_spec_health",
      "display_name": "Layer spec health",
      "role": "safety_gate",
      "backing_op": null,
      "tier": 1,
      "cost_class": "cheap",
      "gpu_bound": false,
      "scope_policy": "whole_stage",
      "preferred_provider": "oav",
      "implementations": [
        {
          "provider": "oav",
          "module": "usd_validation_nvidia.rules._layers",
          "module_aliases": ["omni.asset_validator._layer_checker"],
          "class_name": "LayerSpecChecker",
          "use_for": ["safety_gate", "conformance_audit"]
        }
      ]
    },
    {
      "canonical_name": "layer_format_perf",
      "display_name": "ASCII layer performance",
      "role": "opportunity_detector",
      "backing_op": null,
      "tier": 1,
      "cost_class": "cheap",
      "gpu_bound": false,
      "scope_policy": "whole_stage",
      "preferred_provider": "oav",
      "implementations": [
        {
          "provider": "oav",
          "module": "usd_validation_nvidia.rules._layers",
          "module_aliases": ["omni.asset_validator._layer_checker"],
          "class_name": "UsdAsciiPerformanceChecker",
          "use_for": ["performance_tuning", "conformance_audit"]
        }
      ],
      "notes": "Flags .usda data layers that should be binary for load performance. Manual/structural fix."
    },
    {
      "canonical_name": "utf8_paths",
      "display_name": "UTF-8 prim names",
      "role": "safety_gate",
      "backing_op": null,
      "tier": 1,
      "cost_class": "cheap",
      "gpu_bound": false,
      "scope_policy": "whole_stage",
      "preferred_provider": "oav",
      "implementations": [
        {
          "provider": "oav",
          "module": "usd_validation_nvidia.rules._unicode",
          "module_aliases": ["omni.asset_validator._utf8_checker"],
          "class_name": "UnicodeNameChecker",
          "use_for": ["safety_gate", "conformance_audit"]
        }
      ]
    },
    {
      "canonical_name": "subdivision_scheme",
      "display_name": "Subdivision scheme",
      "role": "safety_gate",
      "backing_op": null,
      "tier": 1,
      "cost_class": "cheap",
      "gpu_bound": false,
      "scope_policy": "whole_stage",
      "preferred_provider": "oav",
      "implementations": [
        {
          "provider": "oav",
          "module": "usd_validation_nvidia.rules._geometry",
          "module_aliases": ["omni.asset_validator._geometry_checker"],
          "class_name": "SubdivisionSchemeChecker",
          "use_for": ["safety_gate", "conformance_audit"]
        }
      ]
    },
    {
      "canonical_name": "topology_general",
      "display_name": "Topology validity",
      "role": "safety_gate",
      "backing_op": null,
      "tier": 2,
      "cost_class": "medium",
      "gpu_bound": false,
      "scope_policy": "per_target_or_sample",
      "preferred_provider": "oav",
      "implementations": [
        {
          "provider": "oav",
          "module": "usd_validation_nvidia.rules._geometry",
          "module_aliases": ["omni.asset_validator._geometry_checker"],
          "class_name": "ValidateTopologyChecker",
          "use_for": ["conformance_audit"]
        }
      ]
    },
    {
      "canonical_name": "topology_unused_mesh",
      "display_name": "Unused mesh points",
      "role": "opportunity_detector",
      "backing_op": "meshCleanup",
      "tier": 2,
      "cost_class": "medium",
      "gpu_bound": false,
      "scope_policy": "per_target_or_sample",
      "preferred_provider": "oav",
      "implementations": [
        {
          "provider": "oav",
          "module": "usd_validation_nvidia.rules._geometry",
          "module_aliases": ["omni.asset_validator._geometry_checker"],
          "class_name": "UnusedMeshTopologyChecker",
          "category": "Geometry",
          "use_for": ["conformance_audit"]
        }
      ],
      "notes": "meshCleanup removes unreferenced points."
    },
    {
      "canonical_name": "normals_existence",
      "display_name": "Normals existence",
      "role": "opportunity_detector",
      "backing_op": "generateNormals",
      "tier": 2,
      "cost_class": "medium",
      "gpu_bound": false,
      "scope_policy": "per_target_or_sample",
      "preferred_provider": "oav",
      "implementations": [
        {
          "provider": "oav",
          "module": "usd_validation_nvidia.rules._geometry",
          "module_aliases": ["omni.asset_validator._geometry_checker"],
          "class_name": "NormalsExistChecker",
          "use_for": ["conformance_audit"]
        }
      ]
    },
    {
      "canonical_name": "physics_rigid_body",
      "display_name": "Rigid body schema",
      "role": "safety_gate",
      "backing_op": null,
      "tier": 1,
      "cost_class": "cheap",
      "gpu_bound": false,
      "scope_policy": "whole_stage",
      "preferred_provider": "oav",
      "implementations": [
        {
          "provider": "oav",
          "module": "usd_validation_nvidia.rules._physics",
          "module_aliases": ["omni.asset_validator._physics_checker"],
          "class_name": "RigidBodyChecker",
          "use_for": ["conformance_audit"]
        }
      ],
      "notes": "Selected by the unconditional whole-stage safety-gate row; it is cheap and returns nothing on a stage with no physics, so it costs nothing on visualization targets. Representative of the physics_* family (ColliderChecker/PhysicsJointChecker/ArticulationChecker/MassChecker), all of which live alongside it in usd_validation_nvidia.rules._physics and are confirmed present on the live registry."
    }
  ]
}

Requirements and compatibility

Works with: Claude Code, Claude apps, OpenAI Codex, GitHub Copilot, Cursor, Gemini CLI, Kiro, OpenCode, Goose, Amp, Roo Code, JetBrains Junie, Factory Droid, Devin (ex-Windsurf), Mistral Vibe, OpenHands, Letta

“Works with” means the tool reads the open Agent Skills format; a skill written for one tool may use features others lack.

Needs: Needs Python, Needs Node.js

The author says: Requires a verified standalone Usd Optimize/OpenUSD runtime for operations, usd-validation-nvidia for supported checks, and a writable output workspace. Remote assets require a working resolver. Render profiling is an external handoff.

Security

What our scanner noticed· Medium risk

  • Large base64-encoded blobs
  • Scripts that your agent may run

This skill includes scripts that your agent may run. Read them before you use it.

A static scan is not a guarantee. Skills are third-party content: review a skill before you let an agent use it.

Attribution and licence

Created by
NVIDIA Omniverse
Publisher
NVIDIA (Official)
Source
NVIDIA/skills · skills/omniverse-usd-performance-tuning · commit fce3cca
Licence
Apache License 2.0 (redistribution allowed)
  • LICENSE (added by AutoGineer from LICENSE-APACHE)
  • ATTRIBUTION.md (written by AutoGineer)
Synced

AutoGineer is not affiliated with or endorsed by NVIDIA Omniverse or NVIDIA.

Download ZIP

The ZIP holds the skill’s files, its licence files and an ATTRIBUTION.md. Download omniverse-usd-performance-tuning.zip