urdf-geometry

Guide geometry selection for robot links in URDF files.

15|7|Updated Sep 27, 2024
One-click install
npx skills add https://github.com/Ranch-Hand-Robotics/rde-urdf --skill urdf-geometry
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: urdf-geometry
Source: https://github.com/Ranch-Hand-Robotics/rde-urdf/tree/main/.github/skills/urdf-geometry
Command: npx skills add https://github.com/Ranch-Hand-Robotics/rde-urdf --skill urdf-geometry

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill helps users select and create appropriate geometry for robot links in URDF files, guiding them through the decision-making process between basic shapes, OpenSCAD models, and mesh files.

Core Features & Use Cases

  • Geometry Selection Guidance: Provides a decision tree to choose the best geometry type (basic shapes, OpenSCAD, mesh).
  • OpenSCAD Integration: Facilitates the creation and referencing of custom shapes using OpenSCAD.
  • Mesh File Handling: Guides on using and referencing existing mesh files (STL, DAE, OBJ).
  • Best Practices: Offers advice on optimizing geometry for visual and collision purposes.
  • Use Case: When defining a new robot arm link, this skill helps determine if a simple <box> is sufficient, or if a custom shape defined in OpenSCAD or an existing mesh file is more appropriate.

Quick Start

Use the urdf-geometry skill to help decide on the best way to create a wheel for a robot.

Frequently Asked Questions about urdf-geometry

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

FAQPage Schema
How do I choose between basic shapes, OpenSCAD, and mesh files for URDF robot geometry?

URDF robot geometry selection depends on complexity: use basic shapes like `<box>` for simple links, OpenSCAD for parametric custom shapes, and mesh files like STL or DAE for detailed existing models. A decision tree helps determine the most appropriate approach based on your specific link requirements.

What is the best way to optimize visual and collision geometry in a URDF file?

URDF geometry optimization involves applying best practices separately to visual and collision elements. Simplified collision geometry improves simulation performance, while detailed visual geometry enhances rendering. This skill provides guidance on balancing both for optimal robot model integration.

Can I use OpenSCAD to create custom shapes for URDF robot links?

OpenSCAD integration for URDF links allows you to create and reference programmatic custom shapes. This approach is ideal when basic shapes are insufficient but you need parametric control over the geometry rather than importing a static mesh file.

How do I reference existing STL or DAE mesh files in URDF geometry?

Mesh file handling in URDF involves referencing existing STL, DAE, or OBJ files within your robot link definitions. This skill guides proper integration with URDF tooling to ensure mesh files are correctly referenced and optimized for both visual and collision purposes.

When should I use a simple box instead of a mesh for a robot arm link in URDF?

A simple `<box>` in URDF is sufficient for robot arm links when the shape is primitive and does not require detailed contours. Using basic shapes reduces computational overhead compared to mesh files, making it preferable for both visual and collision geometry when feasible.