session-replay
Analyze claude-trace JSONL files for session health, patterns, and actionable insights. Use when debugging session issues, understanding token usage, or identifying failure patterns.
npx skills add majiayu000/claude-skill-registry --skill session-replay-rysweet-azlin-2 --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# Session Replay Skill ## Purpose This skill analyzes claude-trace JSONL files to provide insights into Claude Code session health, token usage patterns, error frequencies, and agent effectiveness. It complements the `/transcripts` command by focusing on API-level trace data rather than conversation transcripts. ## When to Use This Skill - **Session debugging**: Diagnose why a session was slow or failed - **Token analysis**: Understand token consumption patterns - **Error patterns**: Identify recurring failures across sessions - **Performance optimization**: Find bottlenecks in tool usage - **Agent effectiveness**: Measure which agents/tools are most productive ## Quick Start ### Analyze Latest Session ``` User: Analyze my latest session health ``` I'll analyze the most recent trace file: ```python # Read latest trace file from .claude-trace/ trace_dir = Path(".claude-trace") trace_files = sorted(trace_dir.glob("*.jsonl"), key=lambda f: f.stat().st_mtime) latest = trace_files[-1] if trace_files else None # Parse and analyze if latest: analysis = analyze_trace_file(latest) print(format_session_report(analysis)) ``` ### Compare Multiple Sessions ``` User: Compare token usage across m
- Purpose
- When to Use This Skill
- Quick Start
- Analyze Latest Session
- Compare Multiple Sessions
- Actions
- Action: health
- Action: errors
- Action: compare
- Action: tools
- Implementation Notes
- Parsing JSONL Traces
- Locating Trace Files
- Error Handling
What does the session-replay skill do?
Analyze claude-trace JSONL files for session health, patterns, and actionable insights. Use when debugging session issues, understanding token usage, or identifying failure patterns.
How do I install it?
Run `npx skills add majiayu000/claude-skill-registry --skill session-replay-rysweet-azlin-2 --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From majiayu000/claude-skill-registry, a repository with 534 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.