nav-move_skill

Overview

This skill attempts exactly one adjacent forward move relative to the agent's current facing direction and reports a precise outcome. It is an atomic navigation primitive designed to be composed into larger motion plans. The operation aligns the agent, executes a single forward action, verifies landing, and returns structured success or failure details.

How this skill works

Before moving, the agent snaps to the center of the current block and sets yaw to the nearest cardinal direction and pitch to zero to avoid fractional-offset collisions. The skill calls a single forward move action with collision checking, then validates the result using status and observation checks. It returns structured output describing start/end positions, vertical change, support at the destination, or a specific failure reason.

When to use it

• You need one guaranteed forward step with verification before composing further moves.
• Testing or debugging low-level navigation behavior step-by-step.
• Performing safety-checked movement where a single failed step should abort higher-level plans.
• Situations where precise alignment and predictable cardinal movement are required.
• Before invoking multi-step primitives to validate single-step feasibility.

Best practices

• Allow the skill to realign the agent; do not mix pre-move offsets as it snaps to block center and cardinal yaw.
• Use this as an atomic primitive inside higher-level planners rather than for long-distance motion.
• Inspect failure reasons to decide recovery: e.g., treat "fell" as a safety event and trigger backtrack or stop.
• Set step_duration for smoother simulation if needed, but keep it minimal for responsiveness.
• Check extra fields (from/to/delta_y/support_here) to validate environmental assumptions before next action.

Example use cases

• Move one block forward down a corridor, verify support and proceed if successful.
• Step onto a new block to inspect support type (solid, air, etc.) before placing blocks or interacting.
• Use in a recovery loop: attempt move, on collision adjust facing or clear obstacle, retry.
• Combine multiple nav-move calls inside a planner to build stepwise, verifiable paths with immediate fall/collision detection.