---
name: usage
description: Track and report model usage across sessions. Use when asked about usage, stats, or session history.
allowed-tools:
  - Bash
  - Read
---

# Usage Tracking Skill

Query session history and report usage statistics.

## Quick Command

```bash
python3 ~/.claude/skills/usage/scripts/usage_report.py [range]
```

Ranges: `today`, `week` (default), `month`, `all`

## Command Routing

| Command | Action |
|---------|--------|
| `/usage` | Show last 7 days summary |
| `/usage today` | Today's sessions |
| `/usage week` | Last 7 days |
| `/usage month` | Last 30 days |
| `/usage all` | All time stats |

## Data Sources

| Source | Status | Data |
|--------|--------|------|
| `history/index.json` | Available | Session IDs, start times |
| `usage/config.json` | Available | Log level, preferences |

## Output Format

```
📊 Usage Summary — Week

Sessions: 12
Total time: 8h 32m
Days active: 5
Model: opus (primary)

📅 Sessions by Date:
  2026-01-01: 3 sessions (95m)
  2025-12-31: 4 sessions (120m)
  ...
```

## Log Levels

| Level | Data Captured |
|-------|---------------|
| `minimal` | Session ID, time, model |
| `standard` | + agents, skills, tokens (default) |
| `detailed` | + commands, delegations, errors |

## Policy

- Read-only operations
- No external API calls
- Local data only