# Weekly Report

Compile a weekly productivity report using Agent Monitor data, daily_sessions and...

- Repository: https://github.com/hoangsonww/Claude-Code-Agent-Monitor (1136 stars)
- Category: AI and agents
- License: MIT
- Last updated: 2026-10-31
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill weekly-report -g -a claude-code -y`
Codex: `npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill weekly-report -g -a codex -y`
Cursor: `npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill weekly-report -g -a cursor -y`
Gemini CLI: `npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill weekly-report -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add hoangsonww/Claude-Code-Agent-Monitor`

## Description

Compile a weekly productivity report using Agent Monitor data, daily_sessions and daily_events trends, per-session costs from pricing engine, token volumes (input/output/cache_read/cache_write + baselines), tool usage top 20, session completion rates by status, and workflow intelligence metrics.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Weekly Report

Generate a comprehensive weekly productivity report from Agent Monitor data.

## Input

The user provides: **$ARGUMENTS**

This may be:
- "this week" or empty (default: current week Mon-Sun)
- "last week" for the previous week
- A date range: "2025-04-07 to 2025-04-13"

## Procedure

1. **Fetch weekly data** from `http://localhost:4820`:
   - `GET /api/sessions?limit=200`, filter to target week (default sort: most recently updated first)
   - `GET /api/analytics`, aggregated analytics
   - `GET /api/pricing/cost`, cost data

2. **Build the weekly report**:

   ### 📊 Week at a Glance
   | Metric | This Week | Last Week | Change |
   |--------|-----------|-----------|--------|
   | Sessions | N | N | ↑/↓ N% |
   | Total Hours | N | N | ↑/↓ N% |
   | Tokens Used | N | N | ↑/↓ N% |
   | Total Cost | $X.XX | $X.XX | ↑/↓ N% |
   | Completion Rate | N% | N% | ↑/↓ |

   ### 🏆 Highlights
   - Most productive day (by sessions completed)
   - Longest session and what it accomplished
   - Most used tools and any new tools adopted
   - Notable achievements (complex tasks completed, errors resolved)

   ### 📈 Daily Breakdown
   | Day | Sessions | Hours | Cost | Completion |
   |-----|----------|-------|------|------------|
   For each day of the week with activity.

   ### 🔧 Tool Usage Report
   - Top 10 tools by invocation count
   - Tools with highest error rate
   - Tool usage distribution chart (text-based)

   ### 💡 Productivity Insights
   - Peak productivity hours
   - Average session duration and trend
   - Cost efficiency trend
   - Model usage distribution

   ### 🎯 Recommendations for Next Week
   - Based on error patterns: what to improve
   - Based on cost trends: optimization opportunities
   - Based on tool usage: workflow suggestions

## Output Format

The rest: https://github.com/hoangsonww/Claude-Code-Agent-Monitor/blob/HEAD/plugins/ccam-productivity/skills/weekly-report/SKILL.md
