run-operations

Execute Scene Optimizer operation chains on USD assets and save optimized outputs.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Run Scene Optimizer operations on a USD asset and produce an optimized output you can review and validate, without manually stitching together validation, configuration, execution, and result handling.

Core Features & Use Cases

  • Execute an op chain and save results: Apply a sequence of operations to a USD stage and write an optimized asset to an output path.
  • Use validator findings to build a config: Convert recommended fixes from prior run-validators / interpret-validators work into a runnable operation chain.
  • Guardrails for correctness and safety: Validates input paths, offers operation-availability checks, supports non-destructive and destructive pipelines, and prompts before destructive ops that permanently alter geometry or materials.

Quick Start

Run run-operations on your asset by providing the input path and a named pipeline, for example: /run-operations /path/to/asset.usd --pipeline safe-cleanup --output /path/to/asset.optimized.usdc.

Frequently Asked Questions about run-operations

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

FAQPage Schema
How do I optimize USD scenes and save the results for validation?

You optimize USD scenes by executing an op chain from inline JSON, config files, or named pipelines, writing the optimized asset to a specified output path for subsequent validation.

What is the best way to apply geometry processing operations from validator findings to a USD asset?

Applying geometry processing from validator findings involves converting recommended fixes into a runnable operation chain, executing it on the USD stage, and generating a safe, non-destructive output asset.

Can I run long-running USD pipeline execution with logging and summaries?

Long-running USD pipeline execution is supported with logging and per-operation summaries, generating a saved run log and summary JSON to track the results of the applied scene optimization operations.

Does run-operations validate inputs and check for operation availability before executing?

Run-operations validates input paths and checks operation availability before execution, providing guardrails for correctness by prompting before destructive ops that permanently alter geometry or materials.

What are the limitations when running destructive operations on USD stages?

Destructive operations permanently alter geometry or materials, so the pipeline prompts before execution to ensure safety, though it fully supports both non-destructive and destructive pipeline configurations.

How do I use named pipelines for batch processing USD assets?

Batch processing USD assets uses named pipelines by providing the input path and pipeline name, resolving the output path, and executing the operation chain to generate optimized output artifacts with a summary JSON.