validate-robot

Run dynamics validation and smoke tests on robosuite robot XMLs.

Updated Sep 9, 2024
One-click install
npx skills add https://github.com/axel-kaliff/dotfiles --skill validate-robot
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: validate-robot
Source: https://github.com/axel-kaliff/dotfiles/tree/main/claude/.claude/skills/validate-robot
Command: npx skills add https://github.com/axel-kaliff/dotfiles --skill validate-robot

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Detects dynamics and simulation issues in robosuite robot XMLs that cause unstable solvers, placeholder inertias, gravity-driven divergence, stuck actuators, or NaN/Inf during simulation, reducing time spent debugging low-level physics and controller problems.

Core Features & Use Cases

  • Locates robot XMLs from cache or project source to ensure the correct model is validated.
  • Extracts joint names and initial joint positions from registration files and XML to provide accurate inputs to validation tools.
  • Runs deterministic dynamics validation and optional smoke tests to surface solver stability, mass sanity, gravity stability, actuator response, and OSC tuning issues.
  • Reports each check as PASS/FAIL with key metrics and targeted remediation tips for common failure modes such as impratio conflicts, placeholder inertias, or insufficient ctrlrange.
  • Use Case: when porting a robot to robosuite or after editing an XML, run this workflow to catch physics regressions before integration testing.

Quick Start

Run validate-robot with the robot name and optional XML path to perform dynamics validation and smoke tests and return a PASS/FAIL summary with remediation suggestions.

Frequently Asked Questions about validate-robot

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

FAQPage Schema
How do I validate robosuite robot XML for physics and dynamics errors?

Dynamics validation runs deterministic checks on robosuite robot XMLs to detect solver instability, placeholder inertias, gravity-driven divergence, actuator failures, and NaN/Inf issues. It extracts joint names and initial qpos from registration files to provide accurate inputs.

Why does my robosuite robot simulation diverge or produce NaN values?

Simulation divergence and NaN/Inf issues often stem from placeholder inertias, solver instability, or gravity-driven divergence. Running a dynamics validation smoke test surfaces these specific physics failures and provides targeted remediation tips for each failed check.

What is the best way to catch physics regressions when porting a robot to robosuite?

Running dynamics validation and smoke tests after XML or physics changes catches regressions before integration testing. The workflow locates the correct cached robot XML, extracts joint lists from registration files, and reports PASS/FAIL results with actionable suggestions.

Can I run a smoke test on a robosuite robot to check actuator response and solver stability?

Yes, smoke tests run alongside dynamics validation to surface solver stability, mass sanity, gravity stability, and actuator response issues. The test operates on cached robot XMLs or source files and reports each check as PASS or FAIL.

Do I need a registration file to run dynamics validation on a robosuite robot XML?

Yes, the validation workflow requires locating the correct XML and registration file to extract joint names and initial qpos. These extracted values provide accurate inputs to the project's validation and smoke-test commands.

What causes impratio conflicts and insufficient ctrlrange failures in robosuite dynamics?

Impratio conflicts and insufficient ctrlrange are common actuator and solver failure modes detected during dynamics validation. The validation workflow reports these as FAIL and provides targeted remediation tips to resolve the physics configuration issues.