CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

srdf

MoveIt2 SRDF generation, validation, and planning-semantics workflow. Use when creating, editing, regenerating, inspecting, or validating `.srdf` files, `gen_srdf()` sources, MoveIt planning groups, virtual joints, passive joints, end effectors, group states, disabled collisions, URDF-linked planning semantics, or SRDF handoff for live review. Use the URDF skill for robot structure, the SDF skill for simulator descriptions, and the Replicator artifact review pane for project artifact paths.

Quality

88%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

78%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

Well-structured expert content: an 11-step workflow with real validation checkpoints, copy-paste-ready launcher commands, and exemplary progressive disclosure — every listed reference file exists and is purpose-labeled. The main improvement room is tightening repeated handoff/rule content and making the validation failure-and-retry loop explicit.

Suggestions

Consolidate the three separate mentions of the 'Replicator artifact review pane' handoff (Handoff section, Hard Rules, References) into the single handoff section, with the Hard Rules and References sections pointing back to it in one clause each.

Add an explicit feedback loop to the Required workflow after step 9: e.g., 'If generation-time URDF validation fails, fix the SRDF source or URDF and re-run; do not hand off a file that failed validation.'

In the Commands section, show or inline one line for the validation entry point (currently only in references/validation.md) so the generate-validate cycle is executable without opening a reference file.

DimensionReasoningScore

Conciseness

The body is dense and expert-oriented with no tutorial padding — the format boundary, hard rules, and workflow are all domain-specific knowledge rather than concepts Claude already knows. It is not a 5 because of minor repetition: the Replicator artifact review pane handoff appears in three separate sections, and the unit rules and URDF-validity rules appear in both the Required workflow and Hard Rules sections.

4 / 5

Actionability

Concrete executable launcher commands are given in three variants ('python scripts/srdf path/to/source.py', '-o' override, and multi-target), the python-interpreter caveat is explicitly justified, and step guidance is decision-specific (chain vs joint/link groups, evidence sources for collision disables). Not a 5: the actual validation command and collision-analysis procedure are deferred to references rather than shown, leaving minor gaps for the most common execution paths.

4 / 5

Workflow Clarity

The 11-step Required workflow is clearly sequenced with validation checkpoints ('Generation validates the generated SRDF against the linked URDF before writing', 'Run MoveIt smoke tests when available') and a reporting step for skipped checks. Not a 5: the error-recovery feedback loop — what to do when validation fails (fix and re-run) — is only implicit; the body never states the fix-and-retry cycle that the anchor-5 example makes explicit.

4 / 5

Progressive Disclosure

A clear overview body (format boundary, workflow, commands, hard rules) with a well-labeled References section pointing one level deep to eight purpose-labeled files ('Generation command', 'Generator contract', 'Validation scope', etc.), all of which are verified present in the references/ directory of the bundle. Not a 4: structure, signaling, and file placement are all clean; navigation is easy.

5 / 5

Total

17

/

20

Passed

Description

95%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: it explicitly states what the skill does and when to use it, covers the natural trigger vocabulary comprehensively (including the .srdf extension and MoveIt component terms), and actively disambiguates against adjacent URDF and SDF skills. The only soft spot is that the action list is slightly compressed compared to the trigger list.

DimensionReasoningScore

Specificity

Names the domain and several concrete actions ('SRDF generation, validation, and planning-semantics workflow') across specific artifacts like planning groups, virtual joints, end effectors, group states, and disabled collisions. It is not a 5 because the action enumeration is compressed — the operational verbs (creating, editing, regenerating, inspecting, validating) live in the trigger clause rather than a fuller what-list, leaving minor gaps in coverage.

4 / 5

Completeness

Clearly and explicitly answers both what ('MoveIt2 SRDF generation, validation, and planning-semantics workflow') and when ('Use when creating, editing, regenerating, inspecting, or validating .srdf files...') with concrete trigger phrases. Not a 4: the 'when' clause is explicit, specific, and enumerates concrete operations and artifacts rather than being generic.

5 / 5

Trigger Term Quality

Comprehensive natural-term coverage including the file extension ('.srdf'), framework name (MoveIt), and the component vocabulary users would actually say: 'planning groups', 'virtual joints', 'passive joints', 'end effectors', 'group states', 'disabled collisions', and even the generator function name 'gen_srdf()'. Not below 5: no common synonym or extension for this domain is missing.

5 / 5

Distinctiveness Conflict Risk

Clear niche (SRDF/MoveIt planning semantics) with distinct triggers, plus explicit disambiguation ('Use the URDF skill for robot structure, the SDF skill for simulator descriptions') that routes adjacent work away from this skill. Not a 4: overlap risk with URDF/SDF skills is actively mitigated by routing instructions, not just reduced.

5 / 5

Total

19

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

referenced_paths_exist

Referenced path issues: 1 missing

Warning

Total

15

/

16

Passed

Repository

JimmyPeng02/open-replicator

Path

skills/srdf/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.