nav-turn_skill

Overview

This skill performs an atomic orientation change to a cardinal direction (0°, 90°, 180°, 270°) and recenters the agent to the block center. It never moves the agent between blocks and always sets pitch to 0°. Use it to precisely control facing before composing movement actions.

How this skill works

Provide a direction command (right, left, back, forward). The skill computes a new yaw by rotating or rounding the current yaw to the nearest cardinal value and snaps the agent to the center of its current block (floor(x)+0.5, y, floor(z)+0.5). On success it returns the chosen cardinal yaw, the direction used, and a short description.

When to use it

• Before any nav-move, nav-climb, or nav-descend to ensure consistent facing.
• When you need the agent aligned exactly to a cardinal axis for block-aligned builds or paths.
• To quickly reorient the agent after external disturbances or imprecise rotations.
• Use the forward option to align to the nearest cardinal without rotating 90° increments.

Best practices

• Always call nav-turn before forward-moving actions to make movement deterministic.
• Prefer forward when you only need alignment; use left/right/back to force a turn.
• Check the skill output for extra.yaw to confirm the cardinal orientation before chaining moves.
• Handle failure reasons (invalid_direction, status_failed, snapto_failed) and retry or fallback.

Example use cases

• Rotate right then issue two nav-move actions to travel along the +X axis.
• Align with forward before building a straight wall along a cardinal axis.
• Turn back to reverse direction while staying centered on the same block.
• Compose with nav-climb after turning to face a ladder or stair block precisely.