urdf

Author, validate, and render URDF robot description files with frame and inertial checks.

465|41|Updated Aug 4, 2026
One-click install
npx skills add https://github.com/autonomous-ai/openharness --skill urdf-autonomous-ai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: urdf
Source: https://github.com/autonomous-ai/openharness/tree/main/store/agents/text-to-cad/skills/urdf
Command: npx skills add https://github.com/autonomous-ai/openharness --skill urdf-autonomous-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires cadgen, and includes references (resource) components.

What problem does it solve? URDF files fail silently through wrong frame placement, flipped joint axes, mismatched mesh units, and freehanded inertia values. This Skill turns URDF authoring into a disciplined kinematic modeling workflow with a design ledger, computed inertials, and automated validation. ## Core Features & Use Cases - Direct XML authoring with a design ledger: Embed frame conventions, units, mesh scales, and assumptions as a comment block inside the .urdf file so any engineer can audit it. - Structural validation: Run cadgen urdf validate to check tree topology, joint limits, mimic cycles, geometry, mesh references, and inertial physics in one pass, with --strict, --json, and --packages options. - Snapshot rendering: Render the robot to a PNG still with cadgen urdf snapshot, posing joints via --joint-values to visually verify axis signs. - Use Case: You receive STEP files for a two-link arm. Export per-link meshes, author the URDF with computed cylinder inertias, validate until clean, then sweep each joint in the CAD Viewer to confirm positive-motion direction. ## Quick Start Use the urdf skill to create and validate a URDF robot description for my two-link arm from the meshes in the 3MF folder.

Frequently Asked Questions about urdf

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

FAQPage Schema
How do I validate a URDF file for errors?

Run `cadgen urdf validate path/to/robot.urdf` to check structure, tree topology, joint limits, geometry, mesh references, and inertial physics in one pass. Use `--strict` to fail on warnings, `--json` for machine-readable output, and `--packages NAME=PATH` to resolve package:// mesh URIs.

How do I compute inertia tensors for URDF links?

Use closed-form formulas for primitives (box, cylinder, sphere) or a throwaway Python script with trimesh for mesh-derived mass properties. Never freehand inertia values; record the source or assumed density in the design ledger comment block.

Why does my URDF robot render 1000 times too large?

This is a mesh scale bug: STL and 3MF exports are often in millimeters while URDF uses meters. Add `scale="0.001 0.001 0.001"` to each mesh reference rather than adjusting joint origins.

What joint types does URDF validation support?

The bundled validator supports fixed, continuous, revolute, and prismatic joints. Floating and planar joints are rejected; use them only when your consumer and validation path explicitly support those types.

Can structural validation prove my URDF is spatially correct?

No. A URDF can pass every structural check while placing a joint in the wrong spot or with a flipped axis sign. Verify spatial correctness with the design ledger and a viewer sweep of every movable joint against its positive-motion statement.