session-insights

Analyze Claude Code JSONL session logs to generate usage analytics and friction insights.

Updated Mar 24, 2026
One-click install
npx skills add https://github.com/Oruga420/claude-code-skills --skill session-insights-oruga420
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: session-insights
Source: https://github.com/Oruga420/claude-code-skills/tree/main/session-insights
Command: npx skills add https://github.com/Oruga420/claude-code-skills --skill session-insights-oruga420

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The session-insights skill analyzes Claude Code session histories to surface usage patterns, identify friction points, and produce prioritized, actionable recommendations that reduce wasted time and token cost.

Core Features & Use Cases

  • Session aggregation: scan recent JSONL session logs and compute totals for sessions, messages, duration, and token consumption.
  • Tool and activity analysis: extract and rank tool usage, file languages, git operations, and most-worked directories.
  • Friction classification & suggestions: detect errors and classify them into taxonomy categories, surface repeated user instructions for CLAUDE.md, and recommend features to try (MCP, custom skills, hooks).
  • Use case: audit the last 50 developer sessions to find frequent tool failures, high-cost prompts, and opportunities to automate repetitive interactions.

Quick Start

Use the session-insights skill to analyze my last 50 Claude Code sessions and produce a concise usage, friction, and recommendation report.

Frequently Asked Questions about session-insights

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

FAQPage Schema
How do I analyze Claude Code session logs for usage analytics and friction points?

You can analyze Claude Code session logs by applying a skill that processes recent JSONL files to extract message counts, tool usage, token consumption, and errors. It generates aggregated metrics, narrative insights, and classified friction categories.

How do I estimate token costs from my Claude Code session histories?

To estimate token costs from Claude Code session histories, you can process up to 50 recent JSONL session logs. The analysis computes total token consumption and generates a report with estimated costs and high-cost prompt identification.

Can I detect repeated user instructions in Claude Code sessions to improve my CLAUDE.md file?

Yes, analyzing Claude Code sessions can surface repeated user instructions. The process scans JSONL logs to identify repetitive interactions and generates specific CLAUDE.md recommendations to automate or streamline those instructions.

What is the best way to audit developer sessions for frequent tool failures in Claude Code?

The best way to audit developer sessions for tool failures is to scan JSONL session logs to extract and classify errors into taxonomy categories. This friction analysis identifies frequent tool failures and produces actionable recommendations.

Does session analysis skip short Claude Code interactions under three messages?

Yes, session analysis skips interactions under three messages to ensure meaningful data extraction. This threshold filters out trivial exchanges in the JSONL logs, focusing the usage analytics on substantial developer sessions.

Can I analyze git activity and file languages worked on within Claude Code sessions?

Yes, you can analyze git activity and file languages within Claude Code sessions. The process extracts git operations, most-worked directories, and file language signals from JSONL logs to detect usage patterns and surface activity metrics.