SkillsAdd

plurigrid/asi

urdf2mjcf

Convert URDF robot descriptions to MJCF format for MuJoCo simulation. Handles meshes, joints, actuators, and collision geometries.

First seen Jan 29, 2026

Installation

$ npx skills add plurigrid/asi --skill urdf2mjcf
View on skills.sh ↗ GitHub repository ↗

Also in this package

Other skills from plurigrid/asi · top by installs.

npx skills add plurigrid/asi
academic-research 164 tree-sitter 42 wev-tesseract 40 reverse-engineering 24 beeper-mcp 21 bdd-mathematical-verification 20 alife 17 backend-development 15 tizen-app-scaffold 14 canvas-design 13

Browse all from plurigrid/asi

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

Stars 62
License LICENSE
Default branch main
Open issues 3
Status Active

Skill metadata

Parsed from SKILL.md frontmatter.

Version1.0.0
LicenseMIT

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 3,136 B
  • docs SUMMARY.md 147 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 8 installs

SKILL.md

URDF2MJCF Skill

Trit: -1 (MINUS - analysis/transformation) Color: #4615B7 (Deep Violet) URI: skill://urdf2mjcf#4615B7

Overview

Convert URDF (Unified Robot Description Format) files to MJCF (MuJoCo XML Format) for simulation in MuJoCo and MJX. Handles meshes, joints, actuators, and collision geometries.

Usage

# CLI conversion
urdf2mjcf robot.urdf --output robot.mjcf

# With options
urdf2mjcf robot.urdf \
    --output robot.mjcf \
    --mesh-dir ./meshes \
    --add-actuators \
    --collision-margin 0.001
from urdf2mjcf import convert

# Programmatic conversion
mjcf_xml = convert(
    urdf_path="robot.urdf",
    mesh_dir="./meshes",
    add_actuators=True,
    collision_margin=0.001,
)

# Save to file
with open("robot.mjcf", "w") as f:
    f.write(mjcf_xml)

Features

  • Mesh Handling: Converts STL/OBJ meshes, scales appropriately
  • Joint Mapping: URDF revolute/prismatic → MJCF hinge/slide
  • Actuator Generation: Auto-generates position/velocity actuators
  • Collision Geometry: Convex decomposition, margin adjustment
  • Inertia Cleanup: Fixes common URDF inertia issues

Pipeline

┌─────────────┐    ┌─────────────┐    ┌─────────────┐
│  URDF File  │───▶│  urdf2mjcf  │───▶│  MJCF File  │
│  (ROS/SDF)  │    │  Converter  │    │  (MuJoCo)   │
└─────────────┘    └─────────────┘    └─────────────┘
       │                  │                  │
       ▼                  ▼                  ▼
   Meshes STL        Link transforms     Physics props
   Joint limits      Mass/inertia        Actuator defs
   Visual geom       Collision geom      Sensor defs

GF(3) Triads

urdf2mjcf (-1) ⊗ kos-firmware (+1) ⊗ mujoco-scenes (0) = 0 ✓

Related Skills

  • ksim-rl (-1): Uses converted MJCF for training
  • kos-firmware (+1): Robot firmware
  • mujoco-scenes (0): Scene composition
  • kbot-humanoid (-1): K-Bot robot model

References

@misc{urdf2mjcf2024,
  title={URDF to MJCF Converter},
  author={K-Scale Labs},
  year={2024},
  url={https://github.com/kscalelabs/urdf2mjcf}
}

SDF Interleaving

This skill connects to Software Design for Flexibility (Hanson & Sussman, 2021):

Primary Chapter: 7. Propagators

Concepts: propagator, cell, constraint, bidirectional, TMS

GF(3) Balanced Triad

urdf2mjcf (+) + SDF.Ch7 (○) + [balancer] (−) = 0

Skill Trit: 1 (PLUS - generation)

Connection Pattern

Propagators flow constraints bidirectionally. This skill propagates information.