session-trends
Analyze trends across session metrics. Computes windowed aggregates, deltas, and compares against MEMORY.md findings. Use periodically for progress tracking.
npx skills add oliver-kriska/claude-elixir-phoenix --skill session-trends --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# Session Trends Analyze trends from the metrics ledger. Computes windowed aggregates, fingerprint distributions, and compares against MEMORY.md baselines. ## Requirements Requires `.claude/session-metrics/metrics.jsonl` from `/session-scan`. ## Usage ``` /session-trends # All windows (7d, 30d, all) /session-trends --window 30d # Specific window only /session-trends --project enaia # Filter by project /session-trends --compare MEMORY.md # Compare against memory baseline /session-trends --html out.html # Write HTML report with ASCII bars ``` For pure context-window stats (max prompt tokens, ctx %, compaction rate) across raw Claude Code JSONL files, see the `--scan-jsonl` mode of `compute-metrics.py` (inspired by badlogic / earendil-works/pi). ## Pipeline ### Step 1: Parse Arguments Extract from `$ARGUMENTS`: - **`--window WINDOW`**: Time window — `7d`, `30d`, or `all` (default: show all three) - **`--project NAME`**: Filter metrics by project name - **`--compare PATH`**: Path to MEMORY.md for baseline comparison (default: auto-detect from `.claude/` project memory) ### Step 2: Read Metrics Ledger Read `.claude/session-metrics/metrics.jsonl`. If empty or missing: > No metrics found.
- Requirements
- Usage
- Pipeline
- Step 1: Parse Arguments
- Step 2: Read Metrics Ledger
- Step 3: Compute Trends via Python
- Step 4: Display Trend Report
- Step 5: Write trends.json
- Step 6: Suggest Actions
- Output Files
- Common Queries
- Iron Laws
- Acknowledgements
python3 .claude/skills/session-scan/references/compute-metrics.py \
What does the session-trends skill do?
Analyze trends across session metrics. Computes windowed aggregates, deltas, and compares against MEMORY.md findings. Use periodically for progress tracking.
How do I install it?
Run `npx skills add oliver-kriska/claude-elixir-phoenix --skill session-trends --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From oliver-kriska/claude-elixir-phoenix, a repository with 515 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.