CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

cost-aware-llm-pipeline

Cost optimization patterns for LLM API usage — model routing by task complexity, budget tracking, retry logic, and prompt caching.

1.31x
Quality

74%

Does it follow best practices?

Impact

100%

1.31x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./skills/cost-aware-llm-pipeline/SKILL.md

The canonical home for this skill is cost-aware-llm-pipeline in affaan-m/ECC

SKILL.md
Quality
Evals
Security

Quality

Content

67%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-structured, largely actionable skill body with concrete Python examples for all four techniques and a clear composed pipeline with a budget checkpoint. Its main weaknesses are the stale-prone dated pricing table, a redundant duplicate trigger section, and small completeness gaps in the code (missing import, placeholder composition example).

Suggestions

Move the dated pricing table into a separate reference file (e.g. references/pricing.md) or clearly label it as time-sensitive so stale numbers don't occupy main-body tokens.

Merge the duplicate 'When to Activate' and 'When to Use' sections into a single trigger list and fold that guidance into the description as well.

Fix code gaps: add `import time` to the retry example and either complete the Composition example (define Config, BudgetExceededError, build_cached_messages) or explicitly flag it as illustrative.

DimensionReasoningScore

Conciseness

The prose is mostly lean and assumes competence, but two issues keep it at anchor 3: the dated "Pricing Reference (2025-2026)" section embeds version-specific prices that the guidelines say should penalize conciseness unless isolated in a deprecated/reference section, and the "When to Activate" and "When to Use" sections redundantly repeat the same trigger list. Not anchor 2 because there is no padding or explanation of concepts Claude already knows.

3 / 5

Actionability

Core sections give concrete, near-executable code (select_model, frozen-dataclass CostTracker, retry with exponential backoff, cache_control message structure). Minor gaps keep it from anchor 5: call_with_retry uses time.sleep without importing time, and the Composition example contains undefined names (Config, BudgetExceededError, parse_result, build_cached_messages) and literal '...' placeholders.

4 / 5

Workflow Clarity

The Composition section lays out a clear numbered sequence (route model → check budget → call with retry+caching → track cost) with an explicit pre-flight checkpoint that raises BudgetExceededError before overspend, and retry/backoff provides an error-recovery loop. It is not anchor 5 because there is no post-call validation of the response or result before returning.

4 / 5

Progressive Disclosure

No bundle files exist, and the ~180-line body is well organized into scannable sections (Core Concepts, Composition, Best Practices, Anti-Patterns) with each concept clearly headed. Minor gaps versus anchor 5: the time-sensitive pricing table would sit better in a separate reference file, and the duplicate When to Activate/When to Use sections blur navigation.

4 / 5

Total

15

/

20

Passed

Description

71%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A specific, third-person description that clearly states what the skill does via four named techniques, but it omits any explicit 'Use when...' trigger guidance, which both caps completeness and slightly limits its discoverability. Natural keyword coverage is good though missing a few common synonyms.

Suggestions

Append an explicit trigger clause, e.g. 'Use when building applications that call Claude/OpenAI APIs, processing batches with varying complexity, or when the user mentions API costs, budgets, or spending limits.'

Add natural synonyms users would actually say, such as 'API spend', 'token costs', 'save money on inference', or 'cheaper models', to strengthen trigger term coverage.

DimensionReasoningScore

Specificity

The description lists four concrete, specific capabilities — "model routing by task complexity, budget tracking, retry logic, and prompt caching" — which comprehensively cover the techniques demonstrated in the skill body. It matches the anchor for multiple specific concrete actions with comprehensive coverage; it is above anchor 4 because coverage of the skill's scope is complete rather than having minor gaps.

5 / 5

Completeness

The 'what' is clearly and concretely answered (the four named techniques), but there is no 'Use when...' clause or equivalent explicit trigger guidance — per the judging guidelines this caps completeness at 3. It is not lower because the 'what' half is explicit and specific.

3 / 5

Trigger Term Quality

Good natural keyword coverage: "LLM API", "cost", "model routing", "budget", "prompt caching" are phrases users would plausibly say. It falls short of anchor 5 because common synonyms like "API spend", "save on tokens", or "cheaper models" are missing, though it is clearly above anchor 3's partial coverage.

4 / 5

Distinctiveness Conflict Risk

The cost-optimization framing ("budget tracking", "prompt caching", "model routing") carves a fairly distinct niche with low conflict risk against generic LLM-API or coding skills. Minor overlap risk with general LLM-development skills keeps it at anchor 4 rather than 5.

4 / 5

Total

16

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

valeriibeck-star/claude-skills

Path

skills/cost-aware-llm-pipeline/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.