How do I install the Work Stats skill?

Run npx skillmds@latest add tomevault-io/work-stats in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Work Stats safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Work Stats?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Work Stats free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Work Stats?

tomevault-io (@tomevault-io) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Work Stats by tomevault-io — Agent Skill

Name: Work Stats
Author: tomevault-io

File contents

/work-stats

Show token usage statistics across sessions.

When to Use

Review how many tokens have been used across sessions
Understand usage patterns (which projects consume most)
Manager aggregating stats across all sessions

Arguments

--project <name> - Filter to specific project
--today - Only sessions from today
--week - Only sessions from past 7 days
(no args) - Show all sessions

Implementation

1. Find all usage files

# List all session usage files
ls ~/.varie/sessions/*/usage.json 2>/dev/null

2. Read and aggregate data

For each usage.json file:

cat ~/.varie/sessions/<session_id>/usage.json

Extract and sum:

tokens.total_input
tokens.total_output
tokens.cache_read
tokens.cache_creation

3. Format output

## Token Usage Statistics

> **Note:** Token counts are estimates based on status line data and may not match actual billing.

### Overall
| Metric | Value |
|--------|-------|
| Total Sessions | 12 |
| Input Tokens | 2.5M |
| Output Tokens | 450K |
| Cache Read | 1.8M |
| Cache Creation | 120K |

### By Initial Directory (Top 5)
| Directory | Sessions | Input | Output |
|-----------|----------|-------|--------|
| react | 5 | 1.2M | 200K |
| next.js | 3 | 800K | 150K |
| express | 2 | 300K | 80K |

### Recent Sessions
| Session | Started | Context % | Input | Output |
|---------|---------|-----------|-------|--------|
| abc123 | 2h ago | 42% | 150K | 45K |
| def456 | 5h ago | 78% | 280K | 92K |

Filtering Examples

By Project

/work-stats --project react

Shows only sessions where initial_cwd contains "react".

By Time

/work-stats --today

Filters to sessions where started_at is today.

/work-stats --week

Filters to sessions from the past 7 days.

If No Usage Data

## Token Usage Statistics

No usage data found.

Usage tracking requires the status line to be configured.
See: https://github.com/varie-ai/varie-workstation#status-line-setup

Notes

Usage data is collected by the statusline-context script
Data persists in ~/.varie/sessions/<id>/usage.json
Token counts are estimates and may not match actual billing
Sessions without usage.json are not included in stats

Converted and distributed by TomeVault — claim your Tome and manage your conversions.

---name: work-statsdescription: Show token usage statistics across sessions. Use when you want to understand resource consumption or usage patterns. Use when this capability is needed.---# /work-statsShow token usage statistics across sessions.## When to Use- Review how many tokens have been used across sessions- Understand usage patterns (which projects consume most)- Manager aggregating stats across all sessions## Arguments- `--project <name>` - Filter to specific project- `--today` - Only sessions from today- `--week` - Only sessions from past 7 days- (no args) - Show all sessions## Implementation### 1. Find all usage files```bash# List all session usage filesls ~/.varie/sessions/*/usage.json 2>/dev/null```### 2. Read and aggregate dataFor each usage.json file:```bashcat ~/.varie/sessions/<session_id>/usage.json```Extract and sum:- `tokens.total_input`- `tokens.total_output`- `tokens.cache_read`- `tokens.cache_creation`### 3. Format output```## Token Usage Statistics> **Note:** Token counts are estimates based on status line data and may not match actual billing.### Overall| Metric | Value ||--------|-------|| Total Sessions | 12 || Input Tokens | 2.5M || Output Tokens | 450K || Cache Read | 1.8M || Cache Creation | 120K |### By Initial Directory (Top 5)| Directory | Sessions | Input | Output ||-----------|----------|-------|--------|| react | 5 | 1.2M | 200K || next.js | 3 | 800K | 150K || express | 2 | 300K | 80K |### Recent Sessions| Session | Started | Context % | Input | Output ||---------|---------|-----------|-------|--------|| abc123 | 2h ago | 42% | 150K | 45K || def456 | 5h ago | 78% | 280K | 92K |```## Filtering Examples### By Project```/work-stats --project react```Shows only sessions where `initial_cwd` contains "react".### By Time```/work-stats --today```Filters to sessions where `started_at` is today.```/work-stats --week```Filters to sessions from the past 7 days.## If No Usage Data```## Token Usage StatisticsNo usage data found.Usage tracking requires the status line to be configured.See: https://github.com/varie-ai/varie-workstation#status-line-setup```## Notes- Usage data is collected by the `statusline-context` script- Data persists in `~/.varie/sessions/<id>/usage.json`- **Token counts are estimates and may not match actual billing**- Sessions without usage.json are not included in stats---> Converted and distributed by [TomeVault](https://tomevault.io/claim/varie-ai) — claim your Tome and manage your conversions.

Frequently asked questions

Work Stats