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