smac-planner-hybrid-a-star

Configures the Nav2 SMAC Hybrid-A* planner for kinematically feasible path planning with turning radius constraints.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Robots with non-holonomic constraints (Ackermann steering, differential drive) cannot follow arbitrary 2D grid paths, causing controllers to fail or produce jerky motion. This Skill provides correct configuration of the Nav2 SMAC Hybrid-A* planner so generated paths respect minimum turning radius and motion model limits from the start. ## Core Features & Use Cases - Complete YAML Configuration: A ready-to-adapt planner_server parameter block covering motion models, turning radius, angle quantization, and penalty tuning. - Penalty Tuning Guidance: Concrete strategies for cost_penalty, non_straight_penalty, reverse_penalty, and change_penalty to fix wall-hugging, oscillation, and unwanted reversing. - Performance & Troubleshooting: Mitigations for the O(X × Y × θ) search cost, including costmap downsampling, bin reduction, and lookup table sizing. - Use Case: An Ackermann robot must navigate a parking maneuver where approach angle matters; configure REEDS_SHEPP search with the vehicle's real minimum turning radius so the planner outputs an executable path directly. ## Quick Start Ask the AI to generate a Nav2 planner_server YAML configuration using the SMAC Hybrid-A* plugin for a differential drive robot with a 0.2 meter minimum turning radius.

Frequently Asked Questions about smac-planner-hybrid-a-star

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

FAQPage Schema
How do I configure the Nav2 SMAC Hybrid-A* planner?

Add nav2_smac_planner::SmacPlannerHybridAstar as a planner_plugins entry in the planner_server YAML, then set minimum_turning_radius, motion_model_for_search, and angle_quantization_bins. A complete parameter block with penalties and smoother settings is provided in the Skill.

What minimum turning radius should I use for a differential drive robot?

Differential drive robots can spin in place, but setting the radius to exactly zero produces degenerate motion primitives. Use a small value between 0.1 and 0.4 meters to get smooth arcs while retaining tight turning ability.

Dubins vs Reeds-Shepp motion model: which should I choose?

Dubins produces forward-only arcs and suits robots that cannot reverse. Reeds-Shepp allows forward and reverse arcs, making it preferable for differential drive robots and constrained maneuvers like parking or docking.

Why does the Hybrid-A* planner time out or run slowly?

The 3D search space (x, y, heading) is inherently more expensive than 2D planning. Mitigate by downsampling the costmap, reducing angle_quantization_bins to 36, lowering max_planning_time, or shrinking lookup_table_size to match your map.

Why does the planned path hug walls or obstacles?

Wall-hugging happens when cost_penalty is too low, so the planner ignores costmap inflation costs. Increase cost_penalty from the default 2.0 to 3.0–5.0 to make the planner strongly avoid high-cost regions near obstacles.

When should I not use the Hybrid-A* planner?

Avoid it in simple open environments where NavFn plus controller smoothing suffices, when high-frequency replanning is required, or for holonomic robots that gain nothing from non-holonomic motion primitives.