Skip to main content
skill CX Codex

insights — Claude Code skill: analytics and installation

The insights skill turns project memory and session history into analytics on corrections, saved learnings, and coding activity. Ask for a report to spot recurring patterns.

MIT ★ 2,966 updated 2026-09-29

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add rohitg00/pro-workflow
/plugin install pro-workflow@pro-workflow
Open on GitHub

What insights does

insights builds a report from project memory and session history. It can show current-session activity, learning categories, frequently or rarely applied entries, correction patterns, and productivity metrics. Session duration and changed-file counts are among the example metrics.

The skill reads .claude/LEARNED.md, .claude/learning-log.md, and CLAUDE.md, and checks Git history and git diff --stat. It treats a correction as a case where the user redirects, fixes, or overrides an agent’s work. The report therefore depends on what the project has recorded in memory and history.

What it helps with

  • check activity in the current session
  • spot categories that prompt repeated agent corrections
  • find saved learnings that are rarely applied
  • compare correction patterns across sessions

Example prompts for the agent

  • Show me the stats for my current session.
  • Build a correction heatmap by category.
  • Which saved learnings have not been applied lately?

How to install insights

1Plugin marketplace

/plugin marketplace add rohitg00/pro-workflow
/plugin install pro-workflow@pro-workflow

This installs the whole pro-workflow plugin with all its skills

2Skills CLI (Vercel)

npx skills add rohitg00/pro-workflow --skill insights -a claude-code

3Manually: put the files in place

~/.claude/skills/insights/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/insights/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about insights

How do I install insights in Claude Code?

Run /plugin marketplace add rohitg00/pro-workflow, then run /plugin install pro-workflow@pro-workflow.

What does insights do?

It analyzes project memory and session history to report on coding activity, saved learnings, agent corrections, and productivity metrics.

What data does insights use?

It reads .claude/LEARNED.md, .claude/learning-log.md, and, when needed, CLAUDE.md; it also checks Git history and change statistics. A correction means the user redirected, fixed, or overrode agent output.

Source text

SKILL.md · MIT
---
name: insights
description: Show session analytics, learning patterns, correction trends, heatmaps, and productivity metrics. Computes stats from project memory and session history. Use when asking for stats, statistics, progress, how am I doing, coding history, or dashboard.
user-invocable: true
---

# Session Insights

Surface patterns from learnings and session history.

## Trigger

Use when asking "show stats", "how am I doing", "analytics", "insights", "heatmap", or "correction rate".

## Data Sources

Gather data from these locations before computing metrics:

```bash
# Session history and learnings
cat .claude/LEARNED.md 2>/dev/null || cat CLAUDE.md | grep -A999 "LEARNED"
cat .claude/learning-log.md 2>/dev/null

# Session activity
git log --oneline --since="today" --author="$(git config user.name)"
git diff --stat
```

A **correction** is any instance where the user redirected, fixed, or overrode agent output during a session. Count `[LEARN]` entries and explicit correction markers in session history.

## What It Shows

### Session Summary

```
Session Insights
  Duration: 47 min
  Edits: 23 files modified
  Corrections: 2 self-corrections applied
  Learnings: 3 new patterns captured
  Context: 62% used (safe)
```

### Learning Analytics

```
Learning Insights (42 total)

Top categories:
  Testing     12 learnings (29%)
  Navigation   8 learnings (19%)
  Git          7 learnings (17%)
  Quality      6 learnings (14%)

Most applied:
  #12 [Testing] Run tests before commit — 15 times
  #8  [Navigation] Confirm path for common names — 11 times

Stale learnings (never applied):
  #15 [Editing] Prefer named exports — 0 times (45 days old)
```

### Correction Heatmap

```
Correction Heatmap

By category (all time):
  ████████████ Testing      34 corrections
  ████████     Navigation   22 corrections
  ██████       Git          18 corrections
  ████         Quality      12 corrections

Hot learnings (most corrected, least learned):
  - [Testing] Mock external deps — corrected 8x, learned 0x
    → Consider: /learn-rule to capture this permanently

Cold learnings (learned but never applied):
  - [Editing] Use named exports — learned 45 days ago, applied 0x
    → Consider removing if no longer relevant
```

### Productivity Metrics

```
Productivity (last 10 sessions)
  Avg session: 35 min
  Avg edits/session: 18
  Correction rate: 12% (improving)
  Learning capture: 2.1 per session
```

## Guardrails

- Use actual data from project memory and session history.
- Surface actionable suggestions, not just numbers.
- Flag recurring corrections that should become permanent rules.
- Identify stale learnings that may no longer be relevant.

## Output

Formatted analytics report with:
- Current session stats
- Category breakdown
- Most/least applied learnings
- Correction trends with suggestions
- Productivity metrics over time

© Rohit Ghumare · MIT · rohitg00/pro-workflow

Similar skills

All skills for Agent setup: memory, context, orchestration →
get-token-insights Samarth Gupta get-token-insights parses Claude Code conversation history, flags token waste, and generates an offline dashboard covering costs, hooks, and agent workflows. CX Codex +1 ★ 276repo stars turning-engineering-analytics-into-insights PostHog turning-engineering-analytics-into-insights — a skill for Claude Code and Codex: converts PR and CI metrics into saved PostHog insights, dashboards, and automated subscriptions. Triggers when visualizing engineering team performance. CX Codex +1 189installs insights-advisor Son Nguyen insights-advisor is a Claude Code subagent that examines Agent Monitor data and connects patterns across sessions. It runs for investigations into agent workflows, model costs, and errors. CX Codex ★ 1,198repo stars ccam-insights Son Nguyen ccam-insights — a Claude Code plugin that detects patterns in agent behavior, alerts on anomalies, and provides optimization recommendations. Uses Agent Monitor analytics to compare sessions and spot deviations. CX Codex ★ 1,198repo stars creator-insights Starchild-ai-agent The creator-insights skill analyzes Twitter/X accounts, spots viral patterns and high-value followers, and drafts tweets. Use it for creator research and niche analysis. CX Codex +1 151installs creating-box-plot-insights PostHog The creating-box-plot-insights Claude Code skill builds box plot insights in PostHog from product analytics or SQL. It runs on requests to chart a numeric distribution, compare medians, or save an insight. CX Codex +1 148installs

From the same set83

The whole set →
parallel-worktrees parallel-worktrees — a skill for Claude Code that creates isolated git worktrees for parallel coding sessions. While tests or builds run in one window, start a new task in another without waiting or switching context. CX Codex +1 ★ 2,966repo stars compact-guard compact-guard is a Claude Code skill that records task state before context compaction and helps restore it afterward. Run it before /compact or when an auto-compaction warning appears. CX Codex +1 ★ 2,966repo stars handoff Generates a structured handoff document for passing work to another Claude session or your future self. Records status, decisions, learnings, and a resume point. CX Codex +1 ★ 2,966repo stars replay replay finds relevant past learnings and mistakes in a local SQLite database before starting a task. Surfaces project context to reduce repeated edits. CX Codex +1 ★ 2,966repo stars domain-modeling domain-modeling builds the project's shared vocabulary and context boundaries before code gets written, so the agent stops paraphrasing domain terms. Leaves a CONTEXT.md glossary behind. CX Codex +1 ★ 2,966repo stars llm-gate llm-gate configures prompt and agent hooks in Claude Code to validate commit messages, stop dangerous terminal commands, and catch secret leaks before execution. CX Codex +1 ★ 2,966repo stars cost-tracker The cost-tracker skill helps you review Claude Code session costs, set budget checkpoints, and spot expensive work patterns. Use it when planning work across sessions. CX Codex +1 ★ 2,966repo stars reviewer reviewer — a subagent that reviews code line by line, reading actual files and citing every finding with exact quotes. Use before committing, during PR review, or after major changes. CX Codex ★ 2,966repo stars

Project sponsors

Companies that keep this analytics open