lula-description-generator

Generate Lula collision sphere descriptions from URDF files for Isaac Sim.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Manually creating collision sphere approximations for robot links is time‑consuming and error‑prone; this Skill automates the generation of those spheres directly from a URDF, producing a ready‑to‑use Lula robot description for Isaac Sim.

Core Features & Use Cases

  • Automated mesh repair using pymeshfix with a trimesh fallback, ensuring non‑watertight meshes can be processed.
  • Voxel‑based interior analysis followed by Euclidean distance transforms to capture geometry detail.
  • Greedy medial‑axis sphere packing that yields a set of collision spheres per link, customizable via parameters such as max_spheres_per_link and voxel_fraction.
  • Full YAML robot description output compatible with Isaac Sim’s CuMotion/RMPflow/Lula planners, supporting package:// URI resolution and optional c‑space configuration.
  • Use case: Researchers can feed any robot URDF into the skill to instantly obtain a collision‑aware description, accelerating simulation setup and motion‑planning experiments.

Quick Start

Run the lula description generator on my_robot.urdf to obtain a Lula description YAML file.

Frequently Asked Questions about lula-description-generator

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

FAQPage Schema
How do I generate collision spheres for a URDF robot model in Isaac Sim?

You can generate collision spheres from a URDF file by processing meshes, repairing geometry, voxelizing interiors, and packing spheres to produce a Lula robot description YAML for Isaac Sim motion planning.

What is the best way to create a Lula robot description YAML from a URDF file?

Creating a Lula robot description YAML from a URDF file is best automated through mesh repair, voxel-based interior analysis, and greedy medial-axis sphere packing to approximate link geometries for motion planners.

How does voxelization and mesh repair work for URDF collision sphere generation?

Mesh repair uses pymeshfix with a trimesh fallback to resolve non-watertight geometry, while voxelization applies Euclidean distance transforms to capture interior detail for accurate medial-axis collision sphere packing.

Can I control the number of collision spheres generated per robot link?

You can control collision spheres per link by adjusting parameters like max_spheres_per_link and voxel_fraction, which regulate sphere packing granularity to balance collision checking precision with computational performance.

Does the Lula description generator require watertight meshes to process URDF files?

Watertight meshes are not required because the generator applies automated mesh repair using pymeshfix and a trimesh fallback to fix non-watertight geometry before voxelizing interiors and packing collision spheres.

Why do I need collision spheres for Isaac Sim motion planning workflows?

Collision spheres are needed for Isaac Sim motion planning workflows because they provide a simplified geometric approximation of robot links, enabling efficient collision-aware path planning with CuMotion, RMPflow, and Lula planners.