nav2-simple-commander

Sends navigation goals and monitors Nav2 tasks through the BasicNavigator Python API.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires nav2_simple_commander, rclpy, geometry_msgs.

What problem does it solve? Writing raw ROS2 action clients for Nav2 navigation is verbose and error-prone. This Skill provides the BasicNavigator API patterns needed to send goals, track progress, and handle results programmatically without manually wiring action servers and lifecycle states. ## Core Features & Use Cases - Goal Navigation: Send single poses, pose sequences, or waypoint lists with feedback monitoring and cancellation. - Path Computation: Compute and smooth paths without navigating, useful for validating reachability before committing. - Costmap and Lifecycle Control: Clear costmaps after false obstacle detections, set the AMCL initial pose, and wait for Nav2 activation. - Use Case: Build an autonomous patrol routine that loops through waypoints, logs progress per waypoint, clears costmaps on failure, and retries. ## Quick Start Use the nav2-simple-commander skill to write a Python script that sends my robot to a goal pose in the map frame and reports whether it succeeded.

Frequently Asked Questions about nav2-simple-commander

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

FAQPage Schema
How do I send a navigation goal to Nav2 from Python?

Create a BasicNavigator instance, call waitUntilNav2Active, then pass a PoseStamped in the map frame to goToPose. Poll isTaskComplete in a loop and call getResult to check whether the task succeeded, failed, or was canceled.

What is the difference between goThroughPoses and followWaypoints in Nav2?

goThroughPoses passes through intermediate poses without stopping, producing smoother corridor traversal. followWaypoints stops at each waypoint and supports executing a task at each stop, making it better for inspection or patrol routines.

How do I cancel a Nav2 navigation goal in Python?

Call cancelTask on the BasicNavigator instance to cancel the current goal. After cancellation, getResult returns TaskResult.CANCELED, which you can detect in your completion loop.

Why does my Nav2 goal fail right after startup?

Goals sent before Nav2 lifecycle nodes are active will fail. Always call waitUntilNav2Active before sending goals, and if using AMCL, set the initial pose with setInitialPose and wait for localization to converge.

Can I compute a Nav2 path without actually navigating?

Yes, use getPath with start and goal poses to compute a nav_msgs Path without moving the robot. You can also smooth the result with smoothPath or compute multi-pose routes with getPathThroughPoses.