deduplicate-hierarchies

Official

Collapse duplicate USD subtrees safely.

AuthorNVIDIA-Omniverse
Version1.0.0
Installs0

System Documentation

What problem does it solve?

Deduplicating USD scenes manually is slow and error-prone, especially when repeated prim hierarchies bloat files and increase load time.

Core Features & Use Cases

  • Hierarchy-level deduplication: Detects duplicate prim hierarchies level-by-level under the stage default prim and replaces duplicates with internal instanceable references to the first prototype.
  • Safe matching by structure + property values: Uses subtree shape, prim types, authored property names, and property-value verification to merge only truly identical hierarchies (with tolerance for float-array and scalar float/double drifts where applicable).
  • Pipeline-ready for production: Supports a canonical two-op workflow by pairing hierarchy dedup with per-mesh dedup to catch remaining identical meshes not folded at the subtree level.

Quick Start

Run deduplicate-hierarchies on your USD file by providing the full path to the asset and optionally restricting the scan to one or more prim paths.

Dependency Matrix

Required Modules

None required

Components

Standard package

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: deduplicate-hierarchies
Download link: https://github.com/NVIDIA-Omniverse/usd-optimize/archive/main.zip#deduplicate-hierarchies

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.