mcpbeat

LLM Cost Optimizer

borghei/llm-cost-optimizer

> This skill should be used when the user asks to "estimate LLM costs", "count tokens in prompts", "optimize prompt token usage", "compare model pricing", or "reduce LLM API costs".

13k tokens
context cost
the whole folder, loaded on every use
6
files
ships runnable scripts
0
copies elsewhere
how many repositories repackaged it
447
stars on the repo
on the repository, not the skill itself

Install

one command, takes just this skill from the repository
npx skills add https://github.com/borghei/Claude-Skills --skill llm-cost-optimizer

What comes with it

46 125 bytes besides the instruction
references/caching-and-batch-economics.md
references/llm-pricing-guide.md
scripts/cache_savings_calculator.py
scripts/prompt_optimizer.py
scripts/token_counter.py

The instruction itself

12 sections, as written by the author

LLM Cost Optimizer

> Category: Engineering

> Domain: AI Cost Management

Overview

The LLM Cost Optimizer skill provides tools for counting tokens, estimating costs across different LLM providers, and optimizing prompts to reduce token usage without sacrificing quality. Essential for teams managing LLM API budgets at scale.

Clarify First

Before estimating or optimizing, confirm these inputs. If any is unknown or vague, ASK — do not assume:

  • [ ] Input prompt/text — the prompt file or text to count or optimize (the input via --file/--text/--stdin)
  • [ ] Target models — which models to estimate cost for (sets --models and the pricing comparison)
  • [ ] Goal — cost estimation vs prompt optimization, and any target reduction (selects token_counter.py vs prompt_optimizer.py and sets --target-reduction)

Stop rule: ask only the 2-3 that most change the output. If the user says "just draft it," proceed and list your assumptions at the top of the artifact.

Quick Start

# Count tokens in a prompt file and estimate costs
python scripts/token_counter.py --file prompt.txt --models gpt-4o claude-sonnet

# Count tokens from stdin
echo "Hello world" | python scripts/token_counter.py --stdin --models all

# Analyze a prompt for optimization opportunities
python scripts/prompt_optimizer.py --file system_prompt.txt

# Optimize with target reduction
python scripts/prompt_optimizer.py --file prompt.txt --target-reduction 30

Tools Overview

| Tool | Purpose | Key Flags |

|------|---------|-----------|

| token_counter.py | Count tokens and estimate costs across models | --file, --text, --stdin, --models |

| prompt_optimizer.py | Analyze prompts for token reduction opportunities | --file, --target-reduction, --format |

| cache_savings_calculator.py | Model prompt-cache economics: naive vs cached cost, break-even reuse, % savings | --requests, --cached-tokens, --cache-write-multiplier, --cache-read-multiplier, --base-input-price, --json |

Workflows

Cost Estimation for New Project

  • Collect sample prompts (system prompt + user messages)
  • Run token_counter.py with target models
  • Multiply per-request cost by expected daily volume
  • Compare models on cost-quality tradeoff

Prompt Optimization Sprint

  • Identify highest-cost prompts from usage logs
  • Run prompt_optimizer.py on each
  • Apply suggested optimizations
  • Re-count tokens to verify reduction
  • A/B test optimized vs. original for quality

Reference Documentation

  • LLM Pricing Guide - Current pricing for major LLM providers, token estimation methods
  • Caching & Batch Economics - Prompt/context caching break-even math, batch-API cost tradeoff, reasoning-effort cost impact, structured-output token overhead (model-agnostic, user-supplied rates)

Common Patterns

Token Reduction Techniques

  • Remove redundant instructions and examples
  • Use shorter variable names in few-shot examples
  • Compress verbose system prompts
  • Replace repeated context with references
  • Use structured output formats (JSON) to reduce response tokens
  • Batch multiple requests into single prompts where possible

Cost-Effective Model Selection

  • Use smaller models for classification/extraction tasks
  • Reserve large models for complex reasoning
  • Implement model routing based on query complexity
  • Cache responses for identical or similar queries
  • Cache the stable system-prompt/context/schema prefix (most-stable first, volatile last) and check the reuse break-even with cache_savings_calculator.py
  • Route bulk, non-interactive work to the batch API (~half cost for added latency); right-size reasoning effort per route — high only where accuracy demands it

How to use it

Copy the folder

Take borghei/llm-cost-optimizer from the repository into ~/.claude/skills for personal use, or into .claude/skills inside a project.

Check the name does not clash

The agent identifies a skill by the name field in its header. Two skills with the same name cannot sit side by side — one of them will be ignored.