flatten-usd

Flatten USD stages into a single self-contained USD file.

179|21|Updated Apr 28, 2026
One-click install
npx skills add https://github.com/NVIDIA-Omniverse/content-agents --skill flatten-usd
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: flatten-usd
Source: https://github.com/NVIDIA-Omniverse/content-agents/tree/main/.agents/skills/flatten-usd
Command: npx skills add https://github.com/NVIDIA-Omniverse/content-agents --skill flatten-usd

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Flattening a composed USD stage into a single, portable file that can be shared, inspected, and loaded without relying on external dependencies.

Core Features & Use Cases

  • Resolve sublayers, references, payloads, and inherits to create a unified USD layer.
  • Produce a self-contained file suitable for distribution, debugging, or rendering in environments without original asset chains.
  • Use cases include handoff to colleagues, integration into pipelines, and archiving complex USD scenes.

Quick Start

Flatten a scene with the wu CLI to generate a flat USD file from scene.usd.

Frequently Asked Questions about flatten-usd

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

FAQPage Schema
How do I flatten a USD stage into a single file?

Flattening a USD stage resolves sublayers, references, payloads, and inherits into a single portable USD file. This Skill uses the wu CLI and USD Python bindings to process readable .usd, .usda, or .usdc inputs into a unified output layer.

What does resolving sublayers and payloads in USD accomplish?

Resolving sublayers, references, payloads, and inherits composes complex USD asset chains into a unified layer. This produces a self-contained file that loads without requiring external dependencies for rendering or debugging.

Can I use this to prepare USD assets for stable distribution?

Yes, you can prepare USD assets for stable distribution by flattening them into a portable file. This resolves external inherits and references, ensuring the scene loads independently for colleague handoffs or archiving.

What do I need to flatten USD files with the wu CLI?

To flatten USD files with the wu CLI, you need readable .usd, .usda, or .usdc input assets and write permission for a destination file. The environment also requires USD Python bindings to resolve stage composition.

When should I avoid flattening a composed USD scene?

Avoid flattening a composed USD scene when you need to preserve live references or inherits for ongoing pipeline edits. Flattening bakes these compositions into a single static layer, removing the ability to update original asset chains dynamically.