nav2

A guide to Nav2, the ROS 2 software stack for moving mobile robots to goals using maps, localization, path planning, and obstacle-aware control.

In plain words
What is it for?
Use it to configure Nav2, tune costmaps and planners, build behavior trees, set up AMCL or SLAM Toolbox, and follow waypoints.
Why use it?
It provides the setup and tuning knowledge needed when a robot cannot localize, plan a route, follow waypoints, or move safely.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/robium-ai/robium/skill
Any agent
npx skills add robium-ai/robium --skill skill
Clone the repo
git clone --depth 1 https://github.com/robium-ai/robium

Made for: Claude Code, Codex.

Per session 134 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 6,663 The whole file, excluding the scripts and references it only reads on demand.
Security scan B 1 finding. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00134 $0.06663
Opus 5 $0.00067 $0.03331
Sonnet 5 $0.00027 $0.01333
Haiku 4.5 $0.00013 $0.00666

Measured 2d ago against content hash c8b17858411c, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade B, and why

nav2 scanned grade B with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

The scan reads SKILL.md. This mod also ships 1 executable file (examples/bringup-launch-snippet.py), listed below but not scanned — reading those needs a real analyzer, not pattern matching.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Asks for rootmediumPrivilege escalation

A mod that escalates privileges can change anything on the machine, not only the project.

Nav2 installed (`sudo apt install ros-jazzy-navigation2 ros-jazzy-nav2-bringup`
archive/nav2/variants/2026-08-02/A/skill/SKILL.md · 398 lines

How it starts

The opening of the file, as written. The whole thing — 398 lines — stays where its author put it; the contents beside it link to each section on GitHub.

The nav-vertical core tool skill for robium: bringup, the BT Navigator and behavior trees, costmap layers, the planner/controller/smoother servers, localization (AMCL and slam_toolbox), waypoint following, and tuning a running stack. Nav2 config in this skill targets ROS 2 Jazzy Jalisco (LTS, supported to May 2029) rather than Lyrical Luth, the current overall LTS the ros2 skill defaults to — Nav2 has not yet shipped binary packages for Lyrical (tracked in ros-navigation/navigation2#6123 as of 2026-07). Gazebo Harmonic is Jazzy's paired simulator. Re-check that gap before starting a new project, and treat picking the distro itself as architect's call, not this skill's — load this skill once architect has routed you to the navigation vertical.

When to use this skill

  • Any autonomous mobile-robot navigation task: bringing up Nav2, tuning costmaps or the planner/controller, adding or debugging a behavior tree, choosing between AMCL and slam_toolbox, following waypoints.
  • The trigger phrases in the description: 'navigation', 'nav2', 'costmap', 'path planning', "robot won't move to goal", 'localization', 'SLAM', 'AMCL', 'waypoint'.
  • A robot receives a goal and never moves, or moves erratically — start here (see references/common-failures.md), not in application logic.
  • Cross-references — go to the sibling skill instead when the question is:
    • ROS 2 substrate this stack runs on (workspaces, colcon, packages, nodes, QoS, launch syntax, TF2 concepts/broadcasters) → ros2. This skill's only TF responsibility is verifying the map→odom→base_link chain exists and is current before tuning anything else; teaching TF2 itself stays in ros2 — see that skill's interfaces-and-qos and debugging references.
    • Simulating the robot Nav2 drives → the gazebo skill.
    • Visualizing costmaps, TF, or BT execution (RViz2, Foxglove) → the visualization skill.
    • Arm/manipulation tasks, learned policies → lerobot. Nav2 is mobile-base navigation only.
    • Environment/Docker setup for the ROS 2 + Nav2 + Gazebo stack → environments.
    • The whole-stack decision this feeds into → architect (routes here).

Read the full file on GitHub · 398 lines

Files

What ships with it

5 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 398 lines · 134 tokens per session scan B c8b17858411c

Subscribe to this mod's changes

nav2 is a skill published in the GitHub repository robium-ai/robium (9 stars, last pushed 4d ago), licensed MIT. It adds 134 tokens to every session and 6,663 once invoked, about $0.0007 per session on Opus 5. A static security scan graded it B with 1 finding (asks for root). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

ros2-microros

Skill "ros2-microros" from Leehyunbin0131/claude-ros2-skills, covering micro-ros instructions (ubuntu 24.04 lts & ros 2 jazzy), 1. architecture, 2. documentation entry points, 3. key concepts & patterns and a. embedded client node setup (rclc in c).

Leehyunbin0131/claude-ros2-skills · 29 tokens

ros2-troubleshooting

Diagnose ROS 2 Jazzy faults that reading the code cannot settle: QoS mismatch, sensor-mount and frame errors (REP 103/105), and odometry calibrated against CAD instead of the floor. Ships four runnable pass/fail checks.

Leehyunbin0131/claude-ros2-skills · 57 tokens

gazebo-mcp

Gazebo / gz-sim worlds, models, poses (mock + live bridge). CLI gazebo-mcp + MCP stdio serve. Use when the user mentions gazebo-mcp, /gazebo-mcp, or related domain work. One-command Grok install from GitHub.

mergeos-bounties/gazebo-mcp · 64 tokens

attach-end-effector

Mount an end-effector (parallel-jaw gripper, dexterous hand, suction tool, etc.) on a robot arm by attaching its MJCF to the arm's attachmentsite via MuJoCo's MjSpec API. Use when combining an arm MJCF and an end-effector MJCF into a single combined model. Handles known gotchas the underlying script doesn't: mesh…

PathOn-AI/PathOnRoboticsOSS · 0 tokens

urdf-to-mjcf

Use when bringing a URDF robot, hand, or CAD-generated model into MuJoCo MJCF and no hand-tuned upstream MJCF exists.

PathOn-AI/PathOnRoboticsOSS · 37 tokens

mjcf-to-urdf

Convert an MJCF (MuJoCo's XML format) to URDF for downstream consumers that don't speak MJCF (RViz, pinocchio, ROS-based motion planning, etc.). The conversion is lossy — constraints, position actuators, contact excludes, and keyframes are all dropped. Use this skill ONLY when a URDF-only consumer needs the kinematic…

PathOn-AI/PathOnRoboticsOSS · 97 tokens