Skip to main content
skill CX Codex

grasp-geometry — Claude Code skill: grasp selection and setup

This Claude Code skill selects grasp geometry based on exposed material, finger access, and the object's next use. It covers thin, hollow, crowded, or partly blocked objects.

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 grasp-geometry -a claude-code
Open on GitHub

What grasp-geometry does

The skill helps select a contact region, closing direction, and grasp height while keeping fingers clear of nearby parts and leaving the object ready for its next operation. It addresses empty closures and objects lost during lifting or carrying, then ties adjustments to the observed failure.

It checks actual hand and pad positions rather than treating a reached pose as proof of contact. Contact calculations require file or code tools and valid 3D locate points; robot units, frames, and limits come from the robot description and published manual. Without those inputs, the geometry estimate cannot be confirmed.

For specific cases, the skill points to references on shape-based grasping, contact calculation, handover, and state verification. A changed support or object position calls for a fresh assessment of accessible grasp regions.

What it helps with

  • choose a side grasp for a thin upright part
  • keep the fingers from closing over a hole or neighboring object
  • leave an edge or aperture accessible for the next operation
  • identify whether an object was lost during lift or carry

Example prompts for the agent

  • Choose a grasp for a thin part beside its holder.
  • Select a contact for the ring that keeps the fingers clear of its opening.
  • Explain why the part stayed in the hand during the lift but slipped during carry.

How to install grasp-geometry

1Skills CLI (Vercel)

npx skills add Open-RUA/uni-robot-agent --skill grasp-geometry -a claude-code

2Manually: put the files in place

~/.claude/skills/grasp-geometry/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/grasp-geometry/

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

Questions about grasp-geometry

How do I install grasp-geometry in Claude Code?

Run npx skills add Open-RUA/uni-robot-agent --skill grasp-geometry -a claude-code. The skill file is placed at ~/.claude/skills/grasp-geometry/SKILL.md.

What does grasp-geometry do?

It selects contact geometry based on reachable material and the operation that follows. It also helps distinguish an empty closure from an object lost during lifting or carrying.

What does grasp-geometry need to work?

Contact calculations need file or code tools and valid 3D locate points. Robot units, frames, and capability limits are taken from the robot description and published manual.

Source text

SKILL.md · MIT
---
name: grasp-geometry
description: Select a grasp from visible material, finger access and the object's next use. Use for thin, hollow, crowded or partially obstructed objects.
---

# Choose contact that preserves the next operation

Use `general/gripper/state-verification/SKILL.md` when attachment is unresolved.
This reference selects contact geometry; it does not certify a grasp or prescribe
one approach for every object.

Before closure, choose the contact region, closing direction and contact height
as one geometry, with clearance for both fingers and the next operation. Check
the achieved pose against that region; a requested pose is not contact evidence.

## Match the closing direction to accessible material

- For a thin upright part with both faces exposed, consider a side approach
  that closes across its thickness. Check space for both fingers and exclude
  the holder and neighboring parts from the closing region. This candidate
  does not transfer unchanged to the same part lying flat.
- For a ring, open shape or separated strokes, choose observed solid material.
  A mask center can lie in a hole or between parts. Check the selected instance
  rather than grasping a group mask or the support visible through an opening.
- If contact repeatedly catches a holder or adjacent object, withdraw and
  change the exposed region or closing direction. Deeper descent into the same
  obstruction does not isolate the intended part.

## Fit the approach to local material and clearance

Choose a pregrasp opening that encloses the target with observed finger clearance;
fully open fingers can hit a neighbor before reaching the intended contact.
When descent stalls, distinguish that obstruction from target contact or a
kinematic limit before moving deeper. Change opening only while preserving a
clear path and any current support responsibility.

For thin or partly occluded material, compare the selected contact region with
the visible support surface. A valid mask or geometric sample can belong to a hole,
neighbor, finger or background. If an empty grasp contradicts the estimate,
choose a view or local feature that resolves the contact geometry; do not infer
a universal camera bias or repeat an uninformative scan.

## Choose the grasp for what must remain accessible

Leave the entering end, aperture, supporting face or working edge available
for the next operation. For a transfer, also leave material the other hand can
enclose; use `general/gripper/handover/SKILL.md` for the support-transfer procedure.
Inspect whether exactly the intended instance moved, especially when adjacent
parts can be collected together.

A changed support or grip invalidates the old grasp geometry. Re-localize the
accessible edge after a fall, and inspect finger clearance before retrying.
If a temporary placement is permitted, choose one that preserves a regraspable
region; laying a thin part flat can remove the only accessible edge.

## Compare arrival error with the contact margin

A pose_reached result satisfies the motion tolerance; the remaining error may
still exceed the grasp's contact margin. Read actual_position at the registered
grasp site and compare the actual pad positions with observed solid material.
If the remaining approach is clear, use a local precision move or explicit
tolerance suited to that margin, inspect its actual result, then close.
A coarse profile remains useful in clear approach. If the contact region was
already aligned, tighter tracking will not repair a hole, tapered contact or
obstructed finger; change the relevant grasp geometry.

## Distinguish lift retention from carry retention

A short vertical lift shows the intended object following the hand, but a lateral
carry leaves it on the table while the measured opening decreases. The lift
established retention for that motion only. Opening change plus visible loss
establishes a changed hold; it does not identify excessive or insufficient force.

Inspect the new support and contact region. For a shallow pinch on a sloping or
narrow end, consider accessible opposing material with room for both pads and
for the next operation. Change the region, closing direction or supported route
that the evidence implicates; do not simply repeat the same grip more slowly.
After a changed grasp, use a compatible short lift and initial precision carry
at the retained orientation to distinguish pickup from lateral retention.
If it holds and clearance is established, batch already-known route segments to
the next meaningful checkpoint; do not add a capture or locate after each segment.
Recheck at substantial rotation, receiver contact or support transfer using
`general/gripper/state-verification/SKILL.md`. An intact grip needs no repeated
whole-object measurement; a shifted hold needs refreshed feature geometry via
`general/gripper/held-object-geometry/SKILL.md` before precise placement.

## Recover from the stage that actually failed

Distinguish an empty closure, loss during initial lift, and loss during carry.
For an empty closure, resolve pad/material overlap and actual arrival first.
For lift loss, inspect opposing contact and changed support; for carry loss,
inspect load orientation, clearance and the hand-to-object relation. Opening
alone does not distinguish these outcomes. Keep unobserved mechanical causes
as hypotheses and change a factor supported by the observed failure.

When local shape leaves several plausible contacts, read
`general/gripper/grasp-geometry/references/shape-based-grasping.md` for conditional
candidates based on cross-section, curvature, openings, branches and opposing
faces. Select from current finger access and support clearance; a shape category
does not establish a successful grasp.

When the current tools expose metric jaw calibration, use `gripper_opening_m`
for move or `release` with target `opening_m` to pre-open. Otherwise follow the
declared opening units. Include finger thickness when judging clearance; consult
published hand geometry through `robot_calibration_path` when available.
Read the current environment's robot description and published manual for
units, frames and capability limits.

For a staged grasp, first reach a geometry-derived pre-grasp pose and inspect
completed feedback, then approach and verify before closing. `move` adds no
pre-grasp offset. Its position/orientation errors remain available for each
arm; pose arrival alone does not prove contact or attachment.

When contact height, finger clearance or pad overlap is uncertain, read
`general/gripper/grasp-geometry/references/contact-calculation.md`. Use file/code
tools to compute from the published hand geometry and valid 3D locate points
(from exposed pixels or triangulate methods, not a 2D-only segment);
print the candidate pose, gap, clearance and uncertainty before selecting it.
Do not infer unseen thickness or invent a fixed grasp-height correction.
Opening can change during move. If material must fit between the fingers before
entry, open in the clear pregrasp segment and inspect opening_reached before
approaching; endpoint completion does not prove intermediate clearance.

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

Similar skills

SKILL.md skills catalog →

From the same set41

The whole set →
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 pose-targeting The pose-targeting Claude Code skill builds robot motion targets from a position and orientation. It activates for tool changes, reorientation, and aligning a feature on a held object. CX Codex +1 ★ 488repo stars contact-effect The contact-effect Claude Code skill checks contact by observing how the target responds and guides adjustments. It activates for new or uncertain contact, or after a change to grip, tool geometry, or support. CX Codex +1 ★ 488repo stars placement-and-engagement The placement-and-engagement Claude Code skill plans and checks object placement, support, containment, and mechanical engagement from visible features. It applies when receiver stability or relative geometry shapes the requested result. CX Codex +1 ★ 488repo stars state-verification The state-verification Claude Code skill checks object states and relationships using distinguishing evidence. It activates when a next step depends on whether an object is held, placed, or correctly oriented. CX Codex +1 ★ 488repo stars motion-recovery The motion-recovery Claude Code skill helps diagnose robot motion failures and choose a changed route. The agent consults it before a difficult reorientation or after motion stalls. CX Codex +1 ★ 488repo stars tool-selection The tool-selection Claude Code skill picks observation and geometry tools to find the fact needed for the next action. It activates during localization planning, measurement reuse, or recovery from an uninformative perception query. CX Codex +1 ★ 488repo stars evidence-driven-gripper The evidence-driven-gripper Claude Code skill chooses contact actions from current observations and gripper capabilities. It checks object control before transport and revises the plan after a failed grasp. CX Codex +1 ★ 488repo stars

Project sponsors

Companies that keep this analytics open