usd-editor

What problem does it solve?

Editing USD ASCII (.usda) files by hand is error-prone and risks breaking stage structure, composition arcs, and prim relationships. This Skill offers a safe, minimal-edit workflow that preserves formatting, respects existing composition, and reduces diffs.

Core Features & Use Cases

• Inspect the stage to identify root prims, scopes, and relevant paths before making changes.
• Choose the correct specifier (def vs over) to avoid unnecessary redefinitions.
• Edit only the minimal set of attributes or relationships, preserving xformOpOrder and formatting.
• Respect composition arcs (sublayers, references, payloads, and variants) unless explicitly requested.
• Validate paths and relationships to ensure targets exist and types match, minimizing breakages.

Quick Start

1. Locate the prim path you need to edit (e.g., </Root/Model>).
2. Decide whether to use over to modify or def to create a new prim.
3. Apply the smallest change necessary (attribute value, rel target, or child prim) and update xformOpOrder if you add transforms.
4. Re-check touched paths, references, and any affected composition arcs.