insights

Generate coaching-style HTML usage insights reports from Claude Code session histories.

11|2|Updated May 29, 2025
One-click install
npx skills add https://github.com/yulonglin/dotfiles --skill insights-yulonglin
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: insights
Source: https://github.com/yulonglin/dotfiles/tree/main/claude/local-marketplace/plugins/insights-toolkit/skills/insights
Command: npx skills add https://github.com/yulonglin/dotfiles --skill insights-yulonglin

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Generate coaching-style Claude Code usage insights reports from session histories by turning raw transcripts into structured facets and actionable recommendations.

Core Features & Use Cases

  • Generate coaching-style HTML reports from Claude Code session history.
  • Filter reports by project to compare usage across projects and time periods.
  • Update reports incrementally by caching facets for fast re-generation.
  • Store and review outputs under ~/.claude/custom-insights/ for archiving and sharing.

Quick Start

Run /insights to generate a full coaching report from your Claude Code session history.

Frequently Asked Questions about insights

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

FAQPage Schema
How do I generate usage reports from Claude Code session history?▼

Generate usage reports from Claude Code session history by running the /insights command, which transforms raw transcripts into structured facets and coaching-style actionable recommendations.

Can I filter Claude Code usage insights by individual project?▼

You can filter Claude Code usage insights by individual project to compare usage across different projects and time periods, while storing the generated HTML reports under ~/.claude/custom-insights/.

What do I need to generate Claude Code insights and temporal trend reports?▼

Generating Claude Code insights and temporal trend reports requires Python 3.9+, Gemini CLI installed, and a local clone of claude-code-insights to process session histories into HTML outputs.

How does incremental report generation handle cached facets for session history?▼

Incremental report generation caches facets from session history to enable fast re-generation of coaching-style insights without reprocessing the entire raw transcript every time.

What is the best way to analyze temporal trends in Claude Code session histories?▼

Analyze temporal trends in Claude Code session histories by generating coaching-style HTML reports that apply per-project filtering and trend analysis across archived sessions.