stage-queries

Discover prims on a runtime stage and inspect attribute schemas.

201|25|Updated Dec 18, 2025
One-click install
npx skills add https://github.com/NVIDIA-Omniverse/ovrtx --skill stage-queries
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: stage-queries
Source: https://github.com/NVIDIA-Omniverse/ovrtx/tree/main/.agents/skills/stage-queries
Command: npx skills add https://github.com/NVIDIA-Omniverse/ovrtx --skill stage-queries

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Discovering prims on the runtime stage and inspecting their attribute schemas to understand structure and readiness for read/write operations.

Core Features & Use Cases

  • Discover prims by type and existence of attributes.
  • Inspect attribute schemas to determine data types and semantics.
  • List all prims on the stage and prepare result handles for subsequent read/write calls.

Quick Start

Run a stage query to list prims or filter by type and attributes before performing read/write operations.

Frequently Asked Questions about stage-queries

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

FAQPage Schema
How do I query USD stage prims by type and attribute presence?

To query USD stage prims, you can apply filters by prim type or attribute presence to discover specific elements on the runtime stage. This returns grouped result handles for subsequent read or write operations.

What does inspecting USD attribute schemas tell you about a prim?

Inspecting USD attribute schemas reveals the data types and semantics of prim attributes. This determines the structure and readiness of prims for read or write operations before you execute them.

Can I use stage queries with both Python and C/C++ environments?

Yes, querying stage prims and inspecting attribute schemas supports both Python and C/C++ usage. This allows you to integrate prim discovery into various automation workflows across different environments.

What is the best way to list all prims on a USD stage before reading or writing attributes?

The best way to list all prims is to run a stage query that returns grouped results with prim_list_handles. These handles can then be directly fed into read_attribute or write_attribute calls.

Why do I need to inspect attribute schemas before performing read or write operations on a USD stage?

You need to inspect attribute schemas to understand the data types and structure of prims on the stage. This ensures the prims are ready and correctly formatted for your read or write operations.

Does querying prims by attribute existence support filtering for specific automation tasks?

Yes, querying prims by attribute existence supports filtering for specific automation tasks. You can discover prims based on the presence of attributes to prepare result handles for targeted operations.