Agent skill

Tldr Stats

by parcadei in parcadei/Continuous-Claude-v3

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

MITAuto-check passedWriting & Content

Install Tldr Stats

skills CLI
$ npx skills add parcadei/Continuous-Claude-v3 --skill tldr-stats -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install parcadei/Continuous-Claude-v3 tldr-stats --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/parcadei/Continuous-Claude-v3.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/tldr-stats .claude/skills/tldr-stats && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
tldr-stats
GitHub stars
3.9k
Used in
1 other repo
Token cost
~667 tokens
SKILL.md length
242 words
Files
1
Skills in repo
141
Repo updated
First seen
Licence
MIT

At a glance

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

  • Works in 2 steps: Run the stats script → Copy the full output into your response…
  • Tasks that involve Summarization
  • SKILL.md covers When to Use, Instructions, Understanding the Numbers and Visual Elements, plus 1 more section
  • Calls python3

What it does

Tldr Stats is an agent skill from parcadei/Continuous-Claude-v3. Show full session token usage, costs, TLDR savings, and hook activity

Its SKILL.md is about 670 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Writing & Content, covering Summarization. The repository describes itself as: Context management for Claude Code. Hooks maintain state via ledgers and handoffs. MCP execution without context pollution. Agent orchestration with isolated context windows. The licence is MIT.

When your agent uses it

  • Tasks that involve Summarization

Example prompts

  • “/tldr-stats”

Requirements

  • Python 3

Workflow steps

2 steps, taken from the first numbered list in SKILL.md.

  1. Run the stats script
  2. 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…

What it can do on your machine

Read from SKILL.md and the folder at commit d07ff4b. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • python3

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Tldr Stats loads about 667 tokens when it runs. Until then it costs about 20 tokens; SKILL.md has 242 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~20
When it runs · the whole SKILL.md, loaded when a task matches
~667

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from parcadei/Continuous-Claude-v3 at commit d07ff4b, republished under its MIT licence (© parcadei). 242 words, ~667 tokens.

Download SKILL.mdSave it as .claude/skills/tldr-stats/SKILL.md (or your agent's skills folder).
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:
bash
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

MetricWhat it means
You've spentActual $ spent on Claude API this session
You sent / Without TLDRActual tokens vs what it would have been
TLDR saved youMoney saved by compressing file reads
File reads X → YRaw file tokens compressed to TLDR summary
Cache hitsHow often TLDR reuses parsed file results
History sparklineCompression % 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

© parcadei, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .claude/skills/tldr-stats of parcadei/Continuous-Claude-v3.

Open the folder on GitHubat commit d07ff4b

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in parcadei/Continuous-Claude-v3, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Tldr Stats next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Tldr Stats compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Tldr Stats this skillparcadei/Continuous-Claude-v33.9k1 repos~667Automated safety check: PassMIT
News Aggregator Skillcclank/news-aggregator-skill1.3k—~2.1kAutomated safety check: PassNone
AI Daily Newsgeekjourneyx/ai-daily-skill235—~2.3kAutomated safety check: PassNone
Vss Search ArchiveNVIDIA-AI-Blueprints/video-search-and-summarization1.9k—~3.3kAutomated safety check: PassApache-2.0
AnalyzeriBigQiang/feedgrab614—~1kAutomated safety check: PassMIT
Reportmicrosoft/data-formulator18k—~1.5kAutomated safety check: PassMIT

Similar skills

  • News Aggregator Skill

    cclank/news-aggregator-skill

    Comprehensive news aggregator that fetches, filters, and deeply analyzes real-time content from 44+ sources including Hacker News, Lobsters, Dev.to, GitHub, arXiv, Hugging Face Papers, AIHOT, TLDR…

    1.3k GitHub stars~2.1k tokensUpdated 4 mo ago
    Writing & ContentAuto-check passed
  • AI Daily News

    geekjourneyx/ai-daily-skill

    Fetches AI news from smol.ai RSS and generates structured markdown with intelligent summarization and categorization.

    235 GitHub stars~2.3k tokensUpdated today
    Writing & ContentAuto-check passed
  • Vss Search Archive

    NVIDIA-AI-Blueprints/video-search-and-summarization

    A skill your agent uses when a user wants to search archived VSS video that is already registered in a configured deployment — by natural-language, similarity, attribute, object-ID, or lexical tag…

    1.9k GitHub stars~3.3k tokensUpdated today
    Writing & ContentAuto-check passed
  • Analyzer

    iBigQiang/feedgrab

    Content Analyzer — any content (URL, text, transcript) into structured analysis report with actionable insights.

    614 GitHub stars~1k tokensUpdated 1 mo ago
    Writing & ContentAuto-check passed
  • Report

    microsoft/data-formulator

    Official

    Turn an exploration (threads, findings, charts) into a single Markdown report — note, blog post, executive summary, KPI dashboard, slide brief, or multi-section analytical report, with embedded…

    18k GitHub stars~1.5k tokensUpdated 2 days ago
    Writing & ContentAuto-check passed
  • Tldr

    earlyaidopters/claudeclaw

    Summarize the current conversation into a TLDR note and save it to your notes folder.

    173 GitHub stars~953 tokensUpdated 5 mo ago
    Writing & ContentAuto-check passed

More from parcadei/Continuous-Claude-v3

All 141 skills in this repo
  • Compound Learnings

    parcadei/Continuous-Claude-v3

    Transform session learnings into permanent capabilities (skills, rules, agents).

    3.9k GitHub starsUsed in 1 repo~1.6k tokens
    Auto-check: notes
  • Debug Hooks

    parcadei/Continuous-Claude-v3

    Systematic hook debugging workflow. An agent skill from parcadei/Continuous-Claude-v3.

    3.9k GitHub starsUsed in 1 repo~863 tokens
    Auto-check: notes
  • Tldr Deep

    parcadei/Continuous-Claude-v3

    Full 5-layer analysis of a specific function. An agent skill from parcadei/Continuous-Claude-v3.

    3.9k GitHub starsUsed in 1 repo~677 tokens
    Auto-check passed
  • Gradient Methods

    parcadei/Continuous-Claude-v3

    Problem-solving strategies for gradient methods in optimization

    3.9k GitHub starsUsed in 2 repos~1k tokens
    Auto-check: notes
  • Math

    parcadei/Continuous-Claude-v3

    Unified math capabilities - computation, solving, and explanation.

    3.9k GitHub starsUsed in 2 repos~1.6k tokens
    Auto-check: notes
  • Math Model Selector

    parcadei/Continuous-Claude-v3

    Routes problems to appropriate mathematical frameworks using expert heuristics

    3.9k GitHub starsUsed in 2 repos~841 tokens
    Auto-check passed

Questions about Tldr Stats

What does Tldr Stats do?

Show full session token usage, costs, TLDR savings, and hook activity. Tldr Stats is an agent skill from parcadei/Continuous-Claude-v3.

When should I use Tldr Stats?

Tldr Stats fits situations like: tasks that involve Summarization.

How do I install Tldr Stats in Claude Code?

Run `npx skills add parcadei/Continuous-Claude-v3 --skill tldr-stats -a claude-code`. Or copy the skill folder (.claude/skills/tldr-stats in parcadei/Continuous-Claude-v3) into .claude/skills/tldr-stats in your project. Claude Code loads it when a task matches its description.

How do I install Tldr Stats in Codex?

Run `npx skills add parcadei/Continuous-Claude-v3 --skill tldr-stats -a codex`. Or copy the skill folder (.claude/skills/tldr-stats in parcadei/Continuous-Claude-v3) into .agents/skills/tldr-stats in your project. Codex loads it when a task matches its description.

Can I use Tldr Stats in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add parcadei/Continuous-Claude-v3 --skill tldr-stats -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/tldr-stats, .gemini/skills/tldr-stats, .github/skills/tldr-stats and .opencode/skills/tldr-stats in your project.

What does Tldr Stats need to run?

Going by SKILL.md and its folder, Tldr Stats needs the command-line tools its instructions call (python3). Our summary lists: Python 3.

Does Tldr Stats access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Tldr Stats safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Tldr Stats use?

Tldr Stats is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Tldr Stats use?

About 667 tokens (SKILL.md is roughly 2.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Tldr Stats?

Skills that share tags, products or a category with Tldr Stats: News Aggregator Skill (cclank/news-aggregator-skill, 1.3k stars), AI Daily News (geekjourneyx/ai-daily-skill, 235 stars), Vss Search Archive (NVIDIA-AI-Blueprints/video-search-and-summarization, 1.9k stars) and Analyzer (iBigQiang/feedgrab, 614 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Tldr Stats?

parcadei (a GitHub user) maintains it in parcadei/Continuous-Claude-v3, which has 3,943 GitHub stars. The repository holds 141 skills in this directory. The repository was last updated on January 26, 2026.

Source: parcadei/Continuous-Claude-v3 on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.