cost-reflect

Solid

The 'why is my bill high' skill: audits where spend goes across token categories (cache_read, cache_write, output, input) and per-session attribution. Invoke for questions like 'cost breakdown', 'which sessions are expensive', 'what's driving spend', or 'cold start costs'. Not for week-over-week trend lines (use hermit-evolution) or simple total-spend summaries.

AI & Automation 74 stars 15 forks Updated today MIT

Install

View on GitHub

Quality Score: 82/100

Stars 20%
62
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# Cost Reflect Runs a structural cost audit over the last 7 days of `cost-log.jsonl` and delivers the result to the operator. The math is done by a script — your job is to run it and deliver the output through the right channel. ## Invocation mode - **Manual (no arguments):** reply only to the invoking terminal or channel conversation. - **Automated (`--maintainer`, or any routine/proactive invocation):** produce the full technical report and send it as a maintainer-tier notice. ## Step 1 — Run the analyzer On a channel-tagged turn without `--maintainer` (the inbound prompt contains a `<channel source="...">` tag), run the plain-language mode instead of the full breakdown — a channel operator asking "why is my bill high" shouldn't get raw token-category jargon: ``` bun ${CLAUDE_PLUGIN_ROOT}/scripts/cost-report.ts reflect .claude-code-hermit --plain ``` Otherwise (terminal/dev use or `--maintainer`), run the full breakdown: ``` bun ${CLAUDE_PLUGIN_ROOT}/scripts/cost-report.ts reflect .claude-code-hermit ``` Capture stdout. If the output starts with "No cost data" or "No spend recorded yet", report that message and stop — there's nothing to send. ## Step 2 — Relay the report **Terminal:** the script output is already formatted and capped at 1500 characters. Relay it verbatim. Don't summarize, reformat, or add commentary — the output is the report. **Channel (`--plain` output):** reply through that channel's reply tool. The script output is already plain language a...

Details

Author
gtapps
Repository
gtapps/claude-code-hermit
Created
5 months ago
Last Updated
today
Language
TypeScript
License
MIT

Integrates with

Similar Skills

Semantically similar based on skill content — not just same category