contact-effect — скилл для Claude Code: настройка контакта
Скилл contact-effect для Claude Code проверяет контакт с целью по наблюдаемым изменениям и помогает скорректировать движение. Включается при новом контакте или после изменения хвата, геометрии инструмента либо опоры.
MIT ★ 488 обновлён 2026-11-15
npx skills add Open-RUA/uni-robot-agent --skill contact-effect -a claude-codeЧто делает 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-code2Вручную: положить файлы
~/.claude/skills/contact-effect/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/contact-effect/
1Через Skills CLI (Vercel)
npx skills add Open-RUA/uni-robot-agent --skill contact-effect -a codex2Вручную: положить файлы
.agents/skills/contact-effect/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add Open-RUA/uni-robot-agent --skill contact-effect -a cursor2Вручную: положить файлы
.cursor/skills/contact-effect/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install Open-RUA/uni-robot-agent uni_robot_agent/resources/skills/general/gripper/contact-effect2Вручную: положить файлы
.github/skills/contact-effect/SKILL.md1Через Skills CLI (Vercel)
npx skills add Open-RUA/uni-robot-agent --skill contact-effect -a gemini-cli2Командой платформы
gemini skills install https://github.com/Open-RUA/uni-robot-agent --path uni_robot_agent/resources/skills/general/gripper/contact-effectВручную: положить файлы
.devin/skills/contact-effect/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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