insights-archive

SKILL.md

Insights Archive

Archive and manage Claude Code /insights reports to track how your usage patterns evolve over time.

Usage

/insights-archive archive      # Save current report with timestamp
/insights-archive list         # See all archived reports
/insights-archive open         # Open current report in browser
/insights-archive open <date>  # Open archived report by date
/insights-archive diff <d1> <d2>  # Compare two archived reports
/insights-archive              # Show help

Commands

archive

Saves the current /insights report with a timestamp.

/insights-archive archive

Output:

Archived to: ~/.claude/usage-data/archives/report-2026-02-04-1335.html

Note: Run /insights first to generate a fresh report before archiving.

list

Shows all archived reports with their dates.

/insights-archive list

Output:

Archived insights reports:

  2026-02-01-1422
  2026-02-04-1335

Use '/insights-archive open <date>' to view one.

open

Opens the current report or an archived report by date.

/insights-archive open           # Opens current report
/insights-archive open current   # Same as above
/insights-archive open 2026-02-04  # Opens archived report matching date

diff

Opens two archived reports side-by-side for manual comparison.

/insights-archive diff 2026-02-01 2026-02-04

Both reports open in browser tabs for comparison.


Why Archive?

Tracking how your Claude Code usage patterns evolve over time is valuable:

  • See workflow improvements — Are git operations decreasing as you add custom skills?
  • Track friction resolution — Did the suggestions from last month's report get addressed?
  • Measure learning — How are your interaction patterns maturing?

This aligns with the "knowledge compounds" thesis — your usage data is another form of knowledge that benefits from historical context.


Prerequisites

Requires the insights-archive shell script in your PATH.

Setup (if not already installed):

# Clone dotfiles or copy the script
curl -o ~/.local/bin/insights-archive \
  https://raw.githubusercontent.com/jonathanprozzi/dotfiles/main/bin/insights-archive
chmod +x ~/.local/bin/insights-archive

Or if using jonathanprozzi/dotfiles, the script is at bin/insights-archive.


Implementation

Execute the command using the shell script:

insights-archive <command> [args]

Parse the user's arguments and pass them through. Report the output back to the user.

Commands map directly:

  • /insights-archive archiveinsights-archive archive
  • /insights-archive listinsights-archive list
  • /insights-archive open <date>insights-archive open <date>
  • /insights-archive diff <d1> <d2>insights-archive diff <d1> <d2>

If no arguments provided, show the help output from the script.

Weekly Installs
3
First Seen
Feb 5, 2026
Installed on
opencode3
gemini-cli3
github-copilot3
codex3
kimi-cli3
amp3