Back to skills
extension
Category: Development & EngineeringNo API key required

stats-tracker

Track and analyze Claude Code usage statistics for CircleTel development. Use to monitor productivity, track model usage, view usage streaks, and optimize development workflow based on patterns.

personAuthor: jakexiaohubgithub

Stats Tracker

Skill for tracking and analyzing Claude Code usage statistics.

When to Use

This skill activates when you:

  • Want to see your usage statistics
  • Track productivity over time
  • Analyze model usage patterns
  • Monitor usage streaks
  • Plan based on usage limits

Keywords: stats, usage, analytics, productivity, streak, model usage, tokens, sessions, cost

Quick Commands

| Command | Description | |---------|-------------| | /stats | View usage stats, streak, favorite model | | /usage | View token usage and limits | | /context | View current context usage | | /cost | View session cost breakdown |

Understanding /stats Output

/stats

📊 Your Claude Code Stats
────────────────────────────
🏆 Favorite Model: Sonnet 4 (78% of sessions)
🔥 Current Streak: 12 days
📈 This Week: 847K tokens across 23 sessions
📉 Usage Graph: [▁▃▅▇█▆▄▂] (last 7 days)

Metrics Explained

| Metric | Description | |--------|-------------| | Favorite Model | Most frequently used model | | Current Streak | Consecutive days using Claude Code | | This Week | Total tokens and sessions | | Usage Graph | Visual of daily usage pattern |

Understanding /usage Output

/usage

📊 Usage This Period
────────────────────────────
Sonnet: ████████░░ 78%
Opus:   ██░░░░░░░░ 15%
Haiku:  █░░░░░░░░░ 7%

Resets: Monday 00:00 UTC

Model Selection Guide

Choose the right model for the task:

| Task Type | Model | Why | |-----------|-------|-----| | General coding | Sonnet | Best balance of speed/quality | | Complex architecture | Opus | Deep reasoning, long context | | Quick fixes | Haiku | Fast, efficient | | Code exploration | Haiku (Explore) | Optimized for search | | Documentation | Sonnet | Good writing quality | | Bug investigation | Sonnet/Opus | Depends on complexity |

Cost Efficiency

| Model | Relative Cost | Best For | |-------|---------------|----------| | Haiku | $ | Quick tasks, exploration | | Sonnet | $$ | Most development work | | Opus | $$$ | Complex problems |

Daily Workflow with Stats

Morning Routine

1. /stats                 # Check streak, plan day
2. /usage                 # Check remaining budget
3. /rename feature-x      # Name today's session
4. Start coding           # Use appropriate model

During Development

# After complex task
/context                  # Check context usage

# When switching tasks
/stats                    # Quick progress check

End of Day

/stats                    # Review productivity
/usage                    # Check usage remaining
/cost                     # See session cost

Usage Optimization Strategies

If Usage is High

  1. Use Haiku more - For exploration and quick tasks
  2. Spawn Explore agents - Uses efficient Haiku model
  3. Background tasks - Don't consume extra tokens
  4. Be more targeted - Specific queries use less context

If Starting Fresh Week

  1. Plan major tasks - Allocate Opus for complex work
  2. Default to Sonnet - Best general-purpose model
  3. Reserve Haiku - For quick lookups and exploration

Maximizing Efficiency

# Good: Specific query
"Fix the null check on line 45 of auth.ts"

# Bad: Vague query (uses more context/tokens)
"Help me with the auth system"

Tracking by Feature

Use named sessions to track usage per feature:

# Start feature work
/rename billing-feature

# Work on feature...

# Check stats
/stats  # See usage for this session

# Compare features
"How many tokens did billing vs auth use?"

Weekly Review Pattern

Every Friday:

1. /stats              # Review week's usage
2. /usage              # Check budget status
3. Note completions    # What features finished?
4. Plan next week      # Allocate model usage

Weekly Goals Template

Week Goals:
- [ ] Maintain 5-day streak
- [ ] Complete 3 features
- [ ] Use Opus only for architecture decisions
- [ ] Try Explore agent for research tasks
- [ ] Stay under 80% usage

Integration with Other Skills

With Session Manager

# Track stats per named session
/rename billing-feature
[work on feature]
/stats
# See usage specific to this session

With Context Manager

# Monitor both context and usage
/context  # Current context budget
/stats    # Overall usage patterns

With Async Runner

# Background tasks don't inflate usage
"Run build in background"
# Build output doesn't use tokens

Gamification Ideas

Streak Challenges

  • 5-day streak: Bronze
  • 10-day streak: Silver
  • 30-day streak: Gold
  • Try to never break your streak!

Model Efficiency Challenge

Challenge: Complete task with Haiku
1. Try Haiku first for any task
2. Escalate to Sonnet only if needed
3. Use Opus sparingly for max impact

Weekly Competition (Team)

  • Compare completed features
  • Compare usage efficiency
  • Share tips for optimization

External Tools

ccusage (CLI Analytics)

# Install
npm install -g ccusage

# View usage
ccusage

# Daily breakdown
ccusage --daily

# Monthly view
ccusage --monthly

Claude Code Usage Monitor

Real-time terminal monitoring with:

  • Token tracking
  • Burn rate analysis
  • Predictions for limits

CircleTel Productivity Patterns

Feature Development Session

Start: /rename feature-customer-billing
       /stats  # Baseline

Middle: [coding work]
        /context  # Check context

End: /stats  # Compare to baseline
     /cost   # Session cost

Bug Fix Session

/rename BUG-1234-fix
/stats  # Note starting point

[investigation and fix]

/stats  # See investigation cost
# Typically: Sonnet for analysis, quick fixes

Architecture Planning

/rename architecture-review

# Use Opus for deep thinking
"Think about the best approach for..."

/stats  # Higher usage expected
/cost   # Worth it for good architecture

Best Practices

  1. Check stats daily - Start with /stats
  2. Match model to task - Don't use Opus for simple fixes
  3. Track by feature - Use named sessions
  4. Review weekly - Adjust workflow based on patterns
  5. Use Haiku for exploration - Spawn Explore agents
  6. Background for builds - Don't waste tokens on output
  7. Targeted queries - Specific questions = efficient usage

Troubleshooting

Stats seem wrong

# Check current session specifically
/cost

# Check usage for period
/usage

High usage unexpectedly

  • Check for large file reads
  • Review if background tasks are actually background
  • Consider if queries could be more specific

Streak reset

  • Streak requires at least one interaction per day
  • Even /stats counts
  • Check timezone (UTC-based)

Version: 1.0.0 Last Updated: 2025-12-10 For: Claude Code v2.0.64+