history-insight

Extract actionable insights from Claude Code session history in .jsonl format.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/karohani/my-claude-friends --skill history-insight
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: history-insight
Source: https://github.com/karohani/my-claude-friends/tree/main/plugins/session-wrap/skills/history-insight
Command: npx skills add https://github.com/karohani/my-claude-friends --skill history-insight

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

The History Insight Skill helps users analyze Claude Code session history to extract meaningful insights, patterns, and actionable takeaways for review and improvement.

Core Features & Use Cases

  • Analyze multiple or single session histories to identify trends, patterns, and notable interactions.
  • Generate concise summaries and recommendations from historical conversations.
  • Produce Markdown-formatted reports suitable for documentation or review.

Quick Start

Run history-insight on your session logs to reveal patterns and insights.

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?

Use jq to parse .jsonl session history files from ~/.claude/projects, identify interaction patterns, and generate Markdown-formatted summaries for documentation and review.

Can I analyze multiple Claude Code session logs at once?

Batch processing supports small sets of 1-3 files and large sets of 4+ files. Optional parallelism is available to handle large volumes of Claude Code session history efficiently.

Do I need jq to process Claude Code .jsonl history files?

Yes, jq is a required dependency for extracting data from .jsonl files. The environment also requires bc and coreutils to run the session history analysis and generate reports.

What is the best way to generate a Markdown report from session history?

Run the history analysis tool on stored .jsonl session files to produce structured, Markdown-ready insights. It identifies actionable takeaways and patterns directly from the conversation logs.

How do I handle very large sets of Claude Code session history?

Use batch processing with optional parallelism for large sets of 4 or more files. Preprocessing is supported to handle very large .jsonl files before extracting patterns and generating summaries.