return-to-start — скилл для Claude Code: что делает и как установить
Скилл return-to-start для Claude Code и Codex возвращает пустые манипуляторы робота в исходные замеренные позы. Проверяет итоговое положение и углы ориентации перед завершением эпизода.
MIT ★ 488 обновлён 2026-11-15
npx skills add Open-RUA/uni-robot-agent --skill return-to-start -a claude-codeЧто делает return-to-start
Скилл задаёт протокол возврата свободных манипуляторов в исходную конфигурацию робота. При наличии доступа к начальным наблюдениям позу извлекают через команду view_env_state с шагом step=0. Перемещение выполняется физически внутри текущего эпизода через инструмент move с координатами [x,y,z,roll,pitch,yaw], вычисленными по кватерниону в радианах.
Перед перемещением манипулятора агент обязан убедиться в стабильной опоре удерживаемого предмета и подтвердить его разжатие. Скилл запрещает перезагружать симуляцию или подменять исходную позу нулевыми углами сочленений. Траектория отвода проверяется с учётом пальцев и предплечий обоих манипуляторов, при рисках пересечения руки возвращаются по очереди.
Флаг pose_reached подтверждает только факт движения к переданной цели, поэтому после остановки обязательна сверка положения схвата и его ориентации с исходной control_pose в той же системе координат. Для неясных систем отсчёта схвата привлекается руководство general/gripper/pose-targeting/SKILL.md.
Какие задачи решает
- вернуть манипулятор в замеренную начальную позу по координатам и кватерниону
- проверить отвод пальцев и звеньев робота без задевания предметов
- сверить фактическое положение схвата с исходным
control_poseпосле движения - скоординировать очередность возврата двух манипуляторов без коллизий
Примеры запросов агенту
- Верни свободный манипулятор в начальную позу через view_env_state step=0 и move.
- Отведи захват от объекта и проверь ориентацию по initial control_pose.
- Убедись, что обе руки робота вернулись на стартовые позиции в пределах допусков.
Как установить return-to-start
1Через Skills CLI (Vercel)
npx skills add Open-RUA/uni-robot-agent --skill return-to-start -a claude-code2Вручную: положить файлы
~/.claude/skills/return-to-start/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/return-to-start/
1Через Skills CLI (Vercel)
npx skills add Open-RUA/uni-robot-agent --skill return-to-start -a codex2Вручную: положить файлы
.agents/skills/return-to-start/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add Open-RUA/uni-robot-agent --skill return-to-start -a cursor2Вручную: положить файлы
.cursor/skills/return-to-start/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install Open-RUA/uni-robot-agent uni_robot_agent/resources/skills/general/gripper/return-to-start2Вручную: положить файлы
.github/skills/return-to-start/SKILL.md1Через Skills CLI (Vercel)
npx skills add Open-RUA/uni-robot-agent --skill return-to-start -a gemini-cli2Командой платформы
gemini skills install https://github.com/Open-RUA/uni-robot-agent --path uni_robot_agent/resources/skills/general/gripper/return-to-startВручную: положить файлы
.devin/skills/return-to-start/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о return-to-start
Как установить return-to-start в Claude Code?
Выполните команду npx skills add Open-RUA/uni-robot-agent --skill return-to-start -a claude-code. Файл настроек сохранится по пути ~/.claude/skills/return-to-start/SKILL.md.
Что делает скилл return-to-start?
Он инструктирует агента безопасно вернуть манипуляторы робота в стартовую точку эпизода, вычислив позу через кватернион и сверив допуски ориентации.
Что нужно для работы скилла return-to-start?
Нужна среда управления роботом, поддерживающая инструменты view_env_state и move, а также передачу координат и кватернионов схвата.
Исходный текст
SKILL.md · MIT
--- name: return-to-start description: Return empty arms to their measured initial poses and verify the finishing posture. Use before returning an arm or checking whether it has returned. --- # Return to the measured initial pose The integration and task instructions determine when return is required and its acceptance tolerances. Restore both position and orientation within those tolerances. Moving clear of the objects, reaching a familiar XYZ, or receiving pose_reached does not establish that the arm has returned. ## Recover the correct target When recorded initial observations are exposed, use view_env_state with step=0 to recover each arm's initial measured pose; otherwise retain the initial measured state supplied by the environment. Keep each arm's own position and quaternion together. Use move with that arm's initial position and its quaternion converted to fixed-axis XYZ Euler radians in pose=[x,y,z,roll,pitch,yaw], both measured at its registered grasp site. Choose the motion profile and tolerances from the tool contract. Do not retain a top-down grasp orientation when the initial orientation differs. Use the environment's declared return reference and acceptance criteria. If its scoring reference differs from the control point, use the published relationship rather than transferring a position tolerance between frames. Use `general/gripper/pose-targeting/SKILL.md` when the grasp site or rotation semantics are unclear. Returning is physical motion within the current episode. Do not reset the environment, recalibrate the robot, or substitute assumed zero joint angles. ## Plan a clear return First establish stable support for any held object and verify release. Preserve contact when the task still requires the arm to support or hold something; do not return that arm prematurely. Withdraw clear of the object before a large translation or reorientation. Check the swept path of the fingers and both arms, not just the endpoints. Use intermediate poses where needed. Coordinate both arms only when their routes do not interfere; otherwise return them in a suitable order. ## Verify the complete pose Resolve submitted motion before inspecting its final state. Compare the measured grasp-site position AND orientation with the initial control_pose, using the same reference frame. Check all available arms, including any that may have moved unintentionally. pose_reached refers to the target supplied to that call. Verify that the supplied target was the intended initial pose before relying on that flag. If either position or orientation is outside the required tolerance, correct the observed mismatch along a clear path and inspect the result. Check that withdrawal left the objects supported and undisturbed. A successful return establishes the finishing posture, not task completion.
© Open-RUA · MIT · Open-RUA/uni-robot-agent