Skip to main content
skill CX Codex

reachability-and-recovery — Claude Code skill for gripper routes

The reachability-and-recovery Claude Code skill selects an arm, approach, and permitted relay for a complete gripper route. It activates when the destination is hard to reach or an existing route needs reassignment.

MIT ★ 488 updated 2026-11-15

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add Open-RUA/uni-robot-agent --skill reachability-and-recovery -a claude-code
Open on GitHub

What reachability-and-recovery does

The skill plans a grasp route across source access, loaded transport, destination contact, and empty-hand withdrawal. It weighs orientation, height, the arm's current configuration, and the selected position frame instead of treating the workspace as fixed left and right zones.

When destination access is uncertain, an empty-hand approach can test it before pickup. That test does not show whether the same path clears a held object. After repeated failures with one arm, the skill compares reassignment options and calls for testing the doubtful part of a changed route before retrying the full operation.

A supported relay is an option only when the task permits it; it does not satisfy an explicit hand-to-hand transfer instruction. For IK rejection, stalls, or partial execution, the skill points to general/gripper/motion-recovery/SKILL.md.

What it helps with

  • choose an arm and orientation for a loaded route
  • test uncertain destination access before pickup
  • reassign hand roles after repeated route failures
  • plan a permitted supported relay between hands

Example prompts for the agent

  • Choose an arm and route for this grasp; destination access is uncertain.
  • Reassign the hands after repeated failures during the carry.
  • Plan a permitted supported relay while preserving the required operation order.

How to install reachability-and-recovery

1Skills CLI (Vercel)

npx skills add Open-RUA/uni-robot-agent --skill reachability-and-recovery -a claude-code

2Manually: put the files in place

~/.claude/skills/reachability-and-recovery/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/reachability-and-recovery/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about reachability-and-recovery

How do I install reachability-and-recovery in Claude Code?

Run npx skills add Open-RUA/uni-robot-agent --skill reachability-and-recovery -a claude-code. The skill file is at ~/.claude/skills/reachability-and-recovery/SKILL.md.

What does reachability-and-recovery do?

It selects an arm, approach, and permitted transfer for the route from grasp through placement and withdrawal. It helps revise the route when an arm repeatedly fails or destination access is uncertain.

Does an empty-hand test prove that a loaded arm can use the same route?

No. It provides evidence about access, but does not prove clearance for an arm carrying an object.

Source text

SKILL.md · MIT
---
name: reachability-and-recovery
description: Choose an arm, approach and permitted relay for the complete gripper route. Use before committing to a grasp whose destination is uncertain or when a route needs reassignment.
---

# Choose a feasible route through the whole operation

Consider source access, loaded transport, destination contact and empty-hand
withdrawal together. Reachability depends on orientation, height, current arm
configuration and the chosen position frame, not a fixed left/right coordinate
boundary. A failed pose is evidence about that attempt, not the whole workspace.

## Resolve consequential uncertainty before pickup

Reuse full poses this arm actually reached when they remain compatible with the
scene. When destination access is doubtful, a clear empty-hand approach can test
it before committing to acquisition. This is useful evidence, not a requirement
for every pickup or proof that the same route clears a held object.

Select task-compatible orientations and staging poses with room for the load,
fingers and forearms. If the instruction leaves assignments or order open,
choose them to reduce difficult transfers; preserve explicitly required pairings,
destinations and sequences. Assign each hand's support role before moving it.

## Change the route without losing useful support

When a single-arm route repeatedly fails, reassess hand assignments before
another acquisition or carry attempt. Compare changing the carrying arm, using
the free hand to adjust the receiver, and a permitted supported relay. Choose
from observed access, support and clearance; an untested arm is not guaranteed
to reach. Identify what changes, resolve queued work, and test the doubtful
part of the revised route before repeating the full pickup-and-carry sequence.

Use `general/gripper/supported-contact/SKILL.md` for permitted receiver adjustment
or restraint and `general/gripper/handover/SKILL.md` for hand-to-hand transfer.

## Case: pickup is reachable, but a vertical basket entry is rejected

A grasp succeeds near the arm, but a straight fingers-down carry cannot enter the
basket. In a successful recovery, the arm withdrew to clear space, changed to a
previously reached carrying inclination, then entered along short precision
segments. Reuse the reasoning, not that episode's coordinates or quaternion:
compare the required object pose, grasp-site orientation, full-load clearance and
withdrawal path. A tilted hand may enter where the vertical one could not, but
an orientation required by the task must still be satisfied at placement.
When destination access is doubtful before pickup, test its consequential part
with an empty hand if useful. Reuse an established compatible route; do not
repeat reach probes for every object or treat an empty-hand pass as load clearance.

## Case: source and destination need different hands

One arm reaches the source but lacks a demonstrated destination route; the other
has destination access. Before acquisition, compare direct transport with a
permitted supported relay that both hands can approach and withdraw from. Choose
a stable staging pose that exposes a receiving grasp; laying a thin part flat can
hide that region. Confirm receiver access before releasing donor support, then
localize affected geometry and verify the receiving grasp before transport.
A supported relay does not fulfill an explicit hand-to-hand instruction. If the
category-to-container assignment is free, choose it using demonstrated access;
if destinations or order are specified, preserve them and plan the transfer.
Do not infer permanent left/right workspace boundaries from one rejected pose.

For IK rejection, stalls, joint jumps or partial execution, read
`general/gripper/motion-recovery/SKILL.md`. It owns tool-frame semantics and
motion recovery. Resolve queued work and inspect the actual state before route
reassignment. Test a meaningful changed approach and confirm progress before
batching dependent work; repeated zero-step rejection cannot be repaired by
increasing the step budget or assuming the requested pose was reached.

When the task permits choosing a shared destination, choose it for every
required approach, loaded placement and withdrawal, not just the first pickup.
A successful placement with no clear withdrawal route is not a reusable route.
If a changed destination is permitted and necessary, preserve the specified
object relationships and reassess the affected arms before moving the load.
Do not abandon a required operation as physically impossible on the evidence
of repeated failures with one contact geometry or one arm configuration.

© Open-RUA · MIT · Open-RUA/uni-robot-agent

Similar skills

All skills for Agent setup: memory, context, orchestration →

From the same set41

The whole set →
contents-transfer contents-transfer — a skill for Claude Code that transfers loose contents from a held vessel into a receiver. It tracks outlet alignment, flow, and what remains. CX Codex +1 ★ 488repo stars moving-target-control The moving-target-control Claude Code skill plans contact with moving physical objects and checks whether a grasp holds. It activates when a target or receiver may move during approach or transfer. CX Codex +1 ★ 488repo stars return-to-start return-to-start — a skill for Claude Code and Codex guides robotic arms back to their measured starting poses. Verifies position and orientation tolerances before ending the movement. CX Codex +1 ★ 488repo stars held-object-geometry The held-object-geometry Claude Code skill locates a held object's relevant feature relative to the hand. It applies to clearance checks, placement, and tool contact during robot motion. CX Codex +1 ★ 488repo stars handover The handover Claude Code skill transfers an object held by one robot hand to another. It is triggered for hand-to-hand transfers, not ordinary placement with a single arm. CX Codex +1 ★ 488repo stars scene-memory The scene-memory Claude Code skill tracks object identities, reference states, and event order. It activates when an agent’s next action depends on an earlier observation, a demonstration, or another actor’s move. CX Codex +1 ★ 488repo stars robodojo-motion-control The robodojo-motion-control Claude Code skill explains RoboDojo motion planning, IK recovery, and diagnostic counters. It helps interpret why a robot did not reach its requested pose. CX Codex +1 ★ 488repo stars supported-contact The supported-contact Claude Code skill plans object contact and the assisting hand’s motion. It activates when a held load needs a receiver adjusted or restrained at the same time. CX Codex +1 ★ 488repo stars

Project sponsors

Companies that keep this analytics open