SkillAgentSearch skills...

tldr-stats

Show full session token usage, costs, TLDR savings, and hook activity

Install / Use

npx skills add parcadei/Continuous-Claude-v3 --skill tldr-stats

Installs into whichever agent you are using.

About this skill
📄

SKILL.md

Installable skill definition

Quality Score

80/100

Supported Platforms

Claude Code

Our assessment of tldr-stats

tldr-stats scores 80/100 on our quality scale, 3619th of 4,698 Development & Engineering skills we index.

Its SKILL.md is 2.6 KB long, split into 7 sections with 2 code examples: a solid amount of guidance for an agent.

With 3,943 GitHub stars, it is one of the more widely adopted skills in the catalogue.

Substance
26/30
Structure
16/20
Description
12/15
Adoption
15/20
Freshness
11/15

Maintenance, license and trust

  • The repository was last updated about 10 months ago. That is recent enough to be usable, but agent tooling moves fast, so check the instructions against your agent's current version.
  • Our last check on 2026-11-08 found the source still online.
  • It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
  • Its trust signals score 94/100, with 1 caution from licensing, adoption, age or documentation. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.

Safety scan

No issues found

Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.

AI review by kimi-k2.7-code on 2026-10-01. Automated pattern scan on 2026-10-01. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.

tldr-stats compared with similar skills

All 4 of these similar skills score higher than tldr-stats; compare them before choosing.

SkillScoreStarsUpdatedFormat
tldr-stats (this skill)by parcadei803.9k10mo agoSKILL.md
taste-skillby Leonxlnx100116.8k8d agoCLAUDE.md
Agent-Reachby Panniantong100112.3k8d agoCLAUDE.md
headroomby headroomlabs-ai10079.8ktodayCLAUDE.md
ai-job-searchby ai-job-search-dev10072.1ktodayCLAUDE.md

Frequently asked questions

How do I install tldr-stats?
Run npx skills add parcadei/Continuous-Claude-v3 --skill tldr-stats. The install tabs above show the steps for each supported agent.
Which AI agents does tldr-stats work with?
It is written for Claude Code, as a SKILL.md file. Other agents that read the same format can often use it too.
Is tldr-stats safe to use?
Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 94/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
Is tldr-stats still maintained?
The repository was last updated about 10 months ago. That is recent enough to be usable, but agent tooling moves fast, so check the instructions against your agent's current version.

name: tldr-stats description: Show full session token usage, costs, TLDR savings, and hook activity

TLDR Stats Skill

Show a beautiful dashboard with token usage, actual API costs, TLDR savings, and hook activity.

When to Use

  • See how much TLDR is saving you in real $ terms
  • Check total session token usage and costs
  • Before/after comparisons of TLDR effectiveness
  • Debug whether TLDR/hooks are being used
  • See which model is being used

Instructions

IMPORTANT: Run the script AND display the output to the user.

  1. Run the stats script:
python3 $CLAUDE_PROJECT_DIR/.claude/scripts/tldr_stats.py
  1. Copy the full output into your response so the user sees the dashboard directly in the chat. Do not just run the command silently - the user wants to see the stats.

Sample Output

╔══════════════════════════════════════════════════════════════╗
║  📊 Session Stats                                            ║
╚══════════════════════════════════════════════════════════════╝

  You've spent  $96.52  this session

  Tokens Used
        1.2M sent to Claude
      416.3K received back
       97.8K from prompt cache (8% reused)

  TLDR Savings

    You sent:               1.2M
    Without TLDR:           2.5M

    💰 TLDR saved you ~$18.83
    (Without TLDR: $115.35 → With TLDR: $96.52)

    File reads: 1.3M → 20.9K █████████░ 98% smaller

  TLDR Cache
    Re-reading the same file? TLDR remembers it.
    █████░░░░░░░░░░ 37% cache hits
    (35 reused / 60 parsed fresh)

  Hooks: 553 calls (✓ all ok)
  History: █▃▄ ▇▃▇▆ avg 84% compression
  Daemon: 24m up │ 3 sessions

Understanding the Numbers

| Metric | What it means | |--------|---------------| | You've spent | Actual $ spent on Claude API this session | | You sent / Without TLDR | Actual tokens vs what it would have been | | TLDR saved you | Money saved by compressing file reads | | File reads X → Y | Raw file tokens compressed to TLDR summary | | Cache hits | How often TLDR reuses parsed file results | | History sparkline | Compression % over recent sessions (█ = high) |

Visual Elements

  • Progress bars show savings and cache efficiency at a glance
  • Sparklines show historical trends (█ = high savings, ▁ = low)
  • Colors indicate status (green = good, yellow = moderate, red = concern)
  • Emojis distinguish model types (🎭 Opus, 🎵 Sonnet, 🍃 Haiku)

Notes

  • Token savings vary by file size (big files = more savings)
  • Cache hit rate starts low, increases as you re-read files
  • Cost estimates use: Opus $15/1M, Sonnet $3/1M, Haiku $0.25/1M
  • Stats update in real-time as you work

Related Skills

View on GitHub
GitHub Stars3.9k
CategoryDevelopment
Updated9mo ago
Forks303

Languages

Python

Trust signals

94/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

1 low