CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

agent-cost-optimizer

Real-time cost tracking, budget enforcement, and ROI measurement for AI agent operations. Track token usage, predict costs, enforce budget caps ($50-70/month typical), optimize model selection, cache results, measure cost-to-value. Use when tracking AI costs, preventing budget overruns, optimizing spend, measuring ROI, or ensuring cost-effective AI operations.

Quality

69%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./.claude/skills/agent-cost-optimizer/SKILL.md

The canonical home for this skill is agent-cost-optimizer in fernandezbaptiste/Skrillz

SKILL.md
Quality
Evals
Security

Quality

Content

38%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.

The body is comprehensive on paper but padded and monolithic: material is duplicated across sections, code examples are illustrative rather than executable with no supporting scripts, and everything is inlined in one ~830-line file whose only external pointer targets a nonexistent examples/ directory. Restructuring into lean overview plus real reference files would address most weaknesses.

Suggestions

Split the SKILL.md body into a lean overview plus separate reference files (e.g., pricing.md, budget-alert-templates.md, roi-report-templates.md) and create the examples/ directory that the closing line points to, so the dangling reference resolves.

Deduplicate content: ROI calculation appears in both 'Operation 6: Measure ROI' and 'ROI Calculation Framework', and caching in both 'Operation 5' and 'Strategy 2' — keep one canonical treatment of each.

Make the code actionable: either ship executable helper scripts in scripts/ (implementing trackTokens, checkBudget, readCache/saveCache, predictCost) or restate the operations as concrete instructions Claude can perform with its own tools instead of pseudocode invoking an unspecified tracking library.

Remove the marketing/statistical padding ('Industry Context' spending stats, 'Key Innovation') and quarantine time-sensitive 2025 pricing into a clearly dated reference file so stale rates can be updated in one place.

DimensionReasoningScore

Conciseness

At ~830 lines the body is noticeably verbose: industry marketing stats ("Average AI spending: $85,521/month (36% YoY increase)", "Only 50% of organizations can measure AI ROI"), full ROI report templates duplicated in both 'Operation 6: Measure ROI' and 'ROI Calculation Framework', caching explained in both 'Operation 5' and 'Strategy 2', and time-sensitive 2025 pricing tables not quarantined in a dated section. This fits the 'several unnecessary explanations or padded sections' anchor; it is not a 1 because the material is on-topic domain data rather than explanations of concepts Claude already knows.

2 / 5

Actionability

The TypeScript snippets invoke undefined helpers (trackTokens, getCurrentMonthUsage, readCache, saveCache, predictCost, isExpired, isCritical) and no scripts/ bundle exists to back them, so they read as illustrative pseudocode; the bash log-appending snippets and JSON structures are more concrete, and the pricing/decision tables provide real data. 'Some concrete guidance but incomplete; pseudocode instead of executable code' is the closest anchor — above minimal hints (2) but below mostly-executable guidance (4).

3 / 5

Workflow Clarity

Each of the seven operations has a numbered process and the budget-enforcement flow includes check-before-execute with warning/critical thresholds and fallback options, but explicit validation checklists appear in only 2 of 7 operations (Operations 1 and 5) and there are no fix-and-retry feedback loops for the tracking pipeline itself. Sequence is present but checkpoints are inconsistently applied, matching the 3 anchor rather than 'most checkpoints present' (4).

3 / 5

Progressive Disclosure

An 830-line monolith: pricing tables, alert templates, and full ROI report templates that clearly belong in separate reference files are all inlined, and the only navigation pointer is 'For cost reports, see examples/' — a directory that does not exist in the bundle. This matches 'content that clearly belongs in separate files is inlined'; it is above a 1 only because clear section headers keep the body navigable.

2 / 5

Total

10

/

20

Passed

Description

88%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 strong description: it enumerates concrete capabilities in third-person imperative voice and closes with an explicit, well-phrased 'Use when...' trigger clause. The only weakness is that the trigger vocabulary, while good, omits several natural synonyms a user might say when reaching for this skill.

DimensionReasoningScore

Specificity

Lists six concrete actions — "Track token usage, predict costs, enforce budget caps ($50-70/month typical), optimize model selection, cache results, measure cost-to-value" — giving comprehensive coverage of the cost-management domain with no vague filler. This matches the anchor for multiple specific concrete actions rather than the 'minor gaps' anchor below it.

5 / 5

Completeness

Explicitly answers both: a clear multi-action 'what' and a concrete 'Use when tracking AI costs, preventing budget overruns, optimizing spend, measuring ROI...' clause. This matches the anchor for clearly answering both what AND when with concrete trigger phrases, not the weaker 'when could be more explicit' anchor (4).

5 / 5

Trigger Term Quality

Trigger clause covers natural phrases users would say — "tracking AI costs, preventing budget overruns, optimizing spend, measuring ROI, or ensuring cost-effective AI operations" — but misses common synonyms like "reduce AI spend", "token costs", or "API bill". Good coverage with a few natural terms missing fits the 4 anchor; it is well above 'some relevant keywords' (3) but short of comprehensive synonym coverage (5).

4 / 5

Distinctiveness Conflict Risk

The niche (AI agent cost management, token usage, budget caps for AI operations) is clearly staked out and triggers are AI-specific, but generic business phrasing like "measuring ROI" and "optimizing spend" leaves minor overlap risk with general budgeting or FinOps skills. Mostly distinct with minor overlap fits 4 rather than the clear-niche-minimal-conflict anchor (5).

4 / 5

Total

18

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (830 lines); consider splitting into references/ and linking

Warning

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

Total

14

/

16

Passed

Repository

fernandezbaptiste/Skrillz

Path

.claude/skills/agent-cost-optimizer/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.