waypoint-follower

Configure Nav2 waypoint follower for sequential multi-goal navigation and patrol routes.

Updated Aug 16, 2026
One-click install
npx skills add https://github.com/three1324/yeonjinautomotive --skill waypoint-follower-three1324
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: waypoint-follower
Source: https://github.com/three1324/yeonjinautomotive/tree/main/.claude/skills/waypoint-follower
Command: npx skills add https://github.com/three1324/yeonjinautomotive --skill waypoint-follower-three1324

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Sending a robot through multiple sequential goals requires orchestrating repeated navigation calls, handling failures mid-route, and executing tasks at each stop. This Skill provides the configuration, parameters, and code patterns for the Nav2 waypoint follower so you can set up patrol routes, multi-room navigation, and inspection tasks without trial-and-error. ## Core Features & Use Cases - Waypoint Follower Configuration: YAML parameter reference covering loop_rate, stop_on_failure, action_server_result_timeout, and task executor plugins. - Task Executor Plugins: Built-in WaitAtWaypoint, PhotoAtWaypoint, and InputAtWaypoint plugins, plus a template for writing custom C++ executors via nav2_core::WaypointTaskExecutor. - Python and Behavior Tree Integration: Examples using BasicNavigator, the FollowWaypoints action client, and BT nodes including NavigateThroughPoses for smooth traversal. - Use Case: A patrol robot must visit four rooms in sequence, pause two seconds at each, and continue even if one room is blocked. Configure stop_on_failure to false, set a long action_server_result_timeout, and send the pose list with nav.followWaypoints(). ## Quick Start Ask the AI to configure the Nav2 waypoint follower with a WaitAtWaypoint pause and send a list of patrol waypoints from Python using BasicNavigator.

Frequently Asked Questions about waypoint-follower

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I send multiple waypoints to Nav2 from Python?

Use BasicNavigator from nav2_simple_commander, build a list of PoseStamped messages in the map frame, and call nav.followWaypoints(waypoints). Poll nav.isTaskComplete() and read nav.getFeedback() to track the current waypoint index.

What is the difference between FollowWaypoints and NavigateThroughPoses in Nav2?

FollowWaypoints stops the robot at each waypoint and can trigger task executor plugins on arrival. NavigateThroughPoses sends all poses to the controller at once so the robot passes through them smoothly without stopping.

Why does Nav2 waypoint following abort mid-patrol with no navigation error?

The action_server_result_timeout parameter is likely too short for long legs between waypoints. Increase it to cover your longest possible leg, such as 900.0 seconds for a house patrol.

Does the Nav2 waypoint follower loop patrol routes automatically?

No, the waypoint follower does not natively loop. Implement looping in your own code by re-calling followWaypoints after each completed run, handling failures with costmap clearing and retries.

How do I run a custom action when the robot reaches a waypoint?

Configure a waypoint task executor plugin such as WaitAtWaypoint, PhotoAtWaypoint, or InputAtWaypoint in YAML. For custom behavior, write a C++ class inheriting from nav2_core::WaypointTaskExecutor and register it with pluginlib.