map-saver-config

Configure Nav2 map_saver to persist occupancy grids to YAML and image files.

18|2|Updated Apr 20, 2026
One-click install
npx skills add https://github.com/wimblerobotics/ros2-copilot-skills --skill map-saver-config
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: map-saver-config
Source: https://github.com/wimblerobotics/ros2-copilot-skills/tree/main/map-saver-config
Command: npx skills add https://github.com/wimblerobotics/ros2-copilot-skills --skill map-saver-config

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Configure Nav2 map saver to save maps from SLAM with thresholds and periodic saving.

Core Features & Use Cases

  • Automatic map saving: Save occupancy grids to YAML + image files with tunable timeouts and thresholds.
  • QoS-aware saving: Use TRANSIENT_LOCAL to capture last published maps for accurate archiving.
  • CLI and Service integration: Save maps via map_saver_cli and /map_saver/save_map service for automation.

Quick Start

Configure the map_saver parameters to automatically save the current map at a defined interval.

Frequently Asked Questions about map-saver-config

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

FAQPage Schema
How do I automatically save Nav2 occupancy grids to disk during a SLAM run?▼

You can automatically save Nav2 occupancy grids during a SLAM run by configuring the ROS 2 map_saver YAML parameters to define tunable timeouts and thresholds for periodic map persistence to YAML and image files.

What is the best way to configure map saving thresholds in ROS 2 navigation deployments?▼

Configuring map saving thresholds in ROS 2 navigation deployments involves defining YAML parameters for the Nav2 map_saver to control occupancy grid archiving behavior based on tunable timing and value limits.

How does QoS TRANSIENT_LOCAL work when saving ROS 2 maps?▼

QoS TRANSIENT_LOCAL works when saving ROS 2 maps by allowing the map_saver to capture the last published occupancy grid, ensuring accurate archiving of the most recent map state during navigation maintenance.

Can I use the map_saver_cli and save_map service to automate ROS 2 map updates?▼

Yes, you can automate ROS 2 map updates by utilizing the map_saver_cli tool and the /map_saver/save_map service contract to trigger occupancy grid persistence during routine maintenance.

Do I need additional dependencies to periodically save Nav2 maps with configurable timing?▼

No additional dependencies are required to periodically save Nav2 maps, as the configuration relies solely on YAML parameter definitions and the ROS 2 navigation stack's built-in map_saver component.

Why are my Nav2 map_saver YAML parameter changes not applying to the saved occupancy grid?▼

Nav2 map_saver YAML parameter changes may not apply if the QoS profile is not set to TRANSIENT_LOCAL, preventing the saver from capturing the correct published map state for disk archiving.