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
npx skills add Open-RUA/uni-robot-agent --skill grasp-geometry -a claude-codeWhat 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-code2Manually: put the files in place
~/.claude/skills/grasp-geometry/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/grasp-geometry/
1Skills CLI (Vercel)
npx skills add Open-RUA/uni-robot-agent --skill grasp-geometry -a codex2Manually: put the files in place
.agents/skills/grasp-geometry/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add Open-RUA/uni-robot-agent --skill grasp-geometry -a cursor2Manually: put the files in place
.cursor/skills/grasp-geometry/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install Open-RUA/uni-robot-agent uni_robot_agent/resources/skills/general/gripper/grasp-geometry2Manually: put the files in place
.github/skills/grasp-geometry/SKILL.md1Skills CLI (Vercel)
npx skills add Open-RUA/uni-robot-agent --skill grasp-geometry -a gemini-cli2Platform CLI
gemini skills install https://github.com/Open-RUA/uni-robot-agent --path uni_robot_agent/resources/skills/general/gripper/grasp-geometryManually: put the files in place
.devin/skills/grasp-geometry/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
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