history-insight

Analyze Claude Code JSONL session files to generate structured insights reports.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/ab180/claude-camp --skill history-insight-ab180
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: history-insight
Source: https://github.com/ab180/claude-camp/tree/main/history-insight
Command: npx skills add https://github.com/ab180/claude-camp --skill history-insight-ab180

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

Analyze Claude Code session history to extract actionable insights and preserve conversation context for future reference and decision-making.

Core Features & Use Cases

  • Session discovery: locate and enumerate relevant JSONL session files across a project or all workspaces.
  • Selective extraction: filter and parse user messages, assistant responses, and optional summaries to produce a concise narrative.
  • Batch processing & reporting: handle 4+ files with a scalable pipeline, generate structured insights, and deliver a readable report.

Quick Start

Analyze a project’s Claude Code session history to generate an insights report.

Frequently Asked Questions about history-insight

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

FAQPage Schema
How do I extract insights from Claude Code session history files?

Analyzing session history involves discovering JSONL files across a project or all workspaces, then selectively extracting user and assistant messages to produce a concise narrative report. It helps preserve conversation context for future decision-making.

Can I filter session history analysis by time range and project scope?

Yes, you can filter the analysis by time range and scope. The process applies selective extraction from JSONL data across a specific project's sessions or all workspaces, ensuring the structured insights report reflects only the targeted conversation context.

Do I need jq installed to process JSONL session data?

Yes, jq is a required dependency for processing JSONL session data. It enables the deterministic file discovery and selective extraction pipeline needed to parse conversation history and generate a structured insights report.

What is the best way to handle batch processing for multiple session history files?

The best way to handle batch processing for multiple session files is using a scalable pipeline that processes four or more JSONL files simultaneously. This approach extracts conversation context and generates a structured insights report with robust error handling.

How does session history analysis preserve conversation context for future use?

Session history analysis preserves conversation context by selectively extracting user messages, assistant responses, and optional summaries from JSONL files to produce a concise narrative. This structured report captures actionable context for future reference and decision-making.

What limitations exist when analyzing JSONL session files across all workspaces?

When analyzing JSONL session files across all workspaces, limitations may arise from the volume of files requiring batch processing and the dependency on jq for parsing. Robust error handling manages extraction failures, but large datasets can impact the report generation pipeline.