Generated banner for Omniverse Cad To Simready
Generated logo for Omniverse Cad To Simready

Omniverse Cad To Simready

NVIDIAOfficialCreated by OmniverseDistributed by NVIDIA

  • Skill
  • Workflow
  • Software development
  • Apache-2.0
  • Medium risk
  • Has scripts

From the author

Coordinate the end-to-end CAD/source-asset to SimReady workflow. Use for broad requests such as CAD to SimReady, source asset to simulation-ready USD, or prop packaging that require conversion, material/physics assignment, SimReady conformance, validation, and optional package creation; deploy or verify Content Agents services first when property assignment is enabled; route single-stage work through nested references.
— the description by Omniverse

AutoGineer summary

Written by AutoGineer from the skill’s own files, not by the author

This skill acts as an orchestrator for the CAD to SimReady pipeline, coordinating a series of specialized stages including asset conversion, material and physics assignment via Content Agents, validation, and final packaging. It is designed to manage the flow between discrete tools rather than replacing them, ensuring that assets meet specific simulation requirements through a structured, documentation-driven process.

What it does

  • Coordinates end-to-end conversion from source CAD or mesh assets to SimReady USD.
  • Manages property assignment for materials and physics using Content Agents.
  • Performs multi-stage validation gates to ensure asset viability and conformance.
  • Automates the assembly of deliverable packages including thumbnails and USD dependencies.
  • Provides consolidated reporting on workflow status, validation findings, and stage outputs.
  • Supports flexible execution modes including conversion-only and validation-only paths.

When to use it

  • When you need to transform raw CAD or source assets into simulation-ready USD files.
  • When you require automated material and physics assignment for 3D assets.
  • When you need to validate assets against SimReady conformance profiles.
  • When you are preparing assets for packaging and distribution in a simulation environment.

Advantages

  • Provides a structured, repeatable pipeline for complex asset preparation.
  • Integrates multiple specialized stages into a cohesive workflow.
  • Ensures consistent validation and conformance across the asset lifecycle.
  • Supports modular execution by allowing specific stages to be skipped or isolated.

Usage examples

“Convert my CAD file at /path/to/model.step to a SimReady asset.”
The agent will initiate the preflight check, convert the file to USD, apply material and physics properties, validate the result, and output a report.
“Validate this existing USD file for SimReady conformance.”
The agent will run the validation-only workflow, checking the provided USD against SimReady profiles and reporting any findings.

Install

  1. Download the skill as a ZIP:

    https://mp-staging.autogineer.com/agent-skills/nvidia/omniverse-cad-to-simready/download
  2. Unzip it into the cross-client skills folder of your project:

    mkdir -p .agents/skills && unzip omniverse-cad-to-simready.zip -d .agents/skills

Documentation by Omniverse

CAD to SimReady

When to Use

Use this workflow skill for an end-to-end pipeline from a source asset to a SimReady asset or package. It coordinates existing conversion, authoring, validation, conformance, rendering, and packaging references directly; do not replace it with a single monolithic runner command.

This skill is documentation-driven and does not ship scripts/run.py; it must not depend on a repository checkout. Shell is declared because this workflow invokes installed stage reference scripts directly, from each reference's installed directory, and it still must not grow a monolithic runner.

Prerequisites

  • Prefer preflight first for deterministic setup: it installs/verifies local upstream checkouts, writes a cad-to-simready-preflight.json manifest, and exports PHYSICAL_AI_PREFLIGHT_MANIFEST plus PHYSICAL_AI_REQUIRE_PREFLIGHT=1 for downstream references.

  • Python 3.12 and uv (per repo README.md).

  • A Content Agents model provider key when local deployment will run, or explicit endpoint variables plus usage tokens for already-running endpoints; see references/preflight/README.md for the full list.

  • Docker, NVIDIA Container Toolkit, and an NVIDIA GPU for Content Agents and OVRTX stages.

  • Local upstream checkouts under ${OMNIVERSE_CAD_TO_SIMREADY_UPSTREAM_ROOT:-$HOME/.omniverse-cad-to-simready/upstreams} when a stage needs upstream scripts or specs.

First Action

For any broad CAD/source-asset to SimReady request, assume property_assignment_intent=run unless the user explicitly asks for conversion-only, validation-only, or no material/physics assignment. For conversion-only requests, set property_assignment_intent=skip, do not deploy Content Agents, run convert-to-usd, then run validate-usd-minimum on the generated USD if conversion succeeds. For validation-only requests, set property_assignment_intent=skip and validate the USD the user provided without rerunning conversion.

Run preflight (or verify an existing PHYSICAL_AI_PREFLIGHT_MANIFEST) before any converter, validation, Content Agents, OVRTX, packaging, or FET step; treat it as dependency bootstrap, not workflow routing. Use --skip-content-agents for conversion-only/validation-only requests.

When property_assignment_intent=run, verify or deploy Content Agents services immediately after confirming the source path and resolving intent, before asset-context inspection, converter dependency checks, conversion, validation, conformance, rendering, packaging, or upstream source builds. Treat explicitly provided healthy endpoints as user-owned; otherwise run deploy-content-agents, which deploys the shared standalone OVRTX renderer, then Material, Physics, and optional Texture service containers in order.

Instructions

  1. Confirm the source asset path exists, resolve output_root, and classify the request as end-to-end, conversion-only, validation-only, or packaging.

  2. Resolve property_assignment_intent before running any asset inspection, converter probe, conversion, validation, conformance, rendering, or packaging step.

  3. Run preflight for the selected workflow targets, unless a ready PHYSICAL_AI_PREFLIGHT_MANIFEST is already configured. Source the generated env file before running downstream scripts. Treat preflight as dependency setup only: it may use a provided --source-asset, --source-format, or --conversion-tools value to scope dependency checks, but convert-to-usd and the upstream converter references still decide actual conversion support.

  4. Verify or deploy Content Agents services first when property_assignment_intent=run; block on missing authentication or unhealthy services instead of continuing.

  5. Read references/workflow.md and references/commands.md, then run only the stage references needed for the current request.

  6. Run identify-asset-context on the original source asset when web search is available or property assignment will run.

  7. Route the source through convert-to-usd, or skip conversion for existing USD input and treat the source path as the current USD path.

  8. Run validate-usd-minimum before expensive downstream work. Treat this as a viability gate only: record unit/profile issues such as metersPerUnit != 1.0, but do not run simready-conform-profile, FET001, or any other FET repair before Content Agents assignment when property assignment will run.

  9. Run Content Agents material, physics, and optional texture assignment on the converted/minimum-valid USD when requested or required.

  10. Run simready-conform-profile on the latest simulation USD path after property assignment and preserve every selected FET repair report.

  11. Run validation gates in order: omni-asset-validate, omni-asset-validate-geometry, omni-asset-validate-physics, and simready-validate.

  12. Rerun simready-conform-profile when simready-validate reports a repairable requirement, then rerun profile validation on the newest authored USD.

  13. Run ovrtx-render-service when preview, thumbnail, or inspection images are requested. When package outputs are requested, run assemble-package-source next to create the clean deliverable/ package source from the final USD and thumbnail, then run nv-core-package-sample and nv-core-package-sample-validation on that deliverable folder only.

  14. Emit the consolidated workflow report with the final USD path, all stage reports, validation findings, rerun reasons, and next work.

Output Format

Emit a consolidated workflow report in Markdown, and include JSON when the workflow writes structured artifacts. Report overall status as passed, blocked, failed, or needs_rerun. See references/workflow.md for the required Markdown and JSON report fields.

Detailed References

Read only the references needed for the current request:

  • references/preflight/README.md: deterministic local setup, manifest/env contract, wrappers, deployment opt-out, and guardrail behavior.

  • references/workflow.md: inputs, source routing, detailed workflow, validation policy, output report fields, and next steps.

  • references/commands.md: concrete portable script command patterns.

  • references/assemble-package-source/README.md: two-zone package source assembly, root USD naming, thumbnail placement, and deliverable checks.

  • references/troubleshooting.md: symptom/cause/fix table plus FET (GSP.001/RB.MB.001) repair-routing detail.

  • references/publishing-layout.md: frontmatter compatibility-field notes and layout rationale for this skill's own file tree.

Publishing Layout Notes

Use skills/omniverse-cad-to-simready/ as the source of truth for this product repo's skill. The .agents/skills symlink is a compatibility alias for local agentskills.io-style discovery, and the nested references/ tree is intentional. See references/publishing-layout.md for the alias list, frontmatter field placement, and flattening rules.

Limitations

  • This workflow coordinates existing conversion, property assignment, conformance, validation, rendering, and packaging skills; it does not replace them with a single monolithic runner command.

Troubleshooting

Read references/troubleshooting.md only when a specific stage or validation gate is failing; it owns the symptom/cause/fix table and FET repair routing.

Hard Rules

  • Prefer the preflight manifest for local upstream roots, converter executables, SimReady validation runtime, OVRTX endpoint, and Content Agents service URLs. When PHYSICAL_AI_REQUIRE_PREFLIGHT=1 is set, do not bypass the manifest with direct upstream discovery.

  • Do not run asset inspection, converter probes, local upstream builds, conversion, validation, conformance, rendering, or packaging before Content Agents readiness when property assignment will run.

  • Use stage-specific installed reference scripts directly. Do not add or call a single omniverse-cad-to-simready runner command.

  • For source conversion, delegate to the convert-to-usd reference; do not substitute another converter for CAD or mesh formats.

  • For property assignment, use Content Agents references as separate atomic steps: material first, then physics, then texture only when requested.

  • When property assignment will run, do not run simready-conform-profile or any FET helper before Content Agents. Validate minimum USD first, then run Content Agents on that converted/minimum-valid USD, then apply FET repairs to the latest service-authored USD.

  • When property assignment will run, do not run simready-validate or any SimReady profile validation before Content Agents. The only validation gate allowed before service calls is validate-usd-minimum, which is a basic USD viability check.

  • Stop at the first failing deployment, conversion, property-assignment, or conformance authoring gate unless the user explicitly asks for best-effort continuation.

  • Do not stop at validation findings after a meaningful USD artifact exists. Continue remaining diagnostic gates and mark the result needs_rerun.

  • Do not leave a GSP.001 profile failure as an unclassified final finding. Route it to upstream simready-foundation-conform-fet-005-simulate-grasp-physics; if the current agent cannot inspect renders or no explicit grasp points are available, report a blocked FET005 repair with the visual evidence path or missing input reason.

  • Preserve every stage report and pass the concrete output USD path from each report into the next stage.

Files

references/simready-validate/README.md

SimReady Validate Profile

When to Use

Use this reference after Content Agents assignment, post-assignment simready-conform-profile, validate-usd-minimum, and omni-asset-validate have run, and the user has selected, or needs help selecting, a SimReady Foundation profile. This is a validation-only skill: it reports profile conformance and blockers, but does not repair or stamp assets unless explicitly requested. For end-to-end CAD-to-SimReady workflows where material/physics assignment will run, do not run this reference before Content Agents. The only pre-assignment validation gate should be validate-usd-minimum.

SimReady Foundation organizes validation in four layers:

  • Requirements: atomic checks such as UN.006 or VG.MESH.001

  • Capabilities: grouped requirements such as units or geometry

  • Features: use-case bundles such as FET001_BASE_NEUTRAL

  • Profiles: named bundles of features such as robotics prop or robot-body profiles

Dependency Check

Require:

  • Prefer a ready PHYSICAL_AI_PREFLIGHT_MANIFEST from the preflight reference. This wrapper consumes the prepared SimReady Foundation root and simready-validate executable from that manifest before falling back to direct legacy discovery. When PHYSICAL_AI_REQUIRE_PREFLIGHT=1 is set, missing profile-validation readiness blocks at the preflight guardrail.

  • simready.validate / simready-validate from NVIDIA SimReady Foundation, or a source checkout with requirements.txt or nv_core/validator_sample/requirements.txt

  • Upstream source: https://github.com/NVIDIA/simready-foundation pinned by upstream-versions.lock.json to v2026.04.1

  • Deterministic OpenUSD runtime: NVIDIA OpenUSD Exchange SDK package usd-exchange==2.3.0 from https://github.com/NVIDIA-Omniverse/usd-exchange, with the complete SimReady venv package set pinned in the same manifest

  • SimReady Foundation spec files: capabilities/, features/, and profiles/profiles.toml

Check installed reference dependencies with:

python3 scripts/check_dependencies.py --report dependency-check.json

If --foundation-root, --foundation-spec-root, SIMREADY_FOUNDATION_ROOT, and SIMREADY_FOUNDATION_SPEC_ROOT are not configured and no installed simready.validate specs are available, provide a checkout under $HOME/.omniverse-cad-to-simready/upstreams/simready-foundation or $OMNIVERSE_CAD_TO_SIMREADY_UPSTREAM_ROOT/simready-foundation, checked out to the manifest pin (v2026.04.1), and load nv_core/sr_specs/docs plus nv_core/validator_sample from that checkout.

If simready-validate is not on PATH, do not stop there. scripts/run.py installs the exact runtime set from upstream-versions.lock.json into a dedicated venv and verifies the installed distribution versions before using that executable. Override the venv with PHYSICAL_AI_SIMREADY_VALIDATE_VENV; otherwise the default is $XDG_CACHE_HOME/omniverse-cad-to-simready/simready-validate-venv or $HOME/.cache/omniverse-cad-to-simready/simready-validate-venv.

This locked runtime is also the Linux aarch64 solution: usd-exchange==2.3.0 provides OpenUSD Python modules and shared libraries, and simready-validate==2026.4.8 is installed with --no-deps. The manifest pins omniverse-asset-validator==1.18.0, omniverse-usd-profiles==1.10.22, and every transitive package used by that venv, preventing a future resolver run from silently selecting an incompatible combination.

Do not fall back to local profile presets or direct omni_asset_validate feature/capability flags for validation. Report BLOCKED when the executable is unavailable, no usable Foundation checkout/spec root exists, the locked runtime cannot be installed, or the installed versions do not match the manifest.

Target Selection

Supported formal profiles are loaded from SimReady Foundation profiles.toml. The default profile is:

Use --list-profiles to expose selectable profile options before running validation:

simready-validate --list-profiles --foundation-root /path/to/simready-foundation

Recognize these common profile names:

ProfileUse
Prop-Robotics-NeutralNeutral robotics prop profile.
Prop-Robotics-PhysxRobotics prop with PhysX rigid-body simulation requirements.
Prop-Robotics-IsaacIsaac Sim-oriented robotics prop profile.
Robot-Body-NeutralNeutral robot body profile.
Robot-Body-RunnableRunnable robot body profile with PhysX/articulation/drive requirements.
Robot-Body-IsaacIsaac Sim robot body profile.

For URDF or MuJoCo robot assets, prefer Robot-Body-Runnable unless the user names another profile. For generic CAD/mesh props, prefer the default Prop-Robotics-Neutral. Use Prop-Robotics-Physx when the user asks for PhysX-specific prop validation.

Instructions

  1. Confirm the asset is an existing USD asset path.

  2. Confirm Content Agents and post-assignment conformance have already run when property assignment is in scope. If the request is explicitly validation-only or property assignment was skipped, record that exception.

  3. Confirm earlier validation has passed, or state that minimum USD and generic Asset Validator checks should run first.

  4. Select a formal SimReady Foundation profile from user intent and asset type.

  5. Resolve the SimReady Foundation source checkout from --foundation-root or SIMREADY_FOUNDATION_ROOT; alternatively resolve specs from --foundation-spec-root or SIMREADY_FOUNDATION_SPEC_ROOT. If no path is configured, use $OMNIVERSE_CAD_TO_SIMREADY_UPSTREAM_ROOT/simready-foundation or $HOME/.omniverse-cad-to-simready/upstreams/simready-foundation, checked out to the ref pinned in upstream-versions.lock.json.

  6. Run this reference's portable scripts/run.py, which installs and verifies the locked SimReady runtime when the CLI is missing on PATH, then uses Foundation simready-validate behavior to load Foundation capabilities, features, and profiles/profiles.toml.

  7. Parse profile, feature, requirement, issue, warning, and error results from the Foundation validation runtime.

  8. Inspect the asset topology with OpenUSD. Treat RB.MB.001 as non-blocking when the asset has only one mesh component or one GeomSubset component, because there is no reusable multi-body component structure to promote. Preserve the ignored issue under ignored_issues, add a warning, and pass the profile if no other failures remain.

  9. Fail when any selected profile feature fails or any issue has ERROR or FAILURE severity after applying the single-component RB.MB.001 policy.

  10. Report a structured SimReady profile validation result.

CLI Pattern

Prefer the installed reference-local script for runtime checks:

python3 scripts/run.py asset.usda \
  --profile Prop-Robotics-Neutral \
  --report report.json

SIMREADY_FOUNDATION_ROOT=/path/to/simready-foundation \
  python3 scripts/run.py asset.usda --profile Prop-Robotics-Neutral --report report.json

python3 scripts/run.py asset.usda \
  --profile Robot-Body-Runnable \
  --foundation-root /path/to/simready-foundation \
  --report report.json

Do not use --fix, --stamp, or profile adaptation unless the user explicitly asks for those operations.

When running from outside the reference directory, use the installed reference path:

python3 /path/to/skills/omniverse-cad-to-simready/references/simready-validate/scripts/run.py asset.usda --profile Prop-Robotics-Neutral --report report.json

Output Format

Reports should follow:

scripts/report_schema.json

Include:

  • asset_path

  • validator_skill

  • validator_tool

  • passed

  • status

  • profile_name

  • profile_target

  • command

  • available_profiles

  • profile_results

  • feature_results

  • requirement_counts

  • issue_counts

  • issues

  • ignored_issues

  • asset_topology

  • validation_policy

  • warnings

  • errors

  • next_step

Pass/Fail Policy

Fail when:

  • required validator dependencies are missing

  • the selected SimReady Foundation profile is unknown or not present in profiles.toml

  • the Foundation validation runtime returns FAIL or ERROR

  • any issue has severity ERROR or FAILURE after the single-component RB.MB.001 policy is applied

  • any selected feature reports failed requirements after the single-component RB.MB.001 policy is applied

Warn when:

  • the target is narrower than the user's stated use case

  • profile stamping or adaptation is requested but not available in the runtime

  • RB.MB.001 is ignored as non-blocking because the USD has only one mesh component or one GeomSubset component

Next Steps

Use this handoff:

ResultNext step
Passes selected profileReport validation result and preserve the JSON report.
Fails selected profile featureSend issues to a post-assignment repair loop through simready-conform-profile, then rerun this reference on the newest authored USD.
SimReady Foundation runtime blockedProvide the manifest-pinned simready-foundation checkout with --foundation-root or SIMREADY_FOUNDATION_ROOT, then retry so scripts/run.py can install and verify the exact runtime from upstream-versions.lock.json.

Requirements and compatibility

Works with: Claude Code, Claude apps, OpenAI Codex, GitHub Copilot, Cursor, Gemini CLI, Kiro, OpenCode, Goose, Amp, Roo Code, JetBrains Junie, Factory Droid, Devin (ex-Windsurf), Mistral Vibe, OpenHands, Letta

“Works with” means the tool reads the open Agent Skills format; a skill written for one tool may use features others lack.

Needs: Declares allowed tools, Needs Python

The author says: Orchestrator skill. Managed Content Agents deployment requires a configured model provider key matching the selected backend, such as NVIDIA_API_KEY, OPENAI_API_KEY, ANTHROPIC_API_KEY, GOOGLE_API_KEY, or GEMINI_API_KEY, Docker + NVIDIA Container Toolkit + GPU, Python 3.12, and an upstream checkout of nvidia-omniverse/content-agents at the ref pinned in upstream-versions.lock.json. Reused/provided endpoints may instead use explicit endpoint and usage-token environment variables. Linux/macOS only.

Security

What our scanner noticed· Medium risk

  • Large base64-encoded blobs
  • Instructions that use the network
  • Downloads piped into a shell
  • Scripts that your agent may run

This skill includes scripts that your agent may run. Read them before you use it.

A static scan is not a guarantee. Skills are third-party content: review a skill before you let an agent use it.

Attribution and licence

Created by
Omniverse
Publisher
NVIDIA (Official)
Distributed by
NVIDIA
Source
NVIDIA/skills · skills/omniverse-cad-to-simready · commit fce3cca
Licence
Apache License 2.0 (redistribution allowed)
  • LICENSE (added by AutoGineer from LICENSE-APACHE)
  • ATTRIBUTION.md (written by AutoGineer)
Synced

AutoGineer is not affiliated with or endorsed by Omniverse or NVIDIA.

Download ZIP

The ZIP holds the skill’s files, its licence files and an ATTRIBUTION.md. Download omniverse-cad-to-simready.zip