nav-approach-wall_skill

This skill helps you advance toward a solid wall using nav conventions and motion tools to achieve stable adjacency.

Python

9

GitHub Stars

2

Bundled Files

2 months ago

Catalog Refreshed

4 months ago

First Indexed

Readme & install

Copy the install command, review bundled files from the catalogue, and read any extended description pulled from the listing source.

Installation

Preview and clipboard use veilstrat where the catalogue uses aiagentskills.

npx veilstrat add skill bdambrosio/cognitive_workbench --skill nav-approach-wall

Skill.md1.3 KB
tool.py5.7 KB

Overview

This skill brings the agent into stable adjacency with a solid vertical surface using navigation conventions and motion primitives. It advances stepwise, verifies support and forward blocks, and stabilizes the agent if ground becomes ambiguous. The goal is a reliable, repeatable approach before wall-dependent actions like climbing.

How this skill works

Each loop the skill inspects the block directly ahead and uses a verified nav-advance primitive to move one grid step toward the wall. If the forward cell is a solid vertical surface the skill stops with success. If the support beneath the agent becomes ambiguous, it runs a place-until-supported routine to lay down a stabilization block and then continues. The skill records a step-by-step log and emits clear outcomes for success, unreachable walls, support failures, or detected falls.

When to use it

Before any wall-dependent operation (e.g., nav-climb) to ensure the agent is adjacent to a surface.
When approaching an unknown environment where gaps or ledges may exist.
During automated navigation tasks that require deterministic adjacency to vertical blocks.
When motion must be snap-to-grid and recorded in nav history for later planning.

Best practices

Provide a conservative target distance to avoid excessive searching (default 10).
Set step_duration to allow reliable sensing and motion completion on your platform.
Choose a placement_item that is readily available and stacks predictable support (default: dirt).
Treat FALL_DETECTED as a safety event and trigger a recovery or backtrack routine promptly.
Run this skill as part of a layered plan: approach, stabilize, then perform wall-specific actions.

Example use cases

Move an agent toward a cliff face until it is directly adjacent for rope- or ladder-based climbing.
Approach a building wall to prepare for wall-scanning or surface interaction routines.
Safely close distance to a target in a world with intermittent gaps by placing support when needed.
Automate repeated approach-and-stabilize steps in a mapping or construction pipeline.

FAQ

SUCCESS means the agent reached a position directly adjacent to a solid vertical surface and preserved stable support.

What happens if a fall is detected?

A FALL_DETECTED outcome is reported, the skill aborts, and you should run a recovery or nav-backtrack sequence.