К основному содержанию
скилл CX Codex

grasp-geometry — скилл для Claude Code: выбор захвата и установка

Скилл grasp-geometry для Claude Code выбирает геометрию захвата с учётом доступных пальцам поверхностей и следующей операции. Помогает планировать захват тонких, полых, загромождённых и частично закрытых объектов.

MIT ★ 488 обновлён 2026-11-15

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add Open-RUA/uni-robot-agent --skill grasp-geometry -a claude-code
Открыть на GitHub

Что делает grasp-geometry

Скилл помогает выбрать область контакта, направление смыкания и высоту захвата, чтобы пальцы не задевали соседние детали и объект оставался доступен для следующей операции. Он разбирает случаи пустого захвата, потери объекта при подъёме или переносе и предлагает менять геометрию по наблюдаемой причине сбоя.

Для проверки контакта скилл использует фактическое положение руки и подушечек пальцев, а не только результат достижения позы. При расчётах нужны инструменты для работы с файлами или кодом и корректные 3D-точки локализации; сведения о единицах, системах координат и ограничениях берутся из описания робота и руководства. Без этих данных точность геометрической оценки не подтверждается.

Для отдельных случаев скилл отсылает к материалам о захвате по форме, расчёте контакта, передаче объекта и проверке удержания. Изменение опоры или положения детали требует заново оценить доступную область захвата.

Какие задачи решает

  • выбрать сторону захвата тонкой детали, стоящей вертикально
  • избежать смыкания пальцев над отверстием или соседним объектом
  • оставить доступными край или отверстие для следующей операции
  • разобрать, на каком этапе объект выскользнул из захвата

Примеры запросов агенту

  • Выбери захват тонкой детали, стоящей у держателя.
  • Подбери контакт для кольца так, чтобы пальцы не сомкнулись над отверстием.
  • Разбери, почему деталь удержалась при подъёме, но соскользнула при переносе.

Как установить grasp-geometry

1Через Skills CLI (Vercel)

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

2Вручную: положить файлы

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

Папка скилла целиком; для одного проекта — .claude/skills/grasp-geometry/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о grasp-geometry

Как установить grasp-geometry в Claude Code?

Выполни npx skills add Open-RUA/uni-robot-agent --skill grasp-geometry -a claude-code. Файл скилла появится по пути ~/.claude/skills/grasp-geometry/SKILL.md.

Что делает grasp-geometry?

Скилл подбирает геометрию контакта с учётом доступных пальцам поверхностей и того, что потребуется сделать с объектом дальше. Он также помогает различать пустой захват и потерю объекта при подъёме или переносе.

Что нужно для работы grasp-geometry?

Для расчёта контакта нужны инструменты для работы с файлами или кодом и корректные 3D-точки локализации. Единицы, системы координат и ограничения робота сверяются с его описанием и руководством.

Исходный текст

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

Похожие скиллы

Каталог скиллов SKILL.md →
Grasp — Code Architecture & Dependency Analysis ashfordeOU MCP-сервер Grasp — Code Architecture & Dependency Analysis строит для ИИ-агента карту зависимостей, слои архитектуры, список найденных уязвимостей и план рефакторинга репозитория на GitHub или локальной папки. CX Codex +1 ★ 33звёзд репо threejs-geometry CloudAI-X Скилл threejs-geometry учит ИИ-агента создавать стандартные и процедурные геометрии three.js, настраивать буферные атрибуты и генерировать 3D-текст. CX Codex +1 20 600установок r3f-geometry EnzeD Скилл r3f-geometry для Claude Code собирает геометрию и инстансированные объекты в React Three Fiber, помогает разбираться с буферами, линиями и точками. Разбирает способы сокращения draw calls. CX Codex +1 2 200установок geometry-and-math phaserjs Скилл geometry-and-math даёт доступ к утилитам Phaser 4 для работы с векторами, прямоугольниками, кругами и полигонами. Пригодится при расчётах расстояний, углов, проверке пересечений и генерации случайных точек. CX Codex +1 984установок scenario-blender-geometry-nodes scenario-labs Скилл scenario-blender-geometry-nodes помогает создавать и отлаживать ноды Geometry Nodes в Blender через Python-скрипты. Он пригодится для процедурного моделирования, симуляций и физики версии 5.2. CX Codex +1 969установок geometry-nodes https://github.com/arjun988 Скилл geometry-nodes для Claude Code и других платформ, автоматизирующий создание процедурных систем в Blender. Позволяет генерировать ассеты и настраивать пайплайны инстансинга через MCP. CX Codex +1 640установок

Из того же набора41

Весь набор →
supported-contact Скилл supported-contact для Claude Code планирует контакт с объектом и движение вспомогательной руки. Включается, когда нужно удержать груз и одновременно поправить или зафиксировать его приёмник. CX Codex +1 ★ 488звёзд репо pose-targeting Скилл pose-targeting для Claude Code задаёт позицию и ориентацию цели движения робота. Используется при смене инструмента, повороте или выравнивании детали в захвате. CX Codex +1 ★ 488звёзд репо contact-effect Скилл contact-effect для Claude Code проверяет контакт с целью по наблюдаемым изменениям и помогает скорректировать движение. Включается при новом контакте или после изменения хвата, геометрии инструмента либо опоры. CX Codex +1 ★ 488звёзд репо placement-and-engagement Скилл placement-and-engagement для Claude Code планирует размещение и механическое соединение объектов по их видимым признакам. Включается, когда нужно проверить опору, вложение детали или её посадку в соединение. CX Codex +1 ★ 488звёзд репо state-verification Скилл state-verification для Claude Code проверяет состояния объектов и связи по различимым наблюдениям. Он нужен, если следующий шаг зависит от удержания объекта, размещения на опоре или завершения действия. CX Codex +1 ★ 488звёзд репо motion-recovery Скилл motion-recovery для Claude Code помогает разбирать сбои движения робота и выбирать другой маршрут. Агент обращается к нему перед сложным поворотом или после неудачной попытки. CX Codex +1 ★ 488звёзд репо tool-selection Скилл tool-selection для Claude Code выбирает инструменты наблюдения и геометрии для поиска недостающего факта. Агент подключает его при планировании локализации, повторном использовании измерений или неинформативном запросе восприятия. CX Codex +1 ★ 488звёзд репо evidence-driven-gripper Скилл evidence-driven-gripper для Claude Code выбирает действия захвата и контакта по наблюдениям и возможностям манипулятора. Помогает проверить захват перед переносом и восстановиться после потери объекта. CX Codex +1 ★ 488звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой