Przejdź do treści
Biblioteka skilli
Programowanie · Analiza

grasp-geometry

/grasp-geometry

Dobiera chwyt do obiektu na podstawie widocznego materiału, dostępu palców i dalszego użycia, zwłaszcza przy cienkich lub zasłoniętych przedmiotach.

Licencja
MIT
Ostatnia zmiana repozytorium
11.11.2026

Ocena i bezpieczeństwo

90/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść25 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
3
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 11.11.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Dobiera chwyt do obiektu na podstawie widocznego materiału, dostępu palców i dalszego użycia, zwłaszcza przy cienkich lub zasłoniętych przedmiotach.

Oryginalny opis (EN)

Select a grasp from visible material, finger access and the object's next use. Use for thin, hollow, crowded or partially obstructed objects.

Jak działa

  1. Match the closing direction to accessible material
  2. Fit the approach to local material and clearance
  3. Choose the grasp for what must remain accessible
  4. Compare arrival error with the contact margin
  5. Distinguish lift retention from carry retention
  6. Recover from the stage that actually failed
Sekcje z nagłówków SKILL.md, w oryginale · 119 linii, 1 007 słów
Podgląd SKILL.md
---
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.
Pliki w paczce (3)
  • SKILL.md 7 KB
  • references/contact-calculation.md 7 KB
  • references/shape-based-grasping.md 6 KB

Wersje

W bazie nie ma innych skilli o nazwie grasp-geometry.

Migawka bazy z 13.11.2026 · wersja paczki a0dfeac89cc5 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100grasping-short-axis
    Wyznacza deterministyczny chwyt robota z CuRobo wzdłuż krótszej osi obiektu, tak by szczęki zamykały się w poprzek wąskiego wymiaru, np. przy uchwytach, butelkach i narzędziach.
  • 95grasp
    Wdraża metaheurystykę GRASP: zachłanną randomizowaną konstrukcję z listą kandydatów RCL i lokalnym przeszukiwaniem, strojenie alfa, reaktywny GRASP i path relinking.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.