omniverse-asset-to-usd

name	omniverse-asset-to-usd
description	Use when a user asks to install, build, package, document, troubleshoot, modify, or run usd-convert-asset to convert supported 3D assets to Pixar USD.
version	0.1.0
license	Apache-2.0 AND CC-BY-4.0
metadata	{"author":"NVIDIA Corporation","tags":["omniverse","openusd","converter","cli","assets"]}
tools	["Read","Edit","Shell"]

Omniverse Asset to USD

usd-convert-asset is a pip-installable Python package and CLI for converting supported 3D assets into Pixar USD formats for Omniverse and other USD-based pipelines.

Route First

Load the narrowest module that matches the user's task:

• For installation, package verification, source builds, wheel packaging, or first-run smoke tests, read omniverse-asset-to-usd-getting-started/SKILL.md.
• For asset conversion, supported formats, CLI flag selection, conversion verification, or conversion troubleshooting, read omniverse-asset-to-usd-asset-conversion/SKILL.md.
• For code changes, packaging changes, docs updates, smoke tests, or contribution workflow, read omniverse-asset-to-usd-contributing/SKILL.md.

Use This Skill For

• Install, verify, build, or troubleshoot the usd-convert-asset package.
• Convert .fbx, .obj, .gltf, .glb, .stl, or .ply assets to .usd, .usda, .usdc, or .usdz.
• Choose CLI flags for materials, animation, mesh handling, FBX up-axis conversion, stage up-axis, texture embedding, progress, or debug logging.
• Update code, docs, tests, packaging, or release behavior for asset-to-USD conversion workflows.

Do not use this skill for Gaussian Splat, URDF, CAD-native, or unrelated USD workflows unless usd-convert-asset is the relevant converter.

Core Constraints

1. Prefer the published usd-convert-asset Python wheel for end-user conversion tasks.
2. Build from source only when the published package is unavailable for the target environment, or when the user is changing this repository.
3. Validate source and destination formats before invoking the converter.
4. Keep CLI examples, README snippets, and smoke tests aligned when flags, entry points, install flow, or package metadata change.