cache

Analyzes Claude token spend by cache tier and derives effective-versus-list cost from metered ledger data.

1|Updated Aug 17, 2026
One-click install
npx skills add https://github.com/Jakeintech/waybill --skill cache-jakeintech
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: cache
Source: https://github.com/Jakeintech/waybill/tree/main/skills/cache
Command: npx skills add https://github.com/Jakeintech/waybill --skill cache-jakeintech

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Claude Code bills are hard to interpret because cache reads are billed at a tenth of the input rate and usually dominate token volume, making raw token totals misleading. This Skill answers "why is my bill like this" with deterministic numbers from the metered waybill ledger instead of estimates. ## Core Features & Use Cases - Cache tier breakdown: Reports token volume by class — input, output, cache reads, and cache writes split by 5-minute and 1-hour premiums — plus the cache-read share of total volume. - Derived cost view: Computes effective cost, list-price equivalent, net caching savings, and coverage percentage from the current rate table, always labeled as derived rather than invoiced. - Per-model attribution: Breaks down volume and effective cost per model so you can see which model drives the bill. - Use Case: A budget owner sees an alarming token count and asks what caching actually saved; the Skill returns the net savings figure with its derived-basis label and the honesty floor of unattributed percentage. ## Quick Start Ask "why is my Claude bill like this" or "how much of my spend is cache reads" to get a receipt-backed breakdown of your token spend by cache tier.

Frequently Asked Questions about cache

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I find out why my Claude Code bill is so high?▼

Run the cache query against your metered waybill ledger to see token volume by tier. Cache reads are billed at a tenth of the input rate and usually dominate volume, so the effective cost is typically far lower than raw token totals suggest.

How much of my Claude token spend is cache reads?▼

The cache_read_pct field reports cache reads as a share of total token volume, computed deterministically from metered transcripts. Cache writes are shown separately with their 5-minute (1.25x) and 1-hour (2x) premium split.

What did prompt caching actually save me on my bill?▼

The saved_usd figure is the net saving after write premiums, derived by comparing effective cost against the list-price equivalent with no caching. It is labeled as a derived list-price equivalent, not a stored fact or a promise about the actual invoice.

Why does the cost report show partial coverage for some models?▼

When covered_pct is below 100, some models have no resolved rate in the current rate table, so their effective cost is null rather than zero. Run waybill status to list the unpriced models and their fixes before treating the dollar figure as complete.

Which model is driving my Claude API costs?▼

The by_model breakdown sorts token volume per model and attaches a derived effective_usd to each. Comparing per-model effective cost against volume shows which model contributes most to the bill.