replay-session

Replay Tracey session dumps to map events to code paths and generate diagnostic reports.

11|Updated Mar 10, 2026
One-click install
npx skills add https://github.com/satanyakiv/NutriSport --skill replay-session-satanyakiv
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: replay-session
Source: https://github.com/satanyakiv/NutriSport/tree/main/.claude/skills/replay-session
Command: npx skills add https://github.com/satanyakiv/NutriSport --skill replay-session-satanyakiv

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Read a Tracey session dump file, map events to code paths, reconstruct the user journey, and identify where things went wrong. Use when user provides a crash dump, says "replay this session", "what happened before the crash", "analyze this dump", "tracey dump", or provides a path to a replay JSON file.

Core Features & Use Cases

  • Map events to source paths — for each event, resolve corresponding code paths and UI screens.
  • Reconstruct user journey — build a chronological narrative of interactions leading to a crash.
  • Identify failure points — detect last successful state, first error, and latency gaps.
  • Generate diagnostic report — produce a structured markdown report with timeline, failure analysis, and recommendations.
  • Optional replay automation — support claude-in-mobile-like commands to replay gestures and compare with expected state.

Quick Start

Provide a Tracey session dump path to generate a replay report.

Frequently Asked Questions about replay-session

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

FAQPage Schema
How do I replay a mobile app crash dump to find what caused the failure?

To replay a crash dump, you parse the session file to map events to code paths and reconstruct the user journey chronologically. This surfaces exactly where the crash originated by correlating user interactions with navigation graphs and source code.

What is the best way to analyze a Tracey session dump for debugging?

Analyzing a Tracey session dump involves parsing the replay JSON file to identify the last successful state, first error, and latency gaps. It generates a structured diagnostic report with a timeline and failure analysis for crash investigations.

Can I reconstruct the user journey before a crash from a JSON log file?

Yes, you can reconstruct the user journey from a JSON log file by parsing the replay data to build a chronological narrative of interactions. This maps session events to corresponding UI screens and source code paths leading up to the crash.

How do I map trace events to source code paths during crash analysis?

Mapping trace events to source code paths requires correlating session dump events with navigation graphs and source code. This resolves each event to its corresponding UI screen and code path to identify failure points during crash investigations.

Does session replay work for performance reviews or only crash diagnostics?

Session replay works for both crash diagnostics and performance reviews. By replaying user interactions from a log or JSON file, it detects latency gaps and reconstructs the timeline, making it applicable for performance reviews alongside crash investigations.

What format does the diagnostic report use when analyzing session dumps?

The diagnostic report uses structured markdown to document the timeline, failure analysis, and recommendations. It details the last successful state, first error, and latency gaps identified during the session dump replay.