Files
claude-code/skills/usage/SKILL.md
OpenCode Test d9be8145f8 Refactor remaining skills with resources pattern and allowed-tools
- k8s-quick-status: Add scripts/quick-status.sh, allowed-tools
- sysadmin-health: Add scripts/health-check.sh, allowed-tools
- usage: Add scripts/usage_report.py, simplify SKILL.md
- programmer-add-project: Add allowed-tools

All skills now:
- Have executable scripts for main operations
- Use allowed-tools to restrict capabilities
- Have improved descriptions with trigger phrases
- Follow the "Skill with Bundled Resources" pattern

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-01 02:38:58 -08:00

67 lines
1.3 KiB
Markdown

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