tldr-stats

tldr-stats is a skill for Claude Code from parcadei/Continuous-Claude-v3. It costs 20 tokens per session (733 once invoked), scanned A, original, MIT.

A session report that shows token usage, estimated costs, context savings from TLDR tools, and hook activity. Tokens are the text units used to measure model input and output.

In plain words
What is it for?
Use it to inspect model usage, compare context savings, review costs, and check which automated hooks ran.
Why use it?
It helps you see how much a session costs and whether the project's context-reduction tools are working.

Skill for Claude Code

Written for Claude Code: $CLAUDE_PROJECT_DIR variable. Also seen: positional $N argument.

not rated 3.9krepo +2 7mo ago A scan Socket: passSnyk: failSkillSpector: pass 20 tokens original MIT

Good fit Use it to inspect model usage, compare context savings, review costs, and check which automated hooks ran.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/parcadei/continuous-claude-v3/tldr-stats
About the project

Continuous-Claude-v3 is a Claude Code development environment that preserves working context between sessions, coordinates specialized agents, and stores project knowledge through ledgers, handoffs, and analysis tools. It is for people using Claude Code on ongoing or complex software work. Its catalogue entries are the skills, agents, hooks, plugin, and setting that provide its workflows and orchestration.

parcadei/Continuous-Claude-v3 · 3,938 stars · on GitHub

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add parcadei/Continuous-Claude-v3 --skill tldr-stats
Clone the repo
git clone --depth 1 https://github.com/parcadei/Continuous-Claude-v3

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for tldr-stats

README.md
[![agentmods](https://agentmods.dev/badge/skills/parcadei/continuous-claude-v3/tldr-stats/github.svg)](https://agentmods.dev/skills/parcadei/continuous-claude-v3/tldr-stats)
Your own site
<a href="https://agentmods.dev/skills/parcadei/continuous-claude-v3/tldr-stats"><img src="https://agentmods.dev/badge/skills/parcadei/continuous-claude-v3/tldr-stats/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for tldr-stats

Your own site · 80×15
<a href="https://agentmods.dev/skills/parcadei/continuous-claude-v3/tldr-stats"><img src="https://agentmods.dev/badge/skills/parcadei/continuous-claude-v3/tldr-stats.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 20 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 733 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe. Third-party audits
  • Socket pass 18 Mar 2026
  • Snyk fail 15 Feb 2026
  • NVIDIA SkillSpector pass 7 Sept 2026
How audits are shown
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00020 $0.00733
Opus 5 $0.00010 $0.00367
Sonnet 5 $0.00004 $0.00147
Haiku 4.5 $0.00002 $0.00073

Measured 9d ago against content hash 1ac7b92154d5, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-12, from the pricing page.

Security

Grade A, and why

tldr-stats scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 9d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.claude/skills/tldr-stats/SKILL.md · 86 lines

How it starts

The opening of the file, as written. The whole thing — 86 lines — stays where its author put it; the contents beside it link to each section on GitHub.

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)

Read the full file on GitHub · 86 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 9d ago First seen · 86 lines · 20 tokens per session scan A 1ac7b92154d5

Subscribe to this mod's changes

tldr-stats is a skill published in the GitHub repository parcadei/Continuous-Claude-v3 (3,938 stars, last pushed 7mo ago), licensed MIT. It adds 20 tokens to every session and 733 once invoked, about $0.0001 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-03.

Related

Other skills, from other repositories

nil

The inverse of /sfl. Where sfl saved each window for later, /nil says later is now: it reopens them. You choose which to bring back.

wasulajr/headsup · 153 tokens

headsup-config

Unified settings hub for headsup (Claude Code's iTerm2 status hooks). One command with a section as the first word, then that section's args. Sections: newtabs (New Claude Tab / Cmd-Opt-C launch mode), colors (idle/processing/waiting tab colors), label (this tab's title + badge), notify (the 'Claude is waiting' macOS…

wasulajr/headsup · 153 tokens

sfl

Save For Later: checkpoint this window so a fresh session (or /nil) can resume it later. Use when the user types /sfl, "save for later", or "checkpoint this window". Writes a live per-window entry under /.claude/sfl/ (plus an optional durable note in the user's own memory system), then shows the green Saved-for-Later…

wasulajr/headsup · 121 tokens

headsup-colors

Customize headsup's global iTerm2 tab colors for Codex sessions: idle, working, and waiting. Use when the user asks to change Codex/headsup tab colors.

wasulajr/headsup · 41 tokens

headsup-notifications

Manage macOS notifications for Codex tabs that have been waiting longer than a configured threshold.

wasulajr/headsup · 23 tokens

fizzy-workflow

Use for guided Fizzy.do workflows: "set up Fizzy", "configure Fizzy for this project", "sync my work to Fizzy", "review my Fizzy progress", "end of session cleanup". Provides step-by-step guidance for common operations.

keskinonur/claude-plugin-fizzy · 57 tokens