claude-code-session-transcript-analysis

Parse Claude Code JSONL transcripts to extract decisions, learnings, and agent state.

9|2|Updated Mar 5, 2026
One-click install
npx skills add https://github.com/DavidTeju/shared-skills --skill claude-code-session-transcript-analysis
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: claude-code-session-transcript-analysis
Source: https://github.com/DavidTeju/shared-skills/tree/main/skills/claude-code-session-transcript-analysis
Command: npx skills add https://github.com/DavidTeju/shared-skills --skill claude-code-session-transcript-analysis

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Claude Code session transcripts can be long and interrupted. This skill enables systematic analysis to recover decisions, learnings, and state from transcripts.

Core Features & Use Cases

  • Reconstructs decisions and actions from JSONL transcripts.
  • Supports recovery after context limits or interruptions.
  • Audits long-running agent sessions and reconstructs state for continuation.

Quick Start

Input the transcript file path to analyze and extract decisions, learnings, and agent state for recovery.

Frequently Asked Questions about claude-code-session-transcript-analysis

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

FAQPage Schema
How do I recover decisions from a Claude Code session transcript after an interruption?

You can recover decisions from a Claude Code session transcript by parsing the stored JSONL file to extract agent state, thinking blocks, and tool interactions. This skill detects interrupted sessions and aggregates the extracted context into a structured recovery document for continuation.

What is the best way to audit a long-running agent session in Claude Code?

Auditing a long-running agent session requires systematically analyzing the JSONL transcript to reconstruct decisions, learnings, and final responses. This skill traces tool interactions and generates executive summaries alongside task status to provide a complete recovery framework.

How do I reconstruct agent state after hitting the context limit?

Reconstructing agent state after hitting the context limit is done by parsing the Claude Code JSONL transcript to extract previous decisions and learnings. The skill aggregates this historical data into a structured recovery document, enabling seamless session continuation.

Can I extract thinking blocks and tool interactions from a JSONL session transcript?

Yes, extracting thinking blocks and tool interactions from a JSONL session transcript is a core function of this analysis process. The skill parses the transcript file to detect these elements, allowing you to trace decisions and reconstruct the agent's internal state.

Does this session transcript analysis require any external dependencies or libraries?

No, this session transcript analysis does not require external dependencies or libraries. You simply input the JSONL transcript file path to extract decisions, learnings, and agent state for recovery without needing additional environment setup.

Why does my Claude Code session recovery document show incomplete task status?

Your Claude Code session recovery document may show incomplete task status if the JSONL transcript analysis was run on an interrupted session before it reached final responses. The tool extracts available decisions and tool interactions to reconstruct as much state as possible.