Skip to content

docs: route CAD conversion requests to the canonical usd-convert-cad skill #802

Closed

Description

@komalilyas

Description

The Omniverse Realtime Viewer routing guide directs CAD conversion requests to cad2usd without an organization, repository URL, or exact skill path. Five locations repeat this ambiguous handoff.

A maintained public CAD conversion entry exists at NVIDIA-Omniverse/usd-convert-cad — omniverse-cad-to-usd. Its guidance describes the standalone usd-convert-cad wheel and supported platforms. An agent should be directed to this maintained entry instead of being asked to infer what checkout cad2usd means.

Affected Page or File

skills/omniverse-realtime-viewer/references/routing.md

The five occurrences are in:

  1. Intent-Based Routing — CAD import / STEP/IGES conversion.
  2. Capability-Based Routing — CAD-to-USD conversion.
  3. Decision Tree — CAD file import.
  4. Dependencies Model — cad2usd dependency row.
  5. Supplemental Guidance — clone/skills handoff.

Issue Type

Unclear or confusing

Suggested Fix

Replace these ambiguous references with the canonical NVIDIA-Omniverse/usd-convert-cad repository URL and skills/omniverse-cad-to-usd/SKILL.md entry. Delegate installation, supported versions/platforms and conversion options to that maintained skill rather than duplicating them in the viewer routing guide.

This change belongs in Hub routing; no converter implementation change is requested.

Acceptance Criteria

  • All five routing locations identify the canonical repository and exact skill entry.
  • A representative request such as “Convert a STEP assembly to USD and check scale and hierarchy” reaches that entry without a repository-name guess.
  • Installation instructions remain consistent with the maintained upstream skill.
  • Record link/discovery verification separately from any conversion execution result.

Verification Scope

Public routing and the canonical upstream skill were inspected on 2026-10-30. This is a documentation finding; no blind-agent discovery evaluation or CAD conversion was executed.

Please identify the routing maintainer, link any existing fix, and provide a target date if available.

Checklist

  • I searched existing issues and this is not a duplicate. Searches for CAD and cad2usd found no matching routing issue; the returned CAD-to-SimReady dependency-packaging issue concerns a different problem.

Activity

  1. mosheabr commented on Nov 6, 2026

    @mosheabr
    Collaborator

    Fixed in #840 (omniverse-realtime-viewer 0.3.0). All five CAD routes in references/routing.md now point to the maintained omniverse-cad-to-usd skill in NVIDIA-Omniverse/usd-convert-cad. Thanks for the report!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions