URDF Fundamentals

Source: ros2-copilot-skills URDF fundamentals skill

Why This Matters

URDF is the structural description that many other ROS 2 tools quietly depend on. If the model is confused, TF, visualization, planning, and simulation all become harder to trust.

Distilled Takeaways

• URDF describes the robot as links and joints with geometry and physical properties.
• A good URDF is both a kinematic model and a communication tool for the rest of the stack.
• Clean naming and realistic structure matter more than visual completeness alone.
• Robot modeling errors usually show up downstream in places that look unrelated at first.

Practical Guidance

• Build the URDF around real robot structure, not only what looks tidy in XML.
• Validate the model in RViz and TF before depending on it elsewhere.
• Keep frames, joint names, and dimensions consistent across code and hardware.
• Treat the robot model as maintained infrastructure, not a one-time file.

Start Here

• For the structural XML model of links, joints, and the robot root: URDF Links, Joints, and the Robot Tree
• For frame-centric reasoning: URDF as a Frame Translation System
• For reuse and modularity: Xacro Macros for Robot Models

Corroborating References

• URDF tutorials
• robot_state_publisher repository

When to Read the Original Source

Go to the original skill when you want the practical orientation to URDF concepts and the reminders that make the rest of the robot-model pipeline easier to reason about.