Omniverse Usd Performance Tuning
OpenAIOfficialCreated by NVIDIA OmniverseDistributed by OpenAI
- Skill
- Workflow
- Software development
- Apache-2.0
- Medium risk
- Has scripts
AutoGineer summary
Written by AutoGineer from the skill’s own files, not by the author
The omniverse-usd-performance-tuning skill provides a structured, end-to-end procedure for addressing performance bottlenecks in USD assets. It manages the lifecycle of performance tuning, from initial runtime context setup and baseline profiling to composition auditing, validation, and targeted scene optimization. The skill enforces a rigorous milestone-based approach, ensuring that all destructive operations are planned and approved, and that performance improvements are verified through comparative profiling and standardized reporting.
What it does
- Orchestrates the end-to-end USD performance tuning lifecycle.
- Validates runtime environments and handles authentication for remote assets.
- Conducts composition audits and structural assessments of USD stages.
- Executes validated optimization operations using Scene Optimizer.
- Generates structured optimization reports comparing baseline and post-optimization metrics.
- Enforces safety gates for destructive operations and mutation.
When to use it
- When a USD scene exhibits slow loading times or low frame rates.
- When memory usage is excessively high or GPU crashes occur.
- When you need to optimize a scene for better interactivity or performance.
- When you need to diagnose CAD conversion quality issues.
- When you need to validate a scene before and after applying optimizations.
Advantages
- Ensures consistent performance diagnosis through a standardized workflow.
- Prevents accidental data loss by requiring approval for destructive operations.
- Provides clear, evidence-based reporting on performance improvements.
- Integrates seamlessly with existing Omniverse validation and optimization tools.
- Maintains strict separation between diagnosis, planning, and execution phases.
Usage examples
- “This USD scene loads very slowly; please triage what I should check first.”
- The agent will initiate the runtime context gate, perform a composition audit, and provide a structured plan to identify the source of the slow load time.
- “Optimize my CAD scene for better performance.”
- The agent will verify the runtime, assess the CAD conversion quality, and propose a milestone-based optimization plan including validation and profiling.
Install
Download the skill as a ZIP:
https://autogineer.com/agent-skills/openai/omniverse-usd-performance-tuning/downloadUnzip 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
<!-- SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved. -->
<!-- SPDX-License-Identifier: Apache-2.0 -->
When to Use
Use this workflow for broad performance asks such as slow loading, high memory, low FPS, GPU crashes, conversion-quality triage, or generic requests to optimize a USD scene.
Instructions
Start from the mandatory runtime context gate before producing tuning output, unless the prompt is only asking for a static classification test.
Classify broad optimization requests as
ready_to_plan; reserveapproval_requiredfor prompts that explicitly name a destructive operation to execute before planning.Plan the full canonical chain through
optimization-report, preserving the structured milestone order and theprofile-stage:baseline/profile-stage:afterlabels when listing milestones.Invoke downstream skill bodies only when their phase is reached, and keep raw runtime artifacts on disk while reading compact summaries.
Frontmatter keeps version and tools at top level for agentskills.io runtime
compatibility. NVCARPS discoverability fields live under metadata.
Output Format
Return a plan or status summary that names the selected entry skill, uses ready_to_plan for generic optimization requests, includes the full milestone chain through optimization-report, and labels profile phases as profile-stage:baseline and profile-stage:after. For structured outputs, the broad-optimization milestone subsequence is omniverse-usd-performance-tuning -> profile-stage:baseline -> usd-structure-assessment -> usd-validation-runner -> restructure-decision -> apply-restructure -> so-run-validators -> so-interpret-validators -> so-run-operations -> profile-stage:after -> compare-profiles -> optimization-report. End-to-end execution should produce an optimized stage when mutation runs and a report conforming to the optimization-report reference's schema (scripts/optimization-report.schema.json within that reference).
Use this workflow for broad performance asks such as slow loading, low FPS, high memory, GPU crashes, conversion quality, or "optimize my scene."
Entry skill rule
This skill is the named entry point for broad performance work whenever the
agent has any verified way to do that work. Runtime probing details live in
setup-usd-performance-tuning; this rule only decides which skill owns the
user-facing performance request.
If the setup probe shows any verified runtime path - Kit, standalone, or even a partial stack such as Asset Validator only - enter here. If the user's requested tool is missing, return the specific
blocked_code(blocked_missing_scene_optimizer,blocked_missing_so_operation, etc.) instead of substituting another workflow.Enter at
setup-usd-performance-tuningonly when no runtime path is verified and runtime choice/setup is the first unresolved problem.For
omniverse://assets, enter atomniverse-authenticationfirst. Authentication precedes setup and triage for remote assets.
The decision is about ownership, not order. Setup, authentication, and triage all run in their normal phase order; this rule only fixes which skill the agent names as the entry skill in its response.
Runtime context — session-start gate (mandatory)
Before any other tuning output, follow the mandatory session-start gate in
skills/omniverse-usd-performance-tuning/references/setup-usd-performance-tuning/references/runtime-context-header.md.
That reference owns output_path, the canonical setup-preflight.json
location, Format A/Format B, and the "do not improvise a silent probe"
anti-pattern.
Required outcomes:
Missing or unreadable preflight: invoke
setup-usd-performance-tuning.Present preflight: print Format A and wait for the user to choose Continue, Change Kit, Switch to standalone, or Re-run probe.
Confirmed runtime in the same session: use compact Format B for follow-up status.
[Kit: {runtime_context.kit.application} {runtime_context.kit.version} | SO: {runtime_context.sceneOptimizer.version} | AV: {runtime_context.assetValidator.version}]Runtime artifact token budget
Before reading Kit logs, Asset Validator CSVs, Scene Optimizer logs, Tracy CSVs,
or other runtime output, follow
references/runtime-artifact-token-budget.md. Keep raw artifacts on disk, read
summary JSON first, and use bounded log snapshots instead of full dumps or live
streams.
Plan-time vs execution-time approval
approval_required at planning time is reserved for requests that explicitly name a destructive operation. Use the following rule when deciding between ready_to_plan and approval_required:
approval_requiredat planning time — the user's request itself names a destructive operation: "flatten this stage", "decimate the meshes", "merge prototypes", "delete unused prims", or any specific named mutation that cannot be undone within the same workflow. In this case the agent's first response must be an approval prompt that names the operation, before the agent commits to a plan that executes it.ready_to_planat planning time — the user's request is general: "optimize this scene", "make it load faster", "reduce GPU memory", "improve interactivity". The agent lays out the full plan, including any destructive operations the plan would invoke (for exampleso-run-operationswithmergeMaterials), without withholding the plan itself. Approval for each destructive operation is requested alongside plan approval.
The distinction is between authorising a plan and authorising a destructive action. A general optimisation request authorises planning; it does not authorise execution of specific destructive operations.
For structured runtime-test responses and similar planning summaries:
A future
restructure-decisionprompt is a planned user-decision gate, not a reason to set the top-level responsedecisiontoapproval_requiredfor a generic optimization request.For a generic optimization request, set
decision: "ready_to_plan"and include the full intended chain in bothcommitted_milestonesandplanned_phases, throughoptimization-report.It is valid for
gates_observedto includeasks_user_for_restructure_decisionwhile the top-leveldecisionremainsready_to_plan.Whenever a chain names profile phases, use the exact labels
profile-stage:baselineandprofile-stage:after; do not emit the ambiguous bareprofile-stagetoken.Start structured milestone lists with
omniverse-usd-performance-tuningas the owning entry skill. Includesetup-usd-performance-tuningonly as additional Phase 0 context, not as a replacement for the entry skill milestone.For broad optimization requests, preserve the milestone subsequence from Output Format above exactly, with optional extra analysis steps inserted only where they do not reorder it.
Do not list
so-run-validatorsorso-interpret-validatorsbeforerestructure-decisionin broad optimization milestone summaries. Phase-aware validator routing still happens throughusd-validation-runner; the SO validator executor/interpreter milestones appear after the restructure decision path in the structured plan contract.
Output expectation
End-to-end optimization work should produce both an optimized USD stage, when
mutation is executed, and a structured optimization report conforming to
the optimization-report reference's scripts/optimization-report.schema.json. The HTML report must be rendered
from references/report-templates/optimization-report.html.template via
render_preview.py — never hand-write HTML. Diagnosis-only work should still
end with a report or summary that states no optimized stage was written.
Purpose
Route digital twin USD performance requests into the right diagnostic and optimization workflow while preserving evidence before mutation.
Prerequisites
Stage path or enough context to identify the target asset.
User goal: diagnosis only, validation, profiling, or processor execution.
Runtime availability status from
setup-usd-performance-tuningwhen not already known.Permission status for in-place mutation vs writing a separate optimized output.
Examples
"This USD loads slowly; triage what to check first."
"Route a low-FPS CAD scene through the performance workflow."
Triage order
Runtime gate. Follow the mandatory session-start gate above before validation, profiling, or optimization. Do not scan, probe, install, or pick Kit/standalone runtimes directly in this skill;
setup-usd-performance-tuningowns probe/chooser/install dispatch and writes the preflight consumed here.Identify the target problem:
Load time.
FPS or interactivity.
GPU or system memory.
Crash or device lost.
CAD conversion quality.
Validation failure.
Gather minimum context:
Stage path and size.
Whether the stage is local, mounted, or
omniverse://remote. For remote assets, route throughomniverse-authenticationbefore first open.Kit or USD runtime.
Whether the workload is CAD, VFI, AIF, Isaac, or generic OpenUSD.
Whether in-place mutation is allowed.
Whether the user wants diagnosis only or processor execution.
Route:
USD composition questions:
usd-structure-assessment(composition is now part of the SA umbrella; deeper detail inskills/omniverse-usd-performance-tuning/references/usd-structure-assessment/references/composition-audit.md).Validation and content issues:
usd-validation-runner(master router; routes tovalidate-*family orso-run-validatorsbased on intent).Edit/output decisions:
usd-edit-target-planner(also owns variant/payload gates).Repeated copied hierarchy or high mesh count with no instancing:
usd-hierarchy-dedupe-candidates.Restructure decision (monolithic stage, asset boundary materialization):
restructure-decision.CAD converter settings: read
references/cad-conversion/README.md(niche pre-USD concern; see reference for details).Scene Optimizer:
so-run-validators,so-interpret-validators,so-run-operations.
Optimization ordering
Follow the canonical ordering in workflow.md § Operation ordering invariants. The high-level rule: prototypes first → per-asset validation → stage-level operations last. The workflow reference owns the full invariant list (meshCleanup before decimateMeshes, deduplication before decimation, never merge if instanced, etc.) and the analysis-only ops catalogue.
Rules
Always run composition audit before mutation.
Always validate before and after processor execution.
Optimize prototypes before per-asset validation.
Do not run whole-stage mesh deduplication on very large CAD scenes before checking for hierarchy-level reuse.
Do not recommend a fixed optimization stack without bottleneck evidence.
Do not invent numeric thresholds or expected percentage wins.
Prefer canonical SO ops over specialty / documentary ones. The op curation in
references/operations/_curation.jsonclassifies every op ascanonical,specialty,analysis,documentary, ordeprecated. When more than one op could resolve the same finding, recommend the canonical one first and only reach for a specialty op when the user explicitly asks or the rationale warrants it. Specifically:For vertex welding, prefer canonical
meshCleanupwith explicit flags over the standalonemergeVerticesop. The standalone op is a legacy/specialty surface; use upstreamusd-optimizefor the operation mechanics and local approval policy before mutating.For hierarchy dedupe, recommend
usd-hierarchy-dedupe-candidates+apply-restructure(the USD-authored rewrite path).For per-mesh dedupe, recommend
deduplicateGeometry(canonical) overfindCoincidingGeometry(analysis — produces a report, not a change).Do not recommend
documentary-status ops (e.g.,boxClip,deletePrims,removeAttributes,removeUntypedPrims,mergeoutside its narrow non-instanced case) without an explicit user request. Documentary ops survive in the per-opreferences/operations/<key>.mdrouting stubs for completeness but are excluded from agent-initiated recommendations.Specialty ≠ documentary. Ops classified as
specialtyin_curation.jsoneither (a) have validator-finding evidence that wires them into theso-interpret-validatorschain (e.g.sparseMeshes,optimizePrimvars), or (b) are load-bearing escape hatches needed for specific downstream contexts (e.g.primitivesToMesheswhen output must beUsdGeomMesh,utilityFunctionfor instancing toggles and material rebinding,pythonScriptforso-create-proxyrecipes). Recommend specialty ops when their validator fires OR when their downstream context applies — the suppression above only targetsdocumentaryops.
Limitations
Does not replace downstream reference instructions; load each required reference before executing it.
Does not install runtimes directly; follow setup or install references when requirements are missing.
Does not authorize mutation when the user has not allowed writes.
Troubleshooting
If runtime status is unclear, run
setup-usd-performance-tuningbefore profiling or validation.If the reported problem is vague, gather stage path, workload type, and whether diagnosis or execution is requested.
If the workflow suggests mutation before evidence, return to baseline profiling and composition audit first.
References
Before routing, read:
skills/omniverse-usd-performance-tuning/references/usd-structure-assessment/references/optimization-tradeoffs.md— identify which pipeline phase the scene is in (extraction, structuring, or optimization). The right action depends on the phase.skills/omniverse-usd-performance-tuning/references/usd-structure-assessment/references/factory-level-structuring.md— understand the three pillars (assets, aggregation, animation) and the seven-step structuring pattern.
If you have network access, prefer the live URLs (noted in each reference file) for the most current version.
Required execution flow
Read references/workflow.md for the canonical Phase 0-7 flow, including
Kit/standalone branches, validator-stack routing, operation ordering,
termination conditions, duration hints, and the optional iteration pattern.
The compact root map at references/skill-map.md only routes agents
into this workflow.
Do not treat downstream phase names as plain checklist labels. Before executing
each step, load that phase's nested README.md reference and follow its
instructions. Claude Code only exposes the public catalog skill; it does not
recursively inject profile-stage, usd-structure-assessment, or other nested
references.
The final deliverable must come from optimization-report: save both the structured JSON report and the generated Markdown summary. Do not substitute an ad hoc SUMMARY.md or chat-only recap for the optimization report.
For deeper subtopic guidance, consult the references:
skills/omniverse-usd-performance-tuning/references/usd-structure-assessment/references/composition-audit.md,skills/omniverse-usd-performance-tuning/references/usd-structure-assessment/references/layer-health.md- subtopic detail for SA's Phase 1 checklist.skills/omniverse-usd-performance-tuning/references/usd-structure-assessment/references/instancing-readiness/references/instancing-tradeoffs.md- merge safety, decision tree for instancing choices.skills/omniverse-usd-performance-tuning/references/usd-structure-assessment/references/usd-edit-target-planner/references/variants-payloads.md- deeper variant/payload trade-offs (gates are inline in usd-edit-target-planner).references/cad-conversion/README.md- CAD converter settings.references/upstreams/usd-optimize.md- upstream SO mechanics and prebuilt package resolution.skills/omniverse-usd-performance-tuning/references/usd-validation-runner/references/so-run-validators/references/infrastructure.md- local handoff for SO validator infrastructure.skills/omniverse-usd-performance-tuning/references/usd-validation-runner/references/validation-scoping.md- tier 1/2/3 plan + scene-aware adjustment.skills/omniverse-usd-performance-tuning/references/optimization-report/references/optimization-report-template.md- the data contract every phase populates.
For full Kit runtime profiling (FPS, frame time, Hydra/RTX metrics), refer to the external profiling skills at NVIDIA/omniperf.
Files
- ATTRIBUTION.mdAdded by AutoGineer1.0 KiB
- BENCHMARK.md22.5 KiB
- LICENSEAdded by AutoGineer10.0 KiB
- SKILL.md17.2 KiB
- agents/openai.yaml402 B
- evals/evals.json4.8 KiB
- references/cad-conversion/README.md2.5 KiB
- references/cad-conversion/scripts/conversion-report.schema.json1.3 KiB
- references/compare-profiles.md2.4 KiB
- references/compare-profiles/README.md9.7 KiB
- references/omniverse-authentication/README.md3.8 KiB
- references/operations/CLASSIFICATION.md4.5 KiB
- references/operations/EXECUTION.md4.5 KiB
- references/operations/README.md8.0 KiB
- references/operations/_curation.json14.5 KiB
- references/operations/_template.md1.5 KiB
- references/operations/boxClip.md1.0 KiB
- references/operations/computeExtents.md1.1 KiB
- references/operations/countVertices.md1.1 KiB
- references/operations/decimateMeshes.md2.6 KiB
- references/operations/deduplicateGeometry.md1.1 KiB
- references/operations/deduplicateHierarchies.md1.5 KiB
- references/operations/deleteHiddenPrims.md1.1 KiB
- references/operations/deletePrims.md1.0 KiB
- references/operations/diceMeshes.md1.1 KiB
- references/operations/editStageMetrics.md1.1 KiB
- references/operations/findCoincidingGeometry.md1.1 KiB
- references/operations/findFlatHierarchies.md1.1 KiB
- references/operations/findOccludedMeshes.md4.8 KiB
- references/operations/findOverlappingMeshes.md1.1 KiB
- references/operations/fitPrimitives.md1.1 KiB
- references/operations/flattenHierarchy.md1.1 KiB
- references/operations/generateAtlasUVs.md1.1 KiB
- references/operations/generateNormals.md1.1 KiB
- references/operations/generateProjectionUVs.md1.1 KiB
- references/operations/generateScene.md1.1 KiB
- references/operations/manifest.json38.6 KiB
- references/operations/manifoldMeshes.md1.1 KiB
- references/operations/merge.md1.1 KiB
- references/operations/mergeVertices.md1.1 KiB
- references/operations/meshCleanup.md1.1 KiB
- references/operations/optimizeMaterials.md1.1 KiB
- references/operations/optimizePrimvars.md1.1 KiB
- references/operations/optimizeSkelRoots.md1.1 KiB
- references/operations/optimizeTimeSamples.md1.1 KiB
- references/operations/organizePrototypes.md1.1 KiB
- references/operations/pivot.md1.0 KiB
- references/operations/primitivesToMeshes.md1.1 KiB
- references/operations/printStats.md1.0 KiB
- references/operations/probe-snapshots/so-110.0.4.json1.8 KiB
- references/operations/pruneLeaves.md1.1 KiB
- references/operations/pythonScript.md1.0 KiB
- references/operations/remeshMeshes.md1.1 KiB
- references/operations/removeAttributes.md1.1 KiB
- references/operations/removePrims.md1.1 KiB
- references/operations/removeSmallGeometry.md1.1 KiB
- references/operations/removeUntypedPrims.md1.1 KiB
- references/operations/removeUnusedUVs.md1.1 KiB
- references/operations/rtxMeshCount.md1.1 KiB
- references/operations/scripts/operation-curation.schema.json1.2 KiB
- references/operations/scripts/operation-manifest.schema.json1.8 KiB
- references/operations/shrinkwrap.md1.0 KiB
- references/operations/sparseMeshes.md1.1 KiB
- references/operations/splitMeshes.md1.0 KiB
- references/operations/subdivideMeshes.md1.1 KiB
- references/operations/triangulateMeshes.md1.1 KiB
- references/operations/utilityFunction.md1.1 KiB
- references/optimization-report/README.md14.6 KiB
- references/optimization-report/references/optimization-report-template.md10.4 KiB
- references/optimization-report/scripts/optimization-report.schema.json9.7 KiB
- references/output-workspace.md3.1 KiB
- references/profile-stage/README.md13.7 KiB
- references/report-templates/README.md1.4 KiB
- references/report-templates/optimization-report.design-fixture.json6.4 KiB
- references/report-templates/optimization-report.html.template8.6 KiB
- references/report-templates/optimization-report.md.template1.7 KiB
- references/report-templates/render_preview.pyScript8.2 KiB
- references/runtime-artifact-token-budget.md3.8 KiB
- references/setup-usd-performance-tuning/README.md12.2 KiB
- references/setup-usd-performance-tuning/references/install-asset-validator-standalone/README.md3.8 KiB
- references/setup-usd-performance-tuning/references/install-kit/README.md2.6 KiB
- references/setup-usd-performance-tuning/references/install-so-standalone/README.md11.0 KiB
- references/setup-usd-performance-tuning/references/install-so-via-kit/README.md3.7 KiB
- references/setup-usd-performance-tuning/references/kit-discovery.md2.9 KiB
- references/setup-usd-performance-tuning/references/runtime-context-header.md13.2 KiB
- references/setup-usd-performance-tuning/references/runtime-probe.md4.5 KiB
- references/setup-usd-performance-tuning/references/standalone-runtime.md2.7 KiB
- references/setup-usd-performance-tuning/scripts/probe-snapshot.schema.json1.7 KiB
- references/setup-usd-performance-tuning/scripts/setup-preflight.schema.json2.8 KiB
- references/skill-map.md6.3 KiB
- references/so-run-operations/README.md3.5 KiB
- references/so-run-operations/references/batch-mode.md4.5 KiB
- references/so-run-operations/references/config-from-evidence.md4.4 KiB
- references/so-run-operations/references/invocation.md4.5 KiB
- references/so-run-operations/references/operation-safety.md8.7 KiB
- references/so-run-operations/references/pipelines.md2.4 KiB
- references/so-run-operations/references/so-create-proxy/README.md1.7 KiB
- references/so-run-operations/references/so-create-proxy/references/bounding-box-proxy-modes.md1.5 KiB
- references/so-run-operations/references/so-create-proxy/references/decimate-step-recipes.md1.5 KiB
- references/so-run-operations/references/so-create-proxy/references/decimation-tuning.md1.5 KiB
- references/so-run-operations/references/so-create-proxy/references/proxy-config-recipes.md1.6 KiB
- references/so-run-operations/references/units-and-tolerances.md3.8 KiB
- references/upstreams/usd-optimize.md3.1 KiB
- references/usd-structure-assessment/README.md24.8 KiB
- references/usd-structure-assessment/references/apply-restructure/README.md14.2 KiB
- references/usd-structure-assessment/references/apply-restructure/references/hierarchy-dedupe-rewrite-tool-spec.md8.5 KiB
- references/usd-structure-assessment/references/apply-restructure/references/ref-remap-mode.md2.4 KiB
- references/usd-structure-assessment/references/apply-restructure/references/restructure-mode.md8.2 KiB
- references/usd-structure-assessment/references/asset-structure-principles.md60.1 KiB
- references/usd-structure-assessment/references/composition-audit.md4.8 KiB
- references/usd-structure-assessment/references/factory-level-structuring.md24.0 KiB
- references/usd-structure-assessment/references/instancing-readiness/README.md8.5 KiB
- references/usd-structure-assessment/references/instancing-readiness/references/instancing-guide.md45.0 KiB
- references/usd-structure-assessment/references/instancing-readiness/references/instancing-tradeoffs.md5.6 KiB
- references/usd-structure-assessment/references/layer-health.md3.1 KiB
- references/usd-structure-assessment/references/optimization-tradeoffs.md8.6 KiB
- references/usd-structure-assessment/references/restructure-decision/README.md16.5 KiB
- references/usd-structure-assessment/references/usd-edit-target-planner/README.md6.3 KiB
- references/usd-structure-assessment/references/usd-edit-target-planner/references/output-saving.md2.1 KiB
- references/usd-structure-assessment/references/usd-edit-target-planner/references/variants-payloads.md4.2 KiB
- references/usd-structure-assessment/references/usd-hierarchy-dedupe-candidates/README.md5.7 KiB
- references/usd-structure-assessment/references/usd-hierarchy-dedupe-candidates/references/instance-candidate-finder-spec.md34.2 KiB
- references/usd-structure-assessment/scripts/audit-report.schema.json1.9 KiB
- references/usd-structure-assessment/scripts/optimization-plan.schema.json1.5 KiB
- references/usd-structure-assessment/scripts/usd-structure-assessment-report.schema.json9.5 KiB
- references/usd-validation-runner/README.md13.0 KiB
- references/usd-validation-runner/references/so-interpret-validators/README.md3.6 KiB
- references/usd-validation-runner/references/so-interpret-validators/references/follow-up-queries.md4.6 KiB
- references/usd-validation-runner/references/so-interpret-validators/references/rule-reference.md8.2 KiB
- references/usd-validation-runner/references/so-run-validators/README.md2.9 KiB
- references/usd-validation-runner/references/so-run-validators/references/infrastructure.md1.6 KiB
- references/usd-validation-runner/references/validate-usd-asset-validator.md13.7 KiB
- references/usd-validation-runner/references/validation-scoping.md23.8 KiB
- references/usd-validation-runner/scripts/asset-validator-validation-report.schema.json2.7 KiB
- references/usd-validation-runner/scripts/validation-report.schema.json1009 B
- references/workflow.md24.5 KiB
- skill-card.md2.5 KiB
- skill.oms.sig39.9 KiB
references/operations/manifest.json
{
"$comment": "SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.\nSPDX-License-Identifier: Apache-2.0",
"schema": "scene_optimizer_operation_catalog",
"source": "operation catalog; routing fields are mirrored in references/operations/<key>.md frontmatter",
"operations": [
{
"key": "boxClip",
"title": "Box Clip",
"category": "transform",
"loss_class": "bounded-loss",
"requires_confirmation": true,
"risk_class": "high",
"args_count": 11,
"requires_mesh": false,
"pipelines": [],
"keywords": [
"clip",
"bounding-box",
"aabb",
"trim",
"crop"
],
"source": "scene-optimizer-core/source/operations/boxClip/BoxClip.cpp",
"doc": "skills/omniverse-usd-performance-tuning/references/operations/boxClip.md",
"summary": "Box Clip removes or retains geometry based on an axis-aligned bounding box (AABB) region.",
"since_version": "2026-02-11T07:51:19Z",
"requires_extension": "omni.scene.optimizer.core"
},
{
"key": "computeExtents",
"title": "Compute Extents",
"category": "metadata",
"loss_class": "lossless",
"requires_confirmation": false,
"risk_class": "low",
"args_count": 1,
"requires_mesh": true,
"pipelines": [
"safe-cleanup",
"load-time-reduction",
"data-quality-baseline"
],
"keywords": [
"extent",
"bounding-box",
"metadata",
"culling"
],
"source": "scene-optimizer-core/source/operations/computeExtents/ComputeExtentsPlugin.cpp",
"doc": "skills/omniverse-usd-performance-tuning/references/operations/computeExtents.md",
"summary": "Compute Extents calculates and authors the `extent` attribute for meshes.",
"since_version": "2026-02-11T07:51:19Z",
"requires_extension": "omni.scene.optimizer.core"
},
{
"key": "countVertices",
"title": "Count Vertices",
"category": "analysis",
"loss_class": "analysis-only",
"requires_confirmation": false,
"risk_class": "low",
"args_count": 3,
"requires_mesh": true,
"pipelines": [],
"keywords": [
"count",
"vertices",
"stats",
"analysis"
],
"source": "scene-optimizer-core/source/operations/countVertices/CountVertices.cpp",
"doc": "skills/omniverse-usd-performance-tuning/references/operations/countVertices.md",
"summary": "Count Vertices is a hidden analysis utility that categorizes meshes by vertex count into high, very high, and extreme buckets.",
"since_version": "2026-02-11T07:51:19Z",
"requires_extension": "omni.scene.optimizer.core"
},
{
"key": "decimateMeshes",
"title": "Decimate Meshes",
"category": "geometry",
"loss_class": "bounded-loss",
"requires_confirmation": true,
"risk_class": "medium",
"args_count": 8,
"requires_mesh": true,
"pipelines": [
"mesh-count-reduction"
],
"keywords": [
"decimate",
"polygon-count",
"lod",
"qem",
"silhouette"
],
"source": "scene-optimizer-core/source/operations/decimateMeshes/OmniMeshDecimate.cpp",
"doc": "skills/omniverse-usd-performance-tuning/references/operations/decimateMeshes.md",
"summary": "Decimate Meshes reduces polygon count while preserving mesh shape as much as possible.",
"since_version": "2026-02-11T07:51:19Z",
"requires_extension": "omni.scene.optimizer.core"
},
{
"key": "deduplicateGeometry",
"title": "De-duplicate Geometry",
"category": "geometry",
"loss_class": "lossless",
"requires_confirmation": false,
"risk_class": "low",
"args_count": 9,
"requires_mesh": true,
"pipelines": [
"safe-cleanup",
"memory-reduction",
"mesh-count-reduction"
],
"keywords": [
"dedup",
"instancing",
"memory",
"mesh"
],
"source": "scene-optimizer-core/source/operations/deduplicateGeometry/DeduplicateGeometry.cpp",
"doc": "skills/omniverse-usd-performance-tuning/references/operations/deduplicateGeometry.md",
"summary": "De-duplicate Geometry finds meshes that are geometrically identical (or near-identical) and replaces duplicates with instances of a single prototype.",
"since_version": "2026-02-11T07:51:19Z",
"requires_extension": "omni.scene.optimizer.core"
},
{
"key": "deduplicateHierarchies",
"title": "De-duplicate Hierarchies",
"category": "hierarchy",
"loss_class": "lossless",
"requires_confirmation": true,
"risk_class": "medium",
"args_count": 0,
"requires_mesh": false,
"pipelines": [
"memory-reduction",
"mesh-count-reduction",
"instancing"
],
"keywords": [
"dedup",
"instancing",
"hierarchy",
"prototype",
"reference"
],
"source": "scene-optimizer-core/source/operations/deduplicateHierarchies/DeduplicateHierarchies.cpp",
"doc": "skills/omniverse-usd-performance-tuning/references/operations/deduplicateHierarchies.md",
"summary": "De-duplicate Hierarchies identifies structurally-identical sub-hierarchies and collapses them into shared prototypes with instanceable references at each original site.",
"since_version": "2026-04-17T00:00:00Z",
"requires_extension": "omni.scene.optimizer.core"
},
{
"key": "deleteHiddenPrims",
"title": "Delete Hidden Prims",
"category": "hierarchy",
"loss_class": "bounded-loss",
"requires_confirmation": true,
"risk_class": "medium",
"args_count": 0,
"requires_mesh": false,
"pipelines": [],
"keywords": [
"delete",
"hidden",
"visibility",
"prune"
],
"source": "scene-optimizer-core/source/operations/deleteHiddenPrims/__init__.py",
"doc": "skills/omniverse-usd-performance-tuning/references/operations/deleteHiddenPrims.md",
"summary": "Delete Hidden Prims finds and deletes all prims that have their visibility set to `invisible`.",
"since_version": "2026-02-11T07:51:19Z",
"requires_extension": "omni.scene.optimizer.core"
},
{
"key": "deletePrims",
"title": "Delete Prims",
"category": "hierarchy",
"loss_class": "bounded-loss",
"requires_confirmation": true,
"risk_class": "high",
"args_count": 1,
"requires_mesh": false,
"pipelines": [],
"keywords": [
"delete",
"prim",
"prune"
],
"source": "scene-optimizer-core/source/operations/deletePrims/DeletePrimsPlugin.cpp",
"doc": "skills/omniverse-usd-performance-tuning/references/operations/deletePrims.md",
"summary": "Delete Prims is a hidden utility operation that permanently removes specified prims from the stage's edit target layer.",
"since_version": "2026-02-11T07:51:19Z",
"requires_extension": "omni.scene.optimizer.core"
},
{
"key": "diceMeshes",
"title": "Dice Meshes",
"category": "geometry",
"loss_class": "bounded-loss",
"requires_confirmation": true,
"risk_class": "medium",
"args_count": 22,
"requires_mesh": true,
"pipelines": [],
"keywords": [
"dice",
"subdivide",
"chunk",
"tile",
"streaming"
],
"source": "scene-optimizer-core/source/operations/diceMeshes/DiceMeshes.cpp",
"doc": "skills/omniverse-usd-performance-tuning/references/operations/diceMeshes.md",
"summary": "Dice Meshes cuts meshes into smaller pieces along a 3D grid \u2014 like slicing a block of cheese with a wire grid.",
"since_version": "2026-02-11T07:51:19Z",
"requires_extension": "omni.scene.optimizer.core"
},
{
"key": "editStageMetrics",
"title": "Edit Stage Metrics",
"category": "metadata",
"loss_class": "lossless",
"requires_confirmation": false,
"risk_class": "low",
"args_count": 4,
"requires_mesh": false,
"pipelines": [],
"keywords": [
"stage",
"metrics",
"metersPerUnit",
"upAxis",
"metadata"
],
"source": "scene-optimizer-core/source/operations/editStageMetrics/EditStageMetrics.cpp",
"doc": "skills/omniverse-usd-performance-tuning/references/operations/editStageMetrics.md",
"summary": "Edit Stage Metrics modifies a stage's global metrics \u2014 up axis and linear units.",
"since_version": "2026-02-11T07:51:19Z",
"requires_extension": "omni.scene.optimizer.core"
},
{
"key": "findCoincidingGeometry",
"title": "Find Coinciding Geometry",
"category": "analysis",
"loss_class": "analysis-only",
"requires_confirmation": false,
"risk_class": "low",
"args_count": 4,
"requires_mesh": true,
"pipelines": [],
"keywords": [
"find",
"coinciding",
"overlap",
"analysis"
],
"source": "scene-optimizer-core/source/operations/findCoincidingGeometry/FindCoincidingGeometry.cpp",
"doc": "skills/omniverse-usd-performance-tuning/references/operations/findCoincidingGeometry.md",
"summary": "Find Coinciding Geometry detects meshes that occupy the same space \u2014 overlapping or near-identical geometry that causes z-fighting and wasted rendering.",
"since_version": "2026-02-11T07:51:19Z",
"requires_extension": "omni.scene.optimizer.core"
},
{
"key": "findFlatHierarchies",
"title": "Find Flat Hierarchies",
"category": "analysis",
"loss_class": "analysis-only",
"requires_confirmation": false,
"risk_class": "low",
"args_count": 3,
"requires_mesh": false,
"pipelines": [],
"keywords": [
"find",
"hierarchy",
"flat",
"analysis"
],
"source": "scene-optimizer-core/source/operations/findFlatHierarchies/FindFlatHierarchiesOperation.cpp",
"doc": "skills/omniverse-usd-performance-tuning/references/operations/findFlatHierarchies.md",
"summary": "Find Flat Hierarchies identifies prims with an excessively large number of children \u2014 \"flat\" hierarchy patterns where a single prim has hundreds or thousands of direct children.",
"since_version": "2026-02-11T07:51:19Z",
"requires_extension": "omni.scene.optimizer.core"
},
{
"key": "findOccludedMeshes",
"title": "Find Occluded Meshes",
"category": "analysis",
"loss_class": "analysis-only",
"requires_confirmation": true,
"risk_class": "medium",
"args_count": 7,
"requires_mesh": true,
"pipelines": [],
"keywords": [
"find",
"occluded",
"interior",
"hidden",
"analysis",
"internal",
"enclosed"
],
"source": "scene-optimizer-core/source/operations/findOccludedMeshes/FindOccludedMeshes.cpp",
"doc": "skills/omniverse-usd-performance-tuning/references/operations/findOccludedMeshes.md",
"summary": "Find Occluded Meshes detects geometry that is completely hidden inside other geometry and therefore never visible.",
"since_version": "2026-02-11T07:51:19Z",
"requires_extension": "omni.scene.optimizer.core"
},
{
"key": "findOverlappingMeshes",
"title": "Find Overlapping Meshes",
"category": "analysis",
"loss_class": "analysis-only",
"requires_confirmation": false,
"risk_class": "low",
"args_count": 4,
"requires_mesh": true,
"pipelines": [],
"keywords": [
"find",
"overlap",
"intersect",
"analysis"
],
"source": "scene-optimizer-core/source/operations/findOverlappingMeshes/FindOverlappingMeshesOperation.cpp",
"doc": "skills/omniverse-usd-performance-tuning/references/operations/findOverlappingMeshes.md",
"summary": "Find Overlapping Meshes detects interfering geometry \u2014 meshes whose surfaces intersect or penetrate each other.",
"since_version": "2026-05-08T22:40:32Z",
"requires_extension": "omni.scene.optimizer.core"
},
{
"key": "fitPrimitives",
"title": "Fit Primitives",
"category": "geometry",
"loss_class": "bounded-loss",
"requires_confirmation": true,
"risk_class": "high",
"args_count": 20,
"requires_mesh": true,
"pipelines": [],
"keywords": [
"fit",
"primitive",
"cube",
"sphere",
"cylinder",
"approximate"
],
"source": "scene-optimizer-core/source/operations/fitPrimitives/Primitive.cpp",
"doc": "skills/omniverse-usd-performance-tuning/references/operations/fitPrimitives.md",
"summary": "Fit Primitives analyzes meshes and replaces them with simpler geometric primitives (spheres, cylinders, cones, cubes) when the mesh closely matches one of those shapes.",
"since_version": "2026-02-11T07:51:19Z",
"requires_extension": "omni.scene.optimizer.core"
},
{
"key": "flattenHierarchy",
"title": "Flatten Hierarchy",
"category": "hierarchy",
"loss_class": "lossless",
"requires_confirmation": false,
"risk_class": "medium",
"args_count": 2,
"requires_mesh": false,
"pipelines": [],
"keywords": [
"flatten",
"hierarchy",
"scenegraph"
],
"source": "scene-optimizer-core/source/operations/flattenHierarchy/FlattenHierarchy.cpp",
"doc": "skills/omniverse-usd-performance-tuning/references/operations/flattenHierarchy.md",
"summary": "Flatten Hierarchy removes redundant Xform prims from a stage's hierarchy, reducing prim count.",
"since_version": "2026-02-11T07:51:19Z",
"requires_extension": "omni.scene.optimizer.core"
},
{
"key": "generateAtlasUVs",
"title": "generateAtlasUVs",
"category": "uv",
"loss_class": "lossless",
"requires_confirmation": false,
"risk_class": "medium",
"args_count": 7,
"requires_mesh": true,
"pipelines": [],
"keywords": [
"uv",
"atlas",
"unwrap",
"texture"
],
"source": "scene-optimizer-core/source/operations/generateAtlasUVs/GenerateAtlasUVs.cpp",
"doc": "skills/omniverse-usd-performance-tuning/references/operations/generateAtlasUVs.md",
"summary": "Auto UV Unwrap generates texture coordinates (UVs) by unfolding mesh surfaces into 2D.",
"since_version": "2026-02-11T07:51:19Z",
"requires_extension": "omni.scene.optimizer.core"
},
{
"key": "generateNormals",
"title": "Generate Normals",
"category": "geometry",
"loss_class": "lossless",
"requires_confirmation": false,
"risk_class": "low",
"args_count": 6,
"requires_mesh": true,
"pipelines": [
"data-quality-baseline"
],
"keywords": [
"normals",
"shading",
"smooth",
"regenerate"
],
"source": "scene-optimizer-core/source/operations/generateNormals/GenerateNormals.cpp",
"doc": "skills/omniverse-usd-performance-tuning/references/operations/generateNormals.md",
"summary": "Generate Normals computes and authors vertex normals for meshes.",
"since_version": "2026-02-11T07:51:19Z",
"requires_extension": "omni.scene.optimizer.core"
},
{
"key": "generateProjectionUVs",
"title": "Generate Projection UVs",
"category": "uv",
"loss_class": "lossless",
"requires_confirmation": false,
"risk_class": "low",
"args_count": 7,
"requires_mesh": true,
"pipelines": [],
"keywords": [
"uv",
"projection",
"planar",
"texture"
],
"source": "scene-optimizer-core/source/operations/generateProjectionUVs/GenerateProjectionUVs.cpp",
"doc": "skills/omniverse-usd-performance-tuning/references/operations/generateProjectionUVs.md",
"summary": "Generate Projection UVs creates texture coordinates by projecting them onto meshes using one of several projection methods (planar, cylindrical, spherical, cubic, or triplanar).",
"since_version": "2026-02-11T07:51:19Z",
"requires_extension": "omni.scene.optimizer.core"
},
{
"key": "generateScene",
"title": "Generate Scene",
"category": "utility",
"loss_class": "lossless",
"requires_confirmation": false,
"risk_class": "low",
"args_count": 12,
"requires_mesh": false,
"pipelines": [],
"keywords": [
"generate",
"scene",
"synthetic",
"test",
"demo"
],
"source": "scene-optimizer-core/source/operations/generateScene/GenerateScene.cpp",
"doc": "skills/omniverse-usd-performance-tuning/references/operations/generateScene.md",
"summary": "Generate Scene creates synthetic test scenes by procedurally placing meshes in a layout.",
"since_version": "2026-02-11T07:51:19Z",
"requires_extension": "omni.scene.optimizer.core"
},
{
"key": "manifoldMeshes",
"title": "Manifold Meshes",
"category": "geometry",
"loss_class": "bounded-loss",
"requires_confirmation": true,
"risk_class": "medium",
"args_count": 1,
"requires_mesh": true,
"pipelines": [],
"keywords": [
"manifold",
"watertight",
"close-holes",
"topology"
],
"source": "scene-optimizer-core/source/operations/manifoldMeshes/Manifold.cpp",
"doc": "skills/omniverse-usd-performance-tuning/references/operations/manifoldMeshes.md",
"summary": "**Legacy command \u2014 use `meshCleanup` with `makeManifold: true` instead.** This operation exists for backward compatibility.",
"since_version": "2026-02-11T07:51:19Z",
"requires_extension": "omni.scene.optimizer.core"
},
{
"key": "merge",
"title": "Merge Static Meshes",
"category": "transform",
"loss_class": "bounded-loss",
"requires_confirmation": true,
"risk_class": "high",
"args_count": 14,
"requires_mesh": true,
"pipelines": [],
"keywords": [
"merge",
"combine",
"consolidate",
"instancing-conflict"
],
"source": "scene-optimizer-core/source/operations/merge/Merge.cpp",
"doc": "skills/omniverse-usd-performance-tuning/references/operations/merge.md",
"summary": "Merge Static Meshes combines multiple meshes that share common properties into single merged meshes.",
"since_version": "2026-02-11T07:51:19Z",
"requires_extension": "omni.scene.optimizer.core"
},
{
"key": "mergeVertices",
"title": "Merge Vertices",
"category": "geometry",
"loss_class": "lossless",
"requires_confirmation": false,
"risk_class": "low",
"args_count": 5,
"requires_mesh": true,
"pipelines": [],
"keywords": [
"weld",
"merge",
"vertices",
"tolerance"
],
"source": "scene-optimizer-core/source/operations/mergeVertices/MergeVertices.cpp",
"doc": "skills/omniverse-usd-performance-tuning/references/operations/mergeVertices.md",
"summary": "**Legacy command \u2014 use `meshCleanup` instead.** This operation exists for backward compatibility.",
"since_version": "2026-02-11T07:51:19Z",
"requires_extension": "omni.scene.optimizer.core"
},
{
"key": "meshCleanup",
"title": "Mesh Cleanup",
"category": "geometry",
"loss_class": "bounded-loss",
"requires_confirmation": true,
"risk_class": "low",
"args_count": 11,
"requires_mesh": true,
"pipelines": [
"mesh-count-reduction",
"data-quality-baseline"
],
"keywords": [
"cleanup",
"degenerate",
"isolated",
"topology",
"fix"
],
"source": "scene-optimizer-core/source/operations/meshCleanup/MeshCleanup.cpp",
"doc": "skills/omniverse-usd-performance-tuning/references/operations/meshCleanup.md",
"summary": "Mesh Cleanup performs a suite of mesh repair operations to fix common topological defects.",
"since_version": "2026-02-11T07:51:19Z",
"requires_extension": "omni.scene.optimizer.core"
},
{
"key": "optimizeMaterials",
"title": "Optimize Materials",
"category": "materials",
"loss_class": "lossless",
"requires_confirmation": false,
"risk_class": "low",
"args_count": 4,
"requires_mesh": false,
"pipelines": [
"safe-cleanup",
"memory-reduction",
"load-time-reduction"
],
"keywords": [
"materials",
"shader",
"dedup",
"consolidate"
],
"source": "scene-optimizer-core/source/operations/optimizeMaterials/OptimizeMaterials.cpp",
"doc": "skills/omniverse-usd-performance-tuning/references/operations/optimizeMaterials.md",
"summary": "Optimize Materials reduces the number of materials in a scene by deduplicating identical materials and consolidating similar ones.",
"since_version": "2026-02-11T07:51:19Z",
"requires_extension": "omni.scene.optimizer.core"
},
{
"key": "optimizePrimvars",
"title": "Optimize Primvars",
"category": "metadata",
"loss_class": "lossless",
"requires_confirmation": false,
"risk_class": "low",
"args_count": 6,
"requires_mesh": true,
"pipelines": [],
"keywords": [
"primvars",
"interpolation",
"constant",
"compress"
],
"source": "scene-optimizer-core/source/operations/optimizePrimvars/OptimizePrimvars.cpp",
"doc": "skills/omniverse-usd-performance-tuning/references/operations/optimizePrimvars.md",
"summary": "Optimize Primvars reduces memory usage by optimizing how primvar (per-vertex/per-face attributes like UVs, colors) data is stored.",
"since_version": "2026-02-11T07:51:19Z",
"requires_extension": "omni.scene.optimizer.core"
},
{
"key": "optimizeSkelRoots",
"title": "Optimize Skeleton Roots",
"category": "hierarchy",
"loss_class": "lossless",
"requires_confirmation": false,
"risk_class": "low",
"args_count": 0,
"requires_mesh": false,
"pipelines": [],
"keywords": [
"skeleton",
"skelroot",
"rigging",
"animation"
],
"source": "scene-optimizer-core/source/operations/optimizeSkelRoots/OptimizeSkelRoots.cpp",
"doc": "skills/omniverse-usd-performance-tuning/references/operations/optimizeSkelRoots.md",
"summary": "Optimize Skeleton Roots merges all skinned meshes within each UsdSkelRoot to improve GPU skinning performance.",
"since_version": "2026-02-11T07:51:19Z",
"requires_extension": "omni.scene.optimizer.core"
},
{
"key": "optimizeTimeSamples",
"title": "Optimize Time Samples",
"category": "metadata",
"loss_class": "lossless",
"requires_confirmation": false,
"risk_class": "low",
"args_count": 6,
"requires_mesh": false,
"pipelines": [
"safe-cleanup",
"load-time-reduction"
],
"keywords": [
"time-samples",
"animation",
"compress",
"constant"
],
"source": "scene-optimizer-core/source/operations/optimizeTimeSamples/OptimizeTimeSamples.cpp",
"doc": "skills/omniverse-usd-performance-tuning/references/operations/optimizeTimeSamples.md",
"summary": "Optimize Time Samples removes redundant time samples from animated attributes.",
"since_version": "2026-02-11T07:51:19Z",
"requires_extension": "omni.scene.optimizer.core"
},
{
"key": "organizePrototypes",
"title": "Organize Prototypes",
"category": "hierarchy",
"loss_class": "lossless",
"requires_confirmation": false,
"risk_class": "low",
"args_count": 2,
"requires_mesh": false,
"pipelines": [],
"keywords": [
"prototypes",
"instanceable",
"organize",
"scenegraph"
],
"source": "scene-optimizer-core/source/operations/organizePrototypes/OrganizePrototypes.cpp",
"doc": "skills/omniverse-usd-performance-tuning/references/operations/organizePrototypes.md",
"summary": "Organize Prototypes moves internal scene-graph instance prototypes under a user-specified namespace (class prim).",
"since_version": "2026-02-11T07:51:19Z",
"requires_extension": "omni.scene.optimizer.core"
},
{
"key": "pivot",
"title": "Compute Pivot",
"category": "transform",
"loss_class": "lossless",
"requires_confirmation": false,
"risk_class": "low",
"args_count": 4,
"requires_mesh": true,
"pipelines": [],
"keywords": [
"pivot",
"transform",
"origin",
"xform"
],
"source": "scene-optimizer-core/source/operations/pivot/Pivot.cpp",
"doc": "skills/omniverse-usd-performance-tuning/references/operations/pivot.md",
"summary": "Compute Pivot recalculates and sets pivot points (transform origins) for meshes or transforms.",
"since_version": "2026-02-11T07:51:19Z",
"requires_extension": "omni.scene.optimizer.core"
},
{
"key": "primitivesToMeshes",
"title": "Primitives to Meshes",
"category": "geometry",
"loss_class": "lossless",
"requires_confirmation": false,
"risk_class": "low",
"args_count": 13,
"requires_mesh": false,
"pipelines": [],
"keywords": [
"primitive",
"convert",
"tessellate",
"mesh"
],
"source": "scene-optimizer-core/source/operations/primitivesToMeshes/PrimitiveToMesh.cpp",
"doc": "skills/omniverse-usd-performance-tuning/references/operations/primitivesToMeshes.md",
"summary": "Primitives to Meshes converts USD geometric primitives (UsdGeomSphere, UsdGeomCylinder, UsdGeomCone, UsdGeomCube) into polygon mesh representations.",
"since_version": "2026-02-11T07:51:19Z",
"requires_extension": "omni.scene.optimizer.core"
},
{
"key": "printStats",
"title": "Print Stats",
"category": "analysis",
"loss_class": "analysis-only",
"requires_confirmation": false,
"risk_class": "low",
"args_count": 3,
"requires_mesh": false,
"pipelines": [],
"keywords": [
"stats",
"print",
"report",
"analysis"
],
"source": "scene-optimizer-core/source/operations/printStats/PrintStats.cpp",
"doc": "skills/omniverse-usd-performance-tuning/references/operations/printStats.md",
"summary": "Print Stats is a hidden diagnostic operation that outputs scene statistics including prim counts, mesh counts, vertex/face totals, and optionally primvar and timing information.",
"since_version": "2026-05-08T22:40:32Z",
"requires_extension": "omni.scene.optimizer.core"
},
{
"key": "pruneLeaves",
"title": "Prune Leaves",
"category": "hierarchy",
"loss_class": "lossless",
"requires_confirmation": false,
"risk_class": "low",
"args_count": 3,
"requires_mesh": false,
"pipelines": [
"safe-cleanup",
"memory-reduction",
"load-time-reduction"
],
"keywords": [
"prune",
"empty",
"leaves",
"cleanup"
],
"source": "scene-optimizer-core/source/operations/pruneLeaves/PruneLeaves.cpp",
"doc": "skills/omniverse-usd-performance-tuning/references/operations/pruneLeaves.md",
"summary": "Prune Leaves finds and removes leaf grouping primitives \u2014 Xforms and Scopes that contain no meaningful children (or only other empty groups).",
"since_version": "2026-02-11T07:51:19Z",
"requires_extension": "omni.scene.optimizer.core"
},
{
"key": "pythonScript",
"title": "Python Script",
"category": "utility",
"loss_class": "bounded-loss",
"requires_confirmation": true,
"risk_class": "high",
"args_count": 1,
"requires_mesh": false,
"pipelines": [],
"keywords": [
"python",
"script",
"custom",
"user-code"
],
"source": "scene-optimizer-core/source/operations/pythonScript/__init__.py",
"doc": "skills/omniverse-usd-performance-tuning/references/operations/pythonScript.md",
"summary": "Python Script executes a user-defined Python script as a Scene Optimizer operation.",
"since_version": "2026-02-11T07:51:19Z",
"requires_extension": "omni.scene.optimizer.core"
},
{
"key": "remeshMeshes",
"title": "Remesh Meshes",
"category": "geometry",
"loss_class": "bounded-loss",
"requires_confirmation": true,
"risk_class": "high",
"args_count": 4,
"requires_mesh": true,
"pipelines": [],
"keywords": [
"remesh",
"retopology",
"uniform",
"regenerate"
],
"source": "scene-optimizer-core/source/operations/remeshMeshes/Remesh.cpp",
"doc": "skills/omniverse-usd-performance-tuning/references/operations/remeshMeshes.md",
"summary": "Remesh Meshes regenerates mesh topology to create a more uniform triangle distribution while preserving the original shape.",
"since_version": "2026-02-11T07:51:19Z",
"requires_extension": "omni.scene.optimizer.core"
},
{
"key": "removeAttributes",
"title": "Remove Attributes",
"category": "metadata",
"loss_class": "bounded-loss",
"requires_confirmation": true,
"risk_class": "medium",
"args_count": 3,
"requires_mesh": false,
"pipelines": [],
"keywords": [
"remove",
"attribute",
"metadata",
"cleanup"
],
"source": "scene-optimizer-core/source/operations/removeAttributes/RemoveAttributes.cpp",
"doc": "skills/omniverse-usd-performance-tuning/references/operations/removeAttributes.md",
"summary": "Remove Attributes removes or blocks specified attributes from prims.",
"since_version": "2026-02-11T07:51:19Z",
"requires_extension": "omni.scene.optimizer.core"
},
{
"key": "removePrims",
"title": "Remove Prims",
"category": "hierarchy",
"loss_class": "bounded-loss",
"requires_confirmation": true,
"risk_class": "high",
"args_count": 8,
"requires_mesh": false,
"pipelines": [],
"keywords": [
"remove",
"prim",
"filter",
"delete"
],
"source": "scene-optimizer-core/source/operations/removePrims/RemovePrimsPlugin.cpp",
"doc": "skills/omniverse-usd-performance-tuning/references/operations/removePrims.md",
"summary": "Remove Prims identifies and removes invisible prims and orphaned overs from a USD stage.",
"since_version": "2026-02-11T07:51:19Z",
"requires_extension": "omni.scene.optimizer.core"
},
{
"key": "removeSmallGeometry",
"title": "Remove Small Geometry",
"category": "geometry",
"loss_class": "bounded-loss",
"requires_confirmation": true,
"risk_class": "medium",
"args_count": 4,
"requires_mesh": true,
"pipelines": [
"mesh-count-reduction"
],
"keywords": [
"remove",
"small",
"screen-space",
"lod",
"cleanup"
],
"source": "scene-optimizer-core/source/operations/removeSmallGeometry/RemoveSmallGeometry.cpp",
"doc": "skills/omniverse-usd-performance-tuning/references/operations/removeSmallGeometry.md",
"summary": "Remove Small Geometry finds and removes meshes that are below a size threshold.",
"since_version": "2026-02-11T07:51:19Z",
"requires_extension": "omni.scene.optimizer.core"
},
{
"key": "removeUntypedPrims",
"title": "Remove Untyped Prims",
"category": "hierarchy",
"loss_class": "bounded-loss",
"requires_confirmation": true,
"risk_class": "low",
"args_count": 0,
"requires_mesh": false,
"pipelines": [],
"keywords": [
"remove",
"untyped",
"scope",
"cleanup"
],
"source": "scene-optimizer-core/source/operations/removeUntypedPrims/__init__.py",
"doc": "skills/omniverse-usd-performance-tuning/references/operations/removeUntypedPrims.md",
"summary": "Remove Untyped Prims deletes prims that have no USD schema type.",
"since_version": "2026-02-11T07:51:19Z",
"requires_extension": "omni.scene.optimizer.core"
},
{
"key": "removeUnusedUVs",
"title": "Remove Unused UVs",
"category": "uv",
"loss_class": "lossless",
"requires_confirmation": false,
"risk_class": "low",
"args_count": 3,
"requires_mesh": true,
"pipelines": [],
"keywords": [
"uv",
"unused",
"remove",
"cleanup"
],
"source": "scene-optimizer-core/source/operations/removeUnusedUVs/RemoveUnusedUVs.cpp",
"doc": "skills/omniverse-usd-performance-tuning/references/operations/removeUnusedUVs.md",
"summary": "Remove Unused UVs finds and removes texture coordinate (UV) attributes that are not referenced by any bound material.",
"since_version": "2026-02-11T07:51:19Z",
"requires_extension": "omni.scene.optimizer.core"
},
{
"key": "rtxMeshCount",
"title": "RTX Mesh Count",
"category": "analysis",
"loss_class": "analysis-only",
"requires_confirmation": false,
"risk_class": "low",
"args_count": 1,
"requires_mesh": true,
"pipelines": [],
"keywords": [
"rtx",
"mesh-count",
"raytracing",
"stats"
],
"source": "scene-optimizer-core/source/operations/rtxMeshCount/RtxMeshCount.cpp",
"doc": "skills/omniverse-usd-performance-tuning/references/operations/rtxMeshCount.md",
"summary": "RTX Mesh Count is a hidden analysis operation that counts the number of RTX acceleration structures, RTX meshes, and unique RTX meshes in the scene.",
"since_version": "2026-02-11T07:51:19Z",
"requires_extension": "omni.scene.optimizer.core"
},
{
"key": "shrinkwrap",
"title": "Shrinkwrap",
"category": "geometry",
"loss_class": "bounded-loss",
"requires_confirmation": true,
"risk_class": "high",
"args_count": 7,
"requires_mesh": true,
"pipelines": [],
"keywords": [
"shrinkwrap",
"wrap",
"proxy",
"lod"
],
"source": "scene-optimizer-core/source/operations/shrinkwrap/Shrinkwrap.cpp",
"doc": "skills/omniverse-usd-performance-tuning/references/operations/shrinkwrap.md",
"summary": "Shrinkwrap converts a polygon soup into a bounding watertight mesh, with controllable mechanisms to generate loose and tight surface proxies.",
"since_version": "2026-03-05T22:02:49Z",
"requires_extension": "omni.scene.optimizer.core"
},
{
"key": "sparseMeshes",
"title": "Sparse Meshes",
"category": "geometry",
"loss_class": "bounded-loss",
"requires_confirmation": true,
"risk_class": "medium",
"args_count": 0,
"requires_mesh": true,
"pipelines": [],
"keywords": [
"sparse",
"decimate",
"reduce",
"geometry"
],
"source": "scene-optimizer-core/source/operations/sparseMeshes/SparseMeshes.cpp",
"doc": "skills/omniverse-usd-performance-tuning/references/operations/sparseMeshes.md",
"summary": "Sparse Meshes is a hidden analysis operation that identifies meshes with poor spatial density \u2014 geometry that occupies a large bounding box relative to its actual surface area.",
"since_version": "2026-02-11T07:51:19Z",
"requires_extension": "omni.scene.optimizer.core"
},
{
"key": "splitMeshes",
"title": "Split Meshes",
"category": "geometry",
"loss_class": "lossless",
"requires_confirmation": false,
"risk_class": "low",
"args_count": 16,
"requires_mesh": true,
"pipelines": [],
"keywords": [
"split",
"partition",
"chunk",
"geometry"
],
"source": "scene-optimizer-core/source/operations/splitMeshes/SplitMeshes.cpp",
"doc": "skills/omniverse-usd-performance-tuning/references/operations/splitMeshes.md",
"summary": "Split Meshes breaks meshes into smaller pieces based on geometric connectivity or spatial clustering.",
"since_version": "2026-02-11T07:51:19Z",
"requires_extension": "omni.scene.optimizer.core"
},
{
"key": "subdivideMeshes",
"title": "Subdivide Meshes",
"category": "geometry",
"loss_class": "lossless",
"requires_confirmation": false,
"risk_class": "low",
"args_count": 5,
"requires_mesh": true,
"pipelines": [],
"keywords": [
"subdivide",
"tessellate",
"smooth",
"geometry"
],
"source": "scene-optimizer-core/source/operations/subdivideMeshes/Subdivide.cpp",
"doc": "skills/omniverse-usd-performance-tuning/references/operations/subdivideMeshes.md",
"summary": "Subdivide Meshes increases mesh polygon density by subdividing faces.",
"since_version": "2026-02-11T07:51:19Z",
"requires_extension": "omni.scene.optimizer.core"
},
{
"key": "triangulateMeshes",
"title": "Triangulate Meshes",
"category": "geometry",
"loss_class": "lossless",
"requires_confirmation": false,
"risk_class": "low",
"args_count": 2,
"requires_mesh": true,
"pipelines": [],
"keywords": [
"triangulate",
"quad",
"topology",
"geometry"
],
"source": "scene-optimizer-core/source/operations/triangulateMeshes/Triangulate.cpp",
"doc": "skills/omniverse-usd-performance-tuning/references/operations/triangulateMeshes.md",
"summary": "Triangulate Meshes converts all polygon faces to triangles.",
"since_version": "2026-02-11T07:51:19Z",
"requires_extension": "omni.scene.optimizer.core"
},
{
"key": "utilityFunction",
"title": "Utility Function",
"category": "utility",
"loss_class": "lossless",
"requires_confirmation": false,
"risk_class": "low",
"args_count": 2,
"requires_mesh": false,
"pipelines": [],
"keywords": [
"utility",
"helper",
"internal"
],
"source": "scene-optimizer-core/source/operations/utilityFunction/UtilityFunction.cpp",
"doc": "skills/omniverse-usd-performance-tuning/references/operations/utilityFunction.md",
"summary": "Utility Function is a container for small one-off operations that don't merit their own plugin.",
"since_version": "2026-05-08T22:40:32Z",
"requires_extension": "omni.scene.optimizer.core"
}
]
}
Requirements and compatibility
Written for: OpenAI Codex
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
The author says: Orchestrator skill. Downstream phases may require Kit, Scene Optimizer, Asset Validator, USD Python, writable output paths, and omniverse:// authentication selected by setup-usd-performance-tuning.
Security
What our scanner noticed· Medium risk
- Large base64-encoded blobs
- Instructions that use the network
- 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
- OpenAI (Official)
- Distributed by
- OpenAI
- Source
- openai/plugins · plugins/nvidia/skills/omniverse-usd-performance-tuning · commit d420d13
- Licence
- Apache License 2.0 (redistribution allowed)
- LICENSE (written by AutoGineer)
- ATTRIBUTION.md (written by AutoGineer)
- Synced
AutoGineer is not affiliated with or endorsed by NVIDIA Omniverse or OpenAI.
Download ZIP
The ZIP holds the skill’s files, its licence files and an ATTRIBUTION.md. Download omniverse-usd-performance-tuning.zip