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.