ls-insights-deep

Scan and merge Claude Code JSONL history into an HTML insights report.

Updated Aug 5, 2026
One-click install
npx skills add https://github.com/ahostbr/liteharness --skill ls-insights-deep
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ls-insights-deep
Source: https://github.com/ahostbr/liteharness/tree/main/liteharness/catalog/skills/ls-insights-deep
Command: npx skills add https://github.com/ahostbr/liteharness --skill ls-insights-deep

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It eliminates the guesswork of understanding long-term Claude Code usage by producing a comprehensive analysis across the full history of sessions, not just recent activity.

Core Features & Use Cases

  • Full-history aggregation: Merges facets, session-meta, and raw JSONL/transcript sources into a single unified dataset for analysis.
  • Multi-lens diagnostic breakdown: Runs four parallel analysis lenses covering project/topic landscape, productivity/velocity patterns, friction/quality signals, and evolution over time.
  • Beautiful, shareable reporting: Generates a self-contained HTML report by loading the mockup skill and saving the resulting visualization to an insights report file.

Use case: When you want to understand how your work focus, tooling, friction categories, and outcomes have changed over months of Claude Code sessions, this is the right analysis pass.

Quick Start

Ask for deep insights report generation by scanning the aggregated Claude Code usage dataset and producing the HTML report at the default output path for this skill.

Frequently Asked Questions about ls-insights-deep

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

FAQPage Schema
How do I analyze Claude Code JSONL conversation history for usage patterns?

To analyze Claude Code JSONL conversation history, this skill scans and merges full-history session data into a structured dataset, quantifying projects, tools, productivity, and friction patterns over time. It aggregates facets and session-meta to provide a comprehensive retrospective analysis.

Can I generate an HTML report from months of Claude Code sessions?

Yes, you can generate an HTML report from Claude Code sessions by loading a mockup skill to render visualizations of your aggregated usage data. The process synthesizes JSON output from four parallel structured analyses and saves the resulting self-contained report to a file.

What is session clustering and friction analysis in AI coding assistants?

Session clustering and friction analysis in AI coding assistants involves grouping historical conversations to identify productivity velocity patterns and quality signals. This skill applies four parallel analysis lenses to extract friction categories, outcomes, and evolution over time from raw JSONL transcript sources.

Does this tool require any external dependencies to run JSONL aggregation?

No external dependencies are required to run JSONL aggregation and deep usage insights generation. The skill operates independently to scan full-history Claude Code data, extract first-prompts and tool counts, and execute parallel structured analyses without needing additional packages.

What's the best way to quantify project topics and tool usage across long-term AI sessions?

The best way to quantify project topics and tool usage across long-term AI sessions is running a multi-lens diagnostic breakdown on aggregated JSONL data. This approach extracts tool counts and first-prompts from raw sessions to map the project landscape and track evolution over months.