bag-replay-debugger

Diagnose rosbag replay mismatches by inspecting topics, clocks, remaps, and timing.

1|Updated Mar 16, 2026
One-click install
npx skills add https://github.com/00PrabalK00/claude-skills --skill bag-replay-debugger
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bag-replay-debugger
Source: https://github.com/00PrabalK00/claude-skills/tree/main/skills/bag-replay-debugger
Command: npx skills add https://github.com/00PrabalK00/claude-skills --skill bag-replay-debugger

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Check rosbag or recorded data replay issues involving topic names, clocks, remaps, timing, and consumer mismatch. Use when replayed data does not reproduce expected behavior.

Core Features & Use Cases

  • Diagnose replay discrepancies by inspecting topic naming, time synchronization, and remapping behavior across rosbag playback.
  • Pinpoint root causes using minimal evidence sets (logs, configs, and runtime context) and propose concrete fixes.
  • Use cases: validating recorded-session playback for robot rehearsals, debugging sensor data alignment, and ensuring deterministic replay for tests.

Quick Start

Diagnose rosbag replay issues by providing your recorded data and environment context to surface misnamed topics, clock mismatches, and remap errors.

Frequently Asked Questions about bag-replay-debugger

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

FAQPage Schema
Why does my rosbag replay not match the original recorded behavior?

Rosbag replay mismatches typically arise from topic renames, clock drift, incorrect remaps, or consumer lag. Inspecting topics, clocks, remaps, and timing identifies the root cause and yields actionable fixes for your specific replay scenario.

How do I debug rosbag replay issues with topic names and remaps?

To debug rosbag replay issues, inspect topic naming and remapping behavior across playback to find misnamed topics or remap errors. Capture minimal evidence from logs and runtime context, then apply targeted fixes to align consumer expectations.

What causes clock drift and timing issues during rosbag replay?

Clock drift and timing issues during rosbag replay occur when time synchronization between recorded data and the runtime environment fails. Inspecting clock behavior and timing discrepancies pinpoints the mismatch to ensure deterministic replay and test validation.

Can I use rosbag replay diagnostics for robot rehearsal and sensor data alignment?

Yes, rosbag replay diagnostics validate recorded-session playback for robot rehearsals and debug sensor data alignment. Inspecting topics, clocks, and timing ensures deterministic replay by surfacing consumer mismatch and remap errors for actionable fixes.

What is the best way to diagnose rosbag replay mismatches with minimal evidence?

The best way to diagnose rosbag replay mismatches is inspecting topics, clocks, remaps, and timing using minimal evidence sets from logs and configs. This deterministic approach captures relevant runtime context to output a concise root-cause plan with next steps.

Do I need specific tools to fix rosbag replay consumer lag and time synchronization?

No specific tools are required to fix rosbag replay consumer lag and time synchronization beyond your standard ROS environment. Providing recorded data and environment context surfaces clock mismatches and consumer lag for deterministic diagnostics and actionable fixes.