Does it re-process every session every time I run it?

No, the skill implements a caching system for session facets. Re-runs only process new or modified sessions, making it very fast after the initial execution.

Can I filter the insights for a specific project?

Yes, you can use the --project flag followed by the project name to filter the analytics and reporting to a specific workstream.

Is there a way to preview the analysis plan before running it?

Yes, you can use the --dry-run flag to preview the batch processing plan and see which sessions are slated for analysis.

How does this skill analyze Claude Code sessions?

The skill extracts clean transcripts from your local session JSONL files and uses Gemini models to categorize goals, outcomes, and friction points within each session.

Where can I find the final analysis report?

The skill generates an interactive HTML report located at ~/.claude/custom-insights/report.html which you can open in any web browser.

Claude Code Usage Insights

Name: Claude Code Usage Insights
Author: yulonglin

byyulonglin

•

分析与监控

Analyzes historical Claude Code session transcripts to generate comprehensive usage reports and actionable intelligence using AI-powered processing.

Claude Code Usage Insights provides deep visibility into your AI coding history by processing session JSONL files and using Gemini to extract meaningful facets like project goals, outcomes, and common friction points. Unlike the default history which is limited to recent interactions, this skill allows for cross-session analytics, project-specific breakdowns, and the generation of interactive HTML reports. It is particularly useful for developers looking to optimize their AI-assisted workflows, audit session quality, and track productivity trends over long periods of time.

主要功能

01Deep session analysis across all historical Claude Code logs beyond the standard limit.

02Automated extraction of session goals, outcomes, and friction points using Gemini AI.

03Advanced filtering capabilities by project name, session count, or specific date ranges.

04Interactive HTML report generation with charts and per-project data breakdowns.

054 GitHub stars

06Intelligent facet caching to ensure high-speed performance on incremental re-runs.

使用场景

01Generating comprehensive usage reports for project post-mortems or workflow optimization reviews.

02Auditing AI-assisted development sessions to evaluate the effectiveness of prompt strategies.

03Tracking productivity trends and identifying recurring coding bottlenecks across multiple projects.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add yulonglin/dotfiles .migrated

For use in Claude.ai and ChatGPT

Download Skill