claude-code-token-cost SKILL.md skillA
claude-code-token-cost from shangliy/kvleak is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add shangliy/kvleak/claude-code-token-cost@git:20261021.7d11453Pins git:20261021.7d11453 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- shangliy/kvleak
- Path
skills/claude-code-token-cost/SKILL.md- Versions recorded
- 1
- Latest version
- git:20261021.7d11453, committed Oct 21, 2026
- Size
- 4,206 bytes
- Repository stars
- 3
- License
- MIT
Cut Claude Code token cost and prompt-cache waste. Use when the user asks why Claude Code (or Codex CLI, Gemini CLI, OpenCode) burns so many tokens, how much their sessions cost, whether the prompt cache is working, whether to /compact, or how to reduce the bill. Runs the local kvleak audit (no API key, no network) and turns its numbers into the one or two settings that actually move the bill.
Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.
What the file says
# Claude Code token cost (kvleak) kvleak reads the session files Claude Code, Codex CLI, Gemini CLI and OpenCode already keep on disk and prices every model call at list price: uncached input, cache writes, cache reads, output. It then shows how much of the input spend went to cache rebuilds that could have been avoided, and which setting fixes most of it. Zero dependencies, MIT, no network calls. ## Run the audit first, never guess ```bash uvx kvleak # or: pipx run kvleak · pip install kvleak && kvleak kvleak --since 7d # recent window kvleak --json # machine-readable, for your own summary ``` Read these lines of the report and quote them back to the user with their own numbers: - `Cache hit rate`: usually 90%+ and **not** the problem. Say so explicitly; users expect it to be. - `Leaked to misses`: the dollars (or rate-limit headroom on a subscription) that went to cache rebuilds and cold starts. This is the figure to lead with. - `Where the leak comes from`: the top cause. Three usual answers: - *Idle gap outlived the cache TTL*: pauses longer than the 5-minute (or 1-hour) cache. …
Read the whole file at its exact version.
How to install
mdr add shangliy/kvleak/claude-code-token-cost@sha256:786153224a649660The line at the top of this page pins the label git:20261021.7d11453, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.
[](https://markdownregistry.com/a/art_2s4t3jx4wu3o2ot4)
1 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 1 version of this file, committed on Oct 21, 2026.
Audit of the latest version
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (4206 bytes)
- pass: No zero-width or bidi control characters
- pass: No instruction hidden inside an HTML comment
- pass: No link to an exfiltration or paste host
- pass: No credential-shaped string
- pass: No instruction to send local credentials anywhere
- pass: No text hidden with inline styles
- pass: No prompt-injection phrasing
- pass: No curl or wget piped into a shell
- pass: No recursive delete of root, home or parent
- pass: No instruction to read or print local credentials
- pass: No base64 blob over 200 characters
- pass: No link to a raw IP address
- pass: No script tag
Source
shangliy/kvleak · 3 stars · license MIT · pushed 2026-10-23 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_2s4t3jx4wu3o2ot4 GET https://markdownregistry.com/api/v1/resolve?ref=shangliy/kvleak/claude-code-token-cost GET https://markdownregistry.com/api/v1/blob/786153224a6496602a337717d8e052085907699450114dc6118e3e04c834d88a
Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.