mppi-critics

Configure Nav2 MPPI controller critic plugin weights and parameters for trajectory scoring.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Tuning the Nav2 MPPI controller requires balancing nine interacting critic plugins whose weights determine whether a robot follows paths, avoids obstacles, and reaches goals correctly. Without a reference, misconfigured weights cause corner cutting, corridor refusal, goal orbiting, and unwanted reversing. ## Core Features & Use Cases - Per-Critic Parameter Reference: Documents every parameter, default, and behavior for ConstraintCritic, CostCritic, GoalCritic, GoalAngleCritic, PathAlignCritic, PathFollowCritic, PathAngleCritic, PreferForwardCritic, TwirlingCritic, and VelocityDeadbandCritic. - Critic Interaction Analysis: Explains known conflicts such as PathAlignCritic versus GoalCritic near goals and CostCritic versus PathAlignCritic in narrow passages, with concrete resolutions. - Ready-Made Weight Profiles: Provides YAML configurations for open indoor, narrow hallway, and cluttered room environments plus a step-by-step tuning methodology. - Use Case: A robot refuses to enter a 0.9m corridor. Use this Skill to identify that CostCritic weight is too high relative to PathAlignCritic and apply the narrow hallway profile. ## Quick Start Ask the AI to tune the MPPI critics so the robot tracks the global path tightly through narrow hallways without clipping obstacles.

Frequently Asked Questions about mppi-critics

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

FAQPage Schema
How do I tune Nav2 MPPI controller critics?

Start with the open indoor baseline profile, enable trajectory visualization in RViz2, and observe pathologies like corner cutting or goal oscillation. Adjust one critic weight at a time in roughly 20 percent increments, then test in the hardest scenario before deployment.

What does PathAlignCritic do in MPPI navigation?

PathAlignCritic penalizes lateral deviation from the global plan and is typically the highest-weighted critic. Increase its cost_weight for tighter path tracking in hallways, or decrease it if the robot refuses to deviate around obstacles blocking the path.

Why does my robot refuse to enter narrow corridors with MPPI?

CostCritic penalizes trajectories near inflated wall costs while PathAlignCritic forces corridor-center tracking. Lower CostCritic cost_weight relative to PathAlignCritic, or reduce the costmap inflation radius so the path dominates.

How do I stop MPPI robot from driving backwards?

Increase PreferForwardCritic cost_weight, which penalizes negative linear velocity trajectories. Set it above 20 with threshold_to_consider at 0.0 to forbid reversing entirely, or keep it moderate at 3-5 to allow backing out of dead ends.

When should consider_footprint be enabled in CostCritic?

Enable consider_footprint for robots with large or non-circular footprints so collision checks cover the full polygon instead of a single point. It costs 3-10 times more CPU, so circular robots should rely on proper inflation instead.