When To Use
Use this skill when a user asks to set, fix, or validate an initial robot pose from language such as "gripper fingers down", "tool points forward", "camera looks at the object", or "end effector aligns with the target".
Workflow
- Translate the visual request into a measurable body-axis or target-pose condition.
- Inspect the actual articulation
body_namesandjoint_names; do not rely only on USD prim names. - Measure current body position and orientation from simulation state.
- Sweep candidate joints one variable at a time, respecting joint limits.
- Choose the pose that satisfies the axis target while preserving reachability and avoiding self-collision.
- Patch the task's initial joint positions or reset configuration.
- Validate with compile checks and a one-env reset or zero-action smoke.
- Report the measured before/after axis alignment, not just visual appearance.
Validation
Use these acceptance checks:
- The body or frame being measured is named explicitly.
- The requested local axis and target world axis are documented.
- Body-axis dot product is reported before and after the change.
- Joint values are inside joint limits.
- The pose remains reachable for the task target.
- Observation and action dimensions remain unchanged unless the user requested a contract change.
For skill changes, run:
uv run --no-project python tools/skills/cli.py check
Maintenance
Keep this skill synchronized with robot and articulation APIs under source/isaaclab/isaaclab/assets/, environment smoke-test patterns, and examples that use ArticulationCfg.InitialStateCfg. Do not include generated screenshots, private assets, or local machine paths in the skill.