regulated-pure-pursuit

Configure Nav2 Regulated Pure Pursuit controller parameters for path tracking.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Tuning the Nav2 Regulated Pure Pursuit (RPP) controller involves many interdependent parameters—lookahead distance, curvature regulation, cost-based slowdown, and rotate-to-heading behavior—and misconfiguring them causes oscillation, corner cutting, or stalling. This Skill provides structured guidance and a complete reference YAML to configure RPP correctly. ## Core Features & Use Cases - Lookahead Configuration: Set fixed or velocity-scaled lookahead distances with min/max clamps and lookahead time. - Regulation Behaviors: Configure curvature-based and costmap-based linear velocity scaling, including matching inflation_cost_scaling_factor to the costmap inflation layer. - Differential-Drive Support: Enable rotate-to-heading behavior with correct mutual-exclusion rules against allow_reversing. - Use Case: A robotics engineer deploying a differential-drive robot in a warehouse needs a low-CPU path follower; use this Skill to produce a complete controller_server YAML and diagnose issues like oscillation on straight paths or jerking at path start. ## Quick Start Ask the assistant to generate a complete Nav2 Regulated Pure Pursuit controller YAML configuration for a differential-drive robot with velocity-scaled lookahead and rotate-to-heading enabled.

Frequently Asked Questions about regulated-pure-pursuit

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

FAQPage Schema
How do I configure the Nav2 Regulated Pure Pursuit controller?

Set the FollowPath plugin to nav2_regulated_pure_pursuit_controller::RegulatedPurePursuitController in the controller_server parameters, then configure desired_linear_vel, lookahead settings, and regulation behaviors. A complete YAML example covers all required parameters.

What is velocity-scaled lookahead in pure pursuit?

Velocity-scaled lookahead computes the lookahead distance as current velocity multiplied by lookahead_time, clamped between min_lookahead_dist and max_lookahead_dist. This gives tight control at low speed and smoother anticipation at high speed.

Can I use rotate_to_heading and allow_reversing together in RPP?

No, use_rotate_to_heading and allow_reversing are mutually exclusive in the Regulated Pure Pursuit controller. When rotate-to-heading is enabled for differential-drive robots, allow_reversing must be set to false.

Why does my robot oscillate on straight paths with pure pursuit?

Oscillation usually means the lookahead distance is too small or velocity-scaled lookahead is not enabled. Enable use_velocity_scaled_lookahead_dist or increase min_lookahead_dist to stabilize tracking.

When should I use RPP instead of MPPI in Nav2?

Use RPP for simple patrol tasks in open areas, robots with limited compute, or as a baseline controller. It does not optimize trajectories or handle narrow passages and dynamic obstacles as well as MPPI.