joint-agent-client

Classify articulated joints in 3D USD assets via the Joint Agent REST API.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires curl, jq.

What problem does it solve?

This skill automates the complex process of classifying articulated components in 3D USD assets, removing the need for manual inspection and manual joint rigging.

Core Features & Use Cases

  • REST API Integration: Seamlessly interface with the Joint Agent service to trigger classification pipelines.
  • Pipeline Automation: Upload USD files, monitor status via events, and retrieve generated predictions, reports, and dataset artifacts.
  • Use Case: A 3D artist can use this to automatically identify revolute and prismatic joints on a robotic arm model, ensuring the asset is ready for physics simulation without manual setup.

Quick Start

Use the joint-agent-client skill to run the articulation classification pipeline on the file named robot_arm.usdz and download the resulting report.

Frequently Asked Questions about joint-agent-client

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

FAQPage Schema
How do I automate articulation classification for 3D USD assets?

You can automate articulation classification for USD assets by using a REST API to upload files, trigger VLM-based analysis, and retrieve generated predictions and reports. This removes the need for manual joint rigging and inspection.

What is VLM-based joint analysis for robotic models?

VLM-based joint analysis is an automated process that identifies articulated components, such as revolute and prismatic joints, in 3D models. It ensures assets are ready for physics simulation without requiring manual setup.

How do I retrieve prediction reports after running a USD pipeline?

To retrieve prediction reports, you monitor the pipeline status via events after uploading your USD file. Once the VLM-based analysis completes, you can download the resulting artifacts directly.

What dependencies do I need to run an automated articulation classification pipeline?

You need curl and jq installed to interface with the REST API. Additionally, you must have network connectivity and a reachable Joint Agent service to execute the end-to-end pipeline.

Can I use this API to prepare 3D assets for physics simulation?

Yes, automating the classification of articulated joints in 3D USD assets ensures models like robotic arms have correctly identified revolute and prismatic joints, making them ready for physics simulation.