debug-replay

Installation
SKILL.md

Debug Replay

Investigate bugs by finding session replays where the error occurred, extracting the interaction timeline, and distilling it into numbered reproduction steps an engineer can follow. This skill bridges the gap between "a user reported a bug" and "here's exactly how to reproduce it."


CRITICAL: Tool Reference

This skill operates on three Amplitude Session Replay tools. Use them in this order:

  1. Amplitude:get_amp_session_replay_info with action: "search" — Find sessions matching event filters (errors, specific users, time windows). Returns session metadata and replay links.
  2. Amplitude:get_amp_session_replay_info with action: "list" — Simple paginated listing when you already have a user/device ID or just need recent sessions. Returns a session replay ID in device_id/session_id format.
  3. Amplitude:get_amp_session_replay_info with action: "events" — Decode a specific replay into an interaction timeline: navigations, clicks, inputs, scrolls. Pass the ID from the tools above as sessionReplayId.

Supporting tools used in this skill:

  • Amplitude:use_amplitude_cohorts with action: "find" — Look up users by email, user ID, or other identifiers.
  • Amplitude:manage_amp_events with action: "get" and kind: "event" — Discover valid event names before filtering. Never guess event names.
  • Amplitude:get_properties — Discover properties available on an event for filtering.
  • Amplitude:use_amp_flags with action: "list_deployments" — Check if error aligns with a recent deploy.
Installs
3
GitHub Stars
34
First Seen
Jul 5, 2026
debug-replay — amplitude/mcp-marketplace