session-read

Parses Claude session JSONL files into structured markdown summaries of activities and decisions.

39|6|Updated Jan 5, 2026
One-click install
npx skills add https://github.com/the-agency-ai/the-agency --skill session-read
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: session-read
Source: https://github.com/the-agency-ai/the-agency/tree/main/.claude/skills/session-read
Command: npx skills add https://github.com/the-agency-ai/the-agency --skill session-read

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill simplifies the process of reviewing and understanding complex session data by generating concise, structured summaries from session JSONL files.

Core Features & Use Cases

  • Data Parsing: Reads session files from specified identifiers or indexes.
  • Structured Output: Produces markdown-formatted summaries covering metadata, user messages, tool activities, file modifications, decisions, and git operations.
  • Use Case: Ideal for developers and project managers needing quick insights into session histories for review, auditing, or documentation purposes.

Quick Start

Use the session-read skill to generate a summary by providing a session ID or index, and it will produce an organized markdown report.

Frequently Asked Questions about session-read

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

FAQPage Schema
How do I extract structured summaries from Claude session JSONL files?

You can extract structured summaries from Claude session JSONL files by providing a session ID or index. This generates an organized markdown report covering metadata, user messages, tool activities, file modifications, and git operations.

What is the best way to review Claude session logs for auditing purposes?

Reviewing Claude session logs for auditing is best done by generating a structured markdown summary. This summarizes diverse data points from session JSONL files into an organized report, providing quick insights into session activities and decisions.

How do I convert Claude session logs into markdown reports?

You convert Claude session logs into markdown reports by parsing the JSONL session files using a session identifier or index. The output is a structured markdown document detailing metadata, tool activities, and git operations for easier review.

Can I track file modifications and git operations from a Claude session history?

Yes, you can track file modifications and git operations from a Claude session history. Parsing the session JSONL files produces a markdown summary that explicitly covers file modifications, decisions, and git operations.

Do I need a specific session ID to parse Claude session data?

You need a specific session ID or an index to parse Claude session data efficiently. Providing this identifier allows the tool to locate and read the correct JSONL session files to generate your markdown summary.