A specialized technical guide for performing precise, non-destructive edits to Universal Scene Description (USD) ASCII files and leveraging official USD command-line utilities.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install usd-editor
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install usd-editor using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is USD Editor?
The USD Editor is a comprehensive framework within Openclaw Skills designed for developers and technical artists working with Universal Scene Description (USD). It provides a structured methodology for modifying .usda files, ensuring that edits to prims, properties, and composition arcs remain valid and minimal. By focusing on the technical nuances of the USD schema, this skill helps users navigate complex scene graphs without disrupting existing stage structures.
Beyond simple text editing, this skill integrates best practices for USD syntax and command-line tool usage. It emphasizes the preservation of authoring styles and file formatting, making it an essential tool for those performing surgical updates to 3D assets. Whether you are adjusting transforms or managing complex variant sets, the USD Editor ensures high-fidelity results that are compatible with professional pipelines and RealityKit environments.
USD Editor Use Cases
- Performing targeted overrides on existing USD prims using the over specifier to modify attributes without redefining the entire node.
- Adding new 3D transforms to assets while correctly maintaining the xformOpOrder for consistent spatial rendering.
- Inspecting and validating USDZ packages and .usda files using official command-line tools like usdchecker and usdcat.
- Managing material bindings and relationships (rel) to connect shaders and meshes within a USD stage.
- Editing time-sampled data for animation or adjusting stage-level metadata such as upAxis and metersPerUnit.
How USD Editor Works
- Stage Analysis: The skill begins by inspecting the .usda file structure to identify root prims, scopes, and the current SdfPath hierarchy.
- Specifier Selection: It determines the appropriate specifier to use—choosing def for creating new elements or over for modifying existing ones to maintain composition integrity.
- Delta Application: The smallest possible change is applied to the attribute or relationship to minimize diff noise and preserve original formatting.
- Transform Synchronization: If geometric transforms are added, the skill automatically ensures the xformOpOrder array is updated to reflect the new operations.
- Validation: Finally, the skill guides the user through verifying SdfPath targets and running validation tools to ensure the stage remains error-free.
USD Editor Setup
To effectively use this Openclaw Skills module, ensure you have the USD toolset installed on your system. You can verify your environment and begin inspecting files with these commands:
# Check the structure of a USD file
usdtree path/to/your/file.usda
# Validate a USDZ package for compatibility
usdchecker asset.usdz
# Open a USD file in your default text editor for official editing
usdedit path/to/your/file.usda
USD Editor Data Schema & Taxonomy
The USD Editor organizes data around the standard Sdf (Scene Data Foundation) taxonomy. The following table describes the primary data types handled:
| Element | Description | Metadata Example |
|---|---|---|
| Prim | Scene graph nodes (def/over/class) | def Xform "Model" |
| Attributes | Typed data values (double, token, int) | double3 xformOp:translate |
| Relationships | Pointers to other SdfPaths | rel material:binding |
| Composition Arcs | References, payloads, and sublayers | references = @./file.usd@ |
| List Ops | Incremental edits to arrays | prepend apiSchemas |
USD Editor Advanced Features
- Multi-layer composition support for managing complex stages involving sublayers and references.
- Advanced variant set manipulation for creating alternative asset states within a single .usda file.
- Precise SdfPath targeting for complex shader graph outputs and material interface connections.
- Integration with RealityKit-specific workflows, including validation for AR environment constraints.
- Support for list editing operations (prepend, append, delete) to modify inherited property lists safely.
SKILL.md
Loading
Related Openclaw Skills
RealityKit visionOS Developer
A specialized toolkit for developing, debugging, and optimizing RealityKit-based spatial experiences on visionOS using the Entity Component System (ECS) architecture.
Jupiter Quote
A specialized integration for retrieving optimal swap routes and real-time token pricing from the Jupiter aggregator on the Solana blockchain.
Wireshark Network Traffic Analysis
A comprehensive network diagnostic and security tool for capturing, filtering, and analyzing real-time data packets to ensure infrastructure integrity.
DDGR Search Skill
A high-performance command-line search utility that enables AI agents to query the web using the ddgr engine.
Infra Importer
A local, zero-latency reference tool providing instant access to infrastructure patterns, debugging guides, and migration workflows for AI coding agents.
YARA-X Rule Authoring
A specialized skill for authoring high-performance YARA-X rules to detect malware while minimizing false positives.
Featured*
