srdf

Author and validate MoveIt2 SRDF planning semantics against paired URDF robot descriptions.

465|41|Updated Aug 4, 2026
One-click install
npx skills add https://github.com/autonomous-ai/openharness --skill srdf-autonomous-ai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: srdf
Source: https://github.com/autonomous-ai/openharness/tree/main/store/agents/text-to-cad/skills/srdf
Command: npx skills add https://github.com/autonomous-ai/openharness --skill srdf-autonomous-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires cadgen, and includes references (resource) components.

What problem does it solve? MoveIt2 SRDF files often fail not from invalid XML but from plausible-but-wrong planning semantics: incorrect planning groups, wrong tool links, unsafe disabled-collision pairs, or group states in the wrong units. This Skill enforces a derivation-based workflow so every name, chain, state, and collision pair is grounded in the paired URDF rather than guessed. ## Core Features & Use Cases - SRDF Authoring Contract: Write .srdf XML directly with a defined element order (virtual joints, groups, group states, end effectors, passive joints, disabled collisions) and a planning-ledger comment block recording assumptions. - URDF-Paired Validation: Run cadgen srdf validate to cross-check every link, joint, chain path, group state, and disabled-collision pair against the colocated URDF, with --strict and --json output modes. - Evidence-Based Disabled Collisions: Derive collision pairs from URDF adjacency, MoveIt Setup Assistant sampling, or explicit user data with truthful reason codes instead of invented lists. - Use Case: After building a robot arm URDF, use this Skill to define an arm chain group, a gripper end effector, home/ready group states in radians, and adjacency-based disabled collisions, then validate and hand the file to the CAD viewer for live review. ## Quick Start Use the srdf skill to create and validate a MoveIt SRDF for the URDF in my current project folder, then hand it to the cad-viewer for review.

Frequently Asked Questions about srdf

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

FAQPage Schema
How do I create an SRDF file for MoveIt2?

Start from a validated URDF, extract its full link and joint table, then author the SRDF XML directly with planning groups, group states, end effectors, and disabled collisions copied from that table. Save the .srdf in the same folder as the URDF with the same robot name, then run cadgen srdf validate.

How does an SRDF file pair with its URDF?

Pairing works by colocation and robot name only: the .srdf sits in the same folder as the .urdf and both declare the identical robot name. Exactly one URDF per robot name may exist in the folder; there is no explicit link element.

What units do SRDF group states use?

Group states use URDF-native units: radians for revolute and continuous joints, meters for prismatic joints. Values must lie within URDF limits and must never set fixed or mimic joints; storing degrees is a common defect.

How should disabled collision pairs be generated in SRDF?

Derive them from evidence: URDF adjacency, MoveIt Setup Assistant self-collision sampling, or explicit user-provided matrices, each with a truthful reason such as Adjacent, Never, or Default. Do not invent broad disable lists from visual inspection.

Why does SRDF validation fail after editing the URDF?

Renamed links or joints, changed limits, or restructured chains silently invalidate the SRDF because every name is cross-checked against the paired URDF. Re-run cadgen srdf validate after any URDF change and fix the owning file.

What can SRDF validation not prove?

Validation cannot prove the planning group matches task intent, the TCP link is physically correct, disabled pairs are safe at every configuration, or group-state poses are collision-free. These semantic decisions require MoveIt smoke tests or interactive viewer review.