AgentSkillsCN

insights-archive

归档 Claude Code /insights 报告，以实现历史追踪。支持报告的归档、列表、比较与打开。

SKILL.md
--- frontmatter
name: insights-archive
description: Archive Claude Code /insights reports for historical tracking. Supports archiving, listing, comparing, and opening reports.
license: MIT
metadata:
  author: jonathanprozzi
  version: "1.0.0"
argument-hint: "[archive|list|open|diff] [args...]"
allowed-tools: "Bash, Read"

Insights Archive

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

Usage

code
/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.

code
/insights-archive archive

Output:

code
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.

code
/insights-archive list

Output:

code
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.

code
/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.

code
/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):

bash
# 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:

bash
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 archive → insights-archive archive
  • •/insights-archive list → insights-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.