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

contact-effect — скилл для Claude Code: настройка контакта

Скилл contact-effect для Claude Code проверяет контакт с целью по наблюдаемым изменениям и помогает скорректировать движение. Включается при новом контакте или после изменения хвата, геометрии инструмента либо опоры.

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

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

Что делает contact-effect

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

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

Счётчик учитывает подтверждённые эффекты и отдельные наблюдаемые переходы, а не вызовы инструмента или кадры с тем же состоянием. Калибровочная проба тоже может войти в требуемое число событий; для точного счёта есть ссылка на general/gripper/contact-effect/references/exact-count-cycles.md.

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

  • проверить, сдвигает ли толчок цель в нужном направлении
  • отличить нажатие кнопки от простого касания
  • найти причину неудачного контакта или проскальзывания
  • посчитать подтверждённые циклы нажатия без повторного учёта

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

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

Как установить contact-effect

1Через Skills CLI (Vercel)

npx skills add Open-RUA/uni-robot-agent --skill contact-effect -a claude-code

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

~/.claude/skills/contact-effect/SKILL.md

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

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

Вопросы о contact-effect

Как установить contact-effect в Claude Code?

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

Что делает contact-effect?

Помогает проверить физический эффект контакта по реакции цели и скорректировать движение, если ожидаемого изменения нет. Для нажатий отличает подтверждённое срабатывание от касания.

Как contact-effect считает нажатия?

Он считает подтверждённые эффекты или отдельные наблюдаемые переходы, а не вызовы инструмента. Калибровочное нажатие тоже может учитываться в общем числе событий.

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

SKILL.md · MIT
---
name: contact-effect
description: Verify and adjust contact from observable effects on the target. Use for a new or uncertain contact, or after grip, working geometry or support changes during pushing, pressing, insertion or tool use.
---

# Test the effect at the target

## Predict, probe and compare

Before an unverified contact, identify the working surface and one observable
change expected on the target. Choose a short, controlled probe large enough to
distinguish outcomes while limiting disturbance. Set its extent from the current
geometry, clearance and tool limits; there is no universal distance or duration.
Use an existing pre-action view as the reference when it is still valid.

Inspect the target after execution. Distinguish movement in the intended direction
from rotation, tipping, slip or motion of the support. Evidence sufficient for
one layer below does not automatically establish the next.

| Evidence | Establishes | Still needs evidence |
|---|---|---|
| Hand or wrist moved | The command produced robot motion. | The intended object or tool followed. |
| Held object or tool followed | Control over that object during the observed motion. | Its working surface acted effectively on the target. |
| Target changed | A physical effect occurred. | The effect matches the required direction, state or event. |
| Required effect observed | The local requirement has evidence. | Other requirements and final relationships are satisfied. |

## Inspect the relevant response

| Contact | Compare before and after | When the response is wrong or absent |
|---|---|---|
| Push or slide | Target translation, rotation, tipping and maintained support. | Change the contact point, height or direction rather than extending the same ineffective stroke. |
| Held-tool contact | Working end relative to the grip, its target contact and the target response. | Separate grip slip from ineffective contact; re-localize the changed working geometry. |
| Press or trigger | Local displacement, visible state change or an available activation signal; release when another cycle requires it. | Keep contact, mechanical movement and functional activation distinct. |
| Insert or engage | Entry at the opening, exposed length, relative axes and edge deflection. | If wedged or tipped, withdraw safely before correcting alignment. |
| Constrained motion | Moving part relative to its base, and any unintended base movement. | Restore support or revise the contact if the whole assembly moves instead. |

A clear visual state change can confirm an effect without a separate event
signal. Conversely, apparent touching or pose_reached alone cannot establish
activation. Use only observations and feedback exposed by the tools; do not
assume access to hidden success flags, counters or simulator state.

## Revise the failed hypothesis

If the expected change is absent, distinguish missed contact, slipping grip,
blocked target or an unsuitable force direction using available evidence.
Keep an unobserved cause as a hypothesis. Change the relevant contact factor and
test again; a longer stroke or unchanged repetition may preserve the failure.
With a held tool, locate the working end again after slip or reorientation.

## Establish an effective press before repeating it

Identify the movable button cap, its pressing direction, and an observable
response that distinguishes activation from mere contact. Record a useful
unloaded baseline while the cap is visible.

Align the actual contacting part of the finger or held tool with the cap.
The finger-center target is not automatically the physical contact point.
Approach with clearance, then use bounded contact motion along the intended
pressing direction.

Inspect the cap's travel or a visible functional response. Hand descent,
pose_reached, a tracking stall, or firm-looking contact alone does not prove
activation. A spring-return button may already be raised in a post-release
image; inspect evidence from the pressed state as well as the released state.

If the response is absent or ambiguous, keep the press unconfirmed:

- Check whether contact is on the movable cap or the fixed housing.
- Check alignment, pressing direction, obstruction and unintended base motion.
- Compare actual motion and target error with the required contact geometry.
- Check whether arrival tolerance allowed stopping before an effective press;
  tighten it only when the target and clearance justify it.
- Then choose a small additional stroke, a corrected approach, or another
  contact geometry based on the observed cause.

Do not conclude that a button is rigid or touch-activated merely because a
press failed to move it. Do not keep lowering an unchanged target when the
hand is stalled or the assembly is moving instead.

## Reuse verified effects and count events

Establish one effective press-and-release cycle before repeating its motion.
Count a press only when the required effect has supporting evidence, and
establish release or rearming before the next cycle.

Reuse a verified stroke while grip, working geometry, target and support remain
compatible. Recheck after slip, collision, changed alignment or an unexpected
response, not every known segment. Keep an observation boundary before motion
that depends on an unresolved effect; known approaches can still be batched.
Do not batch further unverified cycles to satisfy a numerical target.
For tool strokes, disengage the working end before lateral travel.

Count confirmed effects or distinct observed transitions, not calls, hand
travel or frames showing the same state. For exact-count tasks, keep confirmed
and uncertain events separate. Inspect an ambiguous attempt before repeating
it: an unseen activation could otherwise be counted twice. Tool-call history
proves attempted cycles, not the number of successful presses.
Use `general/gripper/state-verification/SKILL.md` when the remaining question
concerns the object's resulting state or completion evidence across operations.

A calibration probe is a real interaction and can already contribute to the
required event count. Do not reset the physical count when switching from
calibration to execution. If exact count or ambiguous rearming matters, read
`general/gripper/contact-effect/references/exact-count-cycles.md`.

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

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

Каталог скиллов SKILL.md →
contact-research официальный anthropics Скилл contact-research собирает профиль контакта из Common Room по почте, никнейму или имени. Помогает оценить вовлечённость лида и найти темы для первого контакта. CX Codex +1 3 000установок build-zoom-contact-center-app официальный anthropics Скилл build-zoom-contact-center-app для Claude Code описывает архитектуру Zoom Contact Center и интеграции для клиента Zoom, веб-виджетов и мобильных SDK iOS и Android. CX Codex +1 2 200установок pp-contact-goat Matt Van Horn Скилл pp-contact-goat для Claude Code ищет контакты, строит цепочки тёплых интро и обогащает профили через LinkedIn, Happenstance и Deepline прямо из терминала. CX Codex +1 754установок contact-hunter OneWave-AI Скилл contact-hunter ищет контакты людей и компаний по открытым источникам, определяет почтовые шаблоны и собирает карточки лидов. Пригодится при составлении списков для продаж или найма. CX Codex +1 460установок effect-ts Effect-TS Скилл effect-ts для Claude Code помогает настроить репозиторий с библиотекой Effect TypeScript. Он включается при подготовке такого проекта к работе. CX Codex +1 8 700установок service-agentforce-contact-center-coordinate forcedotcom Скилл service-agentforce-contact-center-coordinate для Claude Code автоматизирует настройку голосового канала Agentforce Contact Center. Запускается при запросе на создание голосового канала и подключение агента. CX Codex +1 100установок

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

Весь набор →
scene-memory Скилл scene-memory для Claude Code сохраняет связи между объектами, их исходными положениями и событиями. Агент подключает его, когда следующий шаг зависит от демонстрации, прошлого наблюдения или действия другого участника. CX Codex +1 ★ 488звёзд репо robodojo-motion-control Скилл robodojo-motion-control для Claude Code объясняет планирование движений RoboDojo, восстановление после отказа IK и диагностические счётчики. Помогает разобрать, почему робот не достиг заданной позы. CX Codex +1 ★ 488звёзд репо supported-contact Скилл supported-contact для Claude Code планирует контакт с объектом и движение вспомогательной руки. Включается, когда нужно удержать груз и одновременно поправить или зафиксировать его приёмник. CX Codex +1 ★ 488звёзд репо pose-targeting Скилл pose-targeting для 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звёзд репо grasp-geometry Скилл grasp-geometry для Claude Code выбирает геометрию захвата с учётом доступных пальцам поверхностей и следующей операции. Помогает планировать захват тонких, полых, загромождённых и частично закрытых объектов. CX Codex +1 ★ 488звёзд репо motion-recovery Скилл motion-recovery для Claude Code помогает разбирать сбои движения робота и выбирать другой маршрут. Агент обращается к нему перед сложным поворотом или после неудачной попытки. CX Codex +1 ★ 488звёзд репо

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

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