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

pose-targeting — скилл для Claude Code: настройка целей движения

Скилл pose-targeting для Claude Code задаёт позицию и ориентацию цели движения робота. Используется при смене инструмента, повороте или выравнивании детали в захвате.

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

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

Что делает pose-targeting

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

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

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

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

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

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

  • Задай абсолютную цель движения для точки захвата и сохрани текущую ориентацию.
  • Преобразуй control_pose в координаты цели для move.
  • Помоги выровнять конец удерживаемой детали с отверстием.

Как установить pose-targeting

1Через Skills CLI (Vercel)

npx skills add Open-RUA/uni-robot-agent --skill pose-targeting -a claude-code

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

~/.claude/skills/pose-targeting/SKILL.md

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

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

Вопросы о pose-targeting

Как установить pose-targeting в Claude Code?

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

Что делает pose-targeting?

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

Что нужно для работы pose-targeting?

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

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

SKILL.md · MIT
---
name: pose-targeting
description: Construct Direct pose targets with the correct position frame and rotation semantics. Use when switching motion tools, changing orientation, or aligning a held object's feature.
---

# Specify the point and orientation that must reach the goal

Choose the physical intent first: the approach direction, finger closing axis
and object feature needed for the next operation. A numerically valid pose
does not certify reachability, clearance or contact.

## Construct an absolute six-dimensional target

`move.targets[].pose = [x,y,z,roll,pitch,yaw]` describes the registered grasp
site in world metres and fixed/extrinsic XYZ Euler radians:
`R = Rz(yaw) @ Ry(pitch) @ Rx(roll)`. All six numbers are required.
Read `control_frame` and `grasp_site_description`; do not add a controller offset.
The site is not automatically the tip or working end of a held object.

State `control_pose` still contains position and a wxyz quaternion. Convert that
quaternion to fixed XYZ Euler angles before copying a measured pose into `move`.
For example, with SciPy in a code tool:

```python
from scipy.spatial.transform import Rotation
w, x, y, z = control_pose["quaternion"]
rpy = Rotation.from_quat([x, y, z, w]).as_euler("xyz").tolist()
pose = [*control_pose["position"], *rpy]
```

To translate without reorienting, retain measured RPY and change XYZ. To rotate
in place, retain measured XYZ and change RPY. To move and reorient together,
change both. These specify a Cartesian target, not particular wrist joints.
The wrist, fingers and held features may sweep arcs around the grasp site.

Profiles set waypoint limits and final arrival tolerances; they add no approach
height. Use the current tool contract for supported recovery behavior. If feedback
distinguishes a requested goal from an adjusted execution endpoint, inspect both
and verify measured arrival against the requested goal. Choose tolerances that
the intended operation permits before submitting move.
Select a pre-grasp offset from observed geometry. Preserve the distinction between
arrival tolerance, object localization uncertainty and contact margin; tightening
arrival cannot fix the wrong target.

## Preserve task constraints and stage order

Prefer an orientation this arm has reached when it suits the current contact,
finger closing direction and route. Do not copy orientations between arms merely
because positions appear symmetric. If IK rejects a target, the agent may choose
a different absolute orientation only when the task and held object allow it;
the tool does not search for or silently substitute one.

One `move` interpolates position and orientation together. It does not mean
"translate, then rotate". When clearance must be established first, move to the
clearance pose while preserving orientation, inspect the completed feedback and
images, then send the reorientation target. Likewise, verify pre-grasp arrival
before a dependent approach or close, and withdraw from an insertion before a
large turn. Combine translation and rotation only when their combined sweep is
appropriate. A two-arm target list coordinates steps; list order is not time order.

## Compute relative intent outside the tool

For a relative change, compute a new absolute orientation: a world-axis rotation
uses `R_goal = R_delta @ R_current`; a tool-local rotation uses
`R_goal = R_current @ R_delta`. Convert the result to fixed XYZ Euler radians.
Adding an angle to an arbitrary Euler component is not a general local-axis turn.
A held object's tip is a different pivot and may require a changed XYZ target.

If a call runs out of steps while making progress, continue toward the same
`feedback.arms[arm].target_pose` when the route is still valid. Do not add the
relative angle again. Euler wraparound and gimbal-lock representations can change
numbers without changing physical orientation; compare rotations, not component
subtraction. Quaternions q and -q are also equivalent. Read
`general/gripper/motion-recovery/SKILL.md` for rejection or lost progress.

## Example: the hand aligns but the object's tip misses

A long held part must enter an opening. Aligning the finger center with that
opening does not align an offset tip. Observe the tip and axis relative to the
hand, then choose the hand pose that places the entering feature appropriately.
After reorientation, update that relationship and check retention. A previous
world-axis offset cannot simply be reused after the object rotates.
Use `general/gripper/held-object-geometry/SKILL.md` for the feature relationship
and `general/gripper/placement-and-engagement/SKILL.md` for actual entry evidence.
If the tip is occluded, obtain useful evidence rather than assuming the hand
target proves alignment. Do not silently tighten tolerance to compensate for
targeting the wrong point.


## Schema example

This illustrates the request shape, not a recommended scene coordinate. Replace
the six pose values with the desired registered site pose from current evidence.

```json
{"profile":"precision","targets":[{"arm":"left","pose":[0.2,-0.1,0.9,0,0,0]}],"max_steps":12}
```

When metric opening calibration is exposed, move targets use `gripper_opening_m`.
Otherwise follow the declared opening parameter and units. Omit opening to preserve
the drive target. Native reviewer prefixes retain their declared convention; do
not convert them to metres unless their schema requires it.
Read the current environment's robot description and published manual for
units, frames and capability limits.

A supplied metric opening changes during the pose motion. Inspect targets_reached
and per-arm opening_reached as well as pose_reached; the pose can arrive first.
Omitting opening retains the complete drive intent and preserves closing preload.
It does not copy the measured gap. Use separate stages when full opening must
precede entry into a constrained region; keep independent work concurrent.

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

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

Все скиллы по теме «Наука и исследования» →
robotics-engineer rohitg00 Субагент robotics-engineer для разработки автономных роботов на ROS2: восприятие, планирование маршрутов, оценка состояния и управление в реальном времени. CX Codex ★ 2 858звёзд репо controlnet-pose prime-skills Скилл controlnet-pose для управления позой и движением в видео и изображениях через RunComfy. Перенос движений из исходного видео на целевого персонажа, анимация по позам и создание изображений с контролем глубины или скелета. CX Codex +1 388 200установок tao-train-pose-classification NVIDIA Corporation Скилл tao-train-pose-classification помогает обучать и запускать классификатор действий по последовательностям ключевых точек позы. Он пригодится для работы с моделями TAO на скелетных данных. CX Codex +1 1 600установок configs-targeting launchdarkly Скилл configs-targeting для Claude Code и Codex настраивает таргетинг конфигураций LaunchDarkly. Управляет процентной раскаткой вариаций, правилами по атрибутам и сегментами пользователей. CX Codex +1 1 900установок fine-tuning-serving-openpi Orchestra Research Скилл fine-tuning-serving-openpi для Claude Code содержит сценарии дообучения и запуска инференса моделей OpenPI pi0, pi0-fast и pi0.5. Помогает подготовить окружение, рассчитать нормализацию и запустить WebSocket-сервер. CX Codex +1 1 000установок fine-tuning-openvla-oft Orchestra Research Скилл fine-tuning-openvla-oft для Claude Code настраивает дообучение и оценку OpenVLA-OFT для генерации действий робота. Настраивает сценарии LIBERO и ALOHA с непрерывными действиями. CX Codex +1 1 000установок

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

Весь набор →
handover Скилл handover для Claude Code передаёт удерживаемый объект из одной роботизированной руки в другую. Агент использует его для передачи между руками, а не для обычной укладки одной рукой. CX Codex +1 ★ 488звёзд репо 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звёзд репо 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звёзд репо grasp-geometry Скилл grasp-geometry для Claude Code выбирает геометрию захвата с учётом доступных пальцам поверхностей и следующей операции. Помогает планировать захват тонких, полых, загромождённых и частично закрытых объектов. CX Codex +1 ★ 488звёзд репо

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

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