URDF Validator & Fixer

Validate URDF files and fix common issues for Isaac Sim compatibility.

7|1|Updated Mar 13, 2026
One-click install
npx skills add https://github.com/hkqai/MatClaw --skill urdf-validator-fixer-hkqai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: URDF Validator & Fixer
Source: https://github.com/hkqai/MatClaw/tree/main/skills/urdf-validator
Command: npx skills add https://github.com/hkqai/MatClaw --skill urdf-validator-fixer-hkqai

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires isaacsim, omni, pxr, carb, and includes scripts (resource) components.

What problem does it solve?

URDF files often contain naming violations, missing inertial data, and broken mesh references that cause silent failures when importing into Isaac Sim, requiring time‑consuming manual fixes.

Core Features & Use Cases

  • Inspection: Provides a quick structural overview of links, joints, and mass distribution.
  • Validation: Detects USD naming issues, duplicate materials, infinite joint limits, missing inertial properties, and broken mesh references.
  • Auto‑fix: Automatically renames entities, adds default inertial values, clamps joint limits, and deduplicates materials, producing a new URDF without modifying the original.
  • Re‑validation: Confirms that all auto‑fixable problems are resolved, ensuring a clean import into Isaac Sim.

Quick Start

Request the URDF validator to inspect, validate, and fix 'robot.urdf' and return the path of the fixed file.

Frequently Asked Questions about URDF Validator & Fixer

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

FAQPage Schema
How do I fix URDF import errors in Isaac Sim?

To fix URDF import errors in Isaac Sim, you need to validate the file and auto-fix common issues like missing inertial data, naming violations, and broken mesh references. This validator resolves these problems automatically, producing a new URDF file for smooth imports.

Why does my URDF file fail to import into Isaac Sim silently?

URDF files fail silently during Isaac Sim imports due to common structural issues like duplicate materials, infinite joint limits, or missing inertial properties. Validation detects these conflicts, and auto-fix rewrites the file to ensure a clean, error-free import.

How do I add missing inertial data to a URDF file?

To add missing inertial data to a URDF file, use an auto-fix tool that applies configurable default masses and inertia values. This ensures the robotic model meets simulation requirements without requiring manual calculations or modifying the original file.

Can I validate a URDF for robotics simulation without altering the original file?

Yes, you can validate a URDF for robotics simulation without altering the original file by using an auto-fix function that generates a new, corrected URDF. This preserves your source data while providing a clean version for Isaac Sim.

Does Isaac Sim support URDF files with infinite joint limits?

Isaac Sim does not handle URDF files with infinite joint limits well. You must validate the URDF to detect these limit errors and apply an auto-fix to clamp joint limits to valid numerical ranges for proper simulation behavior.

What is the best way to check a URDF for broken mesh references before simulation?

The best way to check a URDF for broken mesh references before simulation is to run a validation script. It inspects links, joints, and mass distribution, detects missing mesh paths, and auto-fixes the references to ensure successful imports.