session-replay

Analyze claude-trace JSONL files for session health, token usage, and error patterns.

1|Updated Nov 11, 2025
One-click install
npx skills add https://github.com/rysweet/RustyClawd --skill session-replay
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: session-replay
Source: https://github.com/rysweet/RustyClawd/tree/main/.claude/skills/session-replay
Command: npx skills add https://github.com/rysweet/RustyClawd --skill session-replay

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps you understand and debug the performance, token usage, and error patterns of your Claude sessions by analyzing trace files.

Core Features & Use Cases

  • Session Health Analysis: Monitor token usage, request timing, and error rates.
  • Error Pattern Detection: Identify and categorize recurring failures.
  • Tool Usage Analytics: Analyze how tools are being used and find bottlenecks.
  • Use Case: If a session was unexpectedly slow or produced errors, you can use this Skill to pinpoint the exact API calls, token consumption, and error types that caused the issue.

Quick Start

Use the session-replay skill to analyze the health of your latest session trace.

Frequently Asked Questions about session-replay

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

FAQPage Schema
How do I analyze Claude session performance and token usage from trace files?

To analyze Claude session performance, you can parse claude-trace JSONL files to extract session health metrics, calculate token consumption, and identify error patterns using Python's standard library for API-level trace data analysis.

What is the best way to debug recurring errors in my Claude API sessions?

The best way to debug recurring errors in Claude API sessions is to analyze JSONL trace files to categorize error patterns, monitor request timing, and pinpoint exact API calls causing failures through trace data analysis.

Can I detect tool usage bottlenecks and optimize token consumption using session traces?

Yes, you can detect tool usage bottlenecks and optimize token consumption by analyzing JSONL session trace files to evaluate how tools are being used and calculate detailed token usage metrics.

Does session trace analysis require external Python libraries or dependencies?

Session trace analysis does not require external Python libraries; it relies entirely on Python's standard library for parsing JSONL files and calculating metrics from claude-trace data.

What insights can I get from claude-trace JSONL files when debugging slow sessions?

Debugging slow sessions with claude-trace JSONL files provides insights into request timing, token usage, error rates, and specific API calls, helping you pinpoint the exact causes of performance issues.