Tldr Stats Skill for Claude

by parcadei

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

753 tokens

context cost

the whole folder, loaded on every use

files

instructions only

copies elsewhere

how many repositories repackaged it

3880

stars on the repo

on the repository, not the skill itself

Install

one command, takes just this skill from the repository

npx skills add https://github.com/parcadei/Continuous-Claude-v3 --skill tldr-stats

The instruction itself

7 sections, as written by the author

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.

Run the stats script:

python3 $CLAUDE_PROJECT_DIR/.claude/scripts/tldr_stats.py

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

Other skills for the same job

different authors, same section of the catalogue

Skill Creator

by anthropics

vendor ×10

Create new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.

Guide for creating effective skills. This skill should be used when users want to create a new skill (or update an existing skill) that extends Claude's capabilities with specialized knowledge, workflows, or tool integrations.

Replace with description of the skill and when Claude should use it.

35 tokens

Dispatching Parallel Agents

by ZhanlinCui

×5

Use when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies

This skill should be used when the user wants to "create a skill", "add a skill to plugin", "write a new skill", "improve skill description", "organize skill content", or needs guidance on skill structure, progressive disclosure, or skill development best practices for Claude Code plugins.

Helps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express interest in extending capabilities. This skill should be used when the user is looking for functionality that might exist as an installable skill.

Use when creating new skills, editing existing skills, or verifying skills work before deployment

26k tokens scripts

How to use it

Copy the folder

Take parcadei/tldr-stats from the repository into ~/.claude/skills for personal use, or into .claude/skills inside a project.

Check the name does not clash

The agent identifies a skill by the name field in its header. Two skills with the same name cannot sit side by side — one of them will be ignored.