cc-insights

Analyze Claude Code interaction history to extract usage patterns and project activity.

54|19|Updated Jan 13, 2026
One-click install
npx skills add https://github.com/Xueheng-Li/sysu-awesome-cc --skill cc-insights-xueheng-li
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cc-insights
Source: https://github.com/Xueheng-Li/sysu-awesome-cc/tree/main/skills/cc-insights
Command: npx skills add https://github.com/Xueheng-Li/sysu-awesome-cc --skill cc-insights-xueheng-li

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Archive and analyze Claude Code interaction history to reduce manual tracking and surface actionable insights.

Core Features & Use Cases

  • Automated archiving of chat sessions from Claude Code history into organized Markdown with time-based indexing.
  • Deep analytics including per-project activity, hourly distribution, and prompt-length metrics to reveal usage patterns.
  • Generates CC insights reports and executive summaries for governance and optimization.

Quick Start

Generate an automated CC insights report by archiving and analyzing Claude Code interaction history.

Frequently Asked Questions about cc-insights

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

FAQPage Schema
How do I analyze Claude Code interaction history to extract usage patterns?

To analyze Claude Code interaction history, this skill reads local history.jsonl files and timeline data to extract project activity, hourly distribution, and prompt-length metrics. It outputs structured metrics and a narrative summary to reveal usage trends.

Can I automatically archive chat sessions from Claude Code into Markdown?

Yes, you can automatically archive chat sessions from Claude Code history into organized Markdown files. The skill applies time-based indexing to the archived interaction data, creating structured records for reporting.

What metrics are included in a Claude Code insights report for project activity?

A Claude Code insights report includes per-project activity, hourly distribution, and prompt-length metrics. These analytics surface usage patterns and project hotspots from your archived timeline data.

Does the cc-insights skill require any external dependencies to process local history files?

No external dependencies are required to process local history files. The skill uses internal scripts and references to read history.jsonl and timeline data directly, generating structured metrics without external packages.

What is the best way to generate an executive summary from archived Claude Code projects?

The best way to generate an executive summary from archived Claude Code projects is to apply the skill's deep analytics to your timeline data. It processes interaction history to produce narrative summaries suitable for governance and optimization.

Why do I need to archive Claude Code interactions before analyzing usage trends?

You need to archive Claude Code interactions to establish a persistent, organized record of timeline data. This archived history allows the skill to accurately compute per-project activity and reveal usage hotspots over time.