CtrlK
BlogDocsLog inGet started
Tessl Logo

cost-trend-analysis

Use when analyzing whether costs are growing, declining, or stable over time — for forecasting, budget planning, or understanding spending velocity

57

Quality

72%

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 ./plugins/cost-analyst/skills/cost-trend-analysis/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

63%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, genuinely actionable multi-step procedure with concrete API calls and a complete output contract. Its weaknesses are token bloat from sections restating knowledge Claude already has, inlined reference-grade material (pattern catalog, output template) that belongs in bundle files, and the absence of explicit validation checkpoints in the query-then-compute loop.

Suggestions

Move the 'Common Trend Patterns and Causes' catalog, the 'Advanced Techniques' section, and the full 8-part output-format template into a reference file (e.g., references/trend-patterns.md, references/output-format.md), keeping SKILL.md as a lean overview that signals them at point of use — this addresses both the conciseness and progressive_disclosure gaps.

Trim or delete sections that restate knowledge Claude already has: the definitions in 'Identify Pattern Types' and 'Moving Averages', and the generic 'Tips for Effective Analysis' list, keeping only the CloudZero-specific advice.

Add an explicit validation checkpoint after Step 2 (e.g., verify the returned series covers the full date range and contains non-zero data before computing growth rates), and provide a runnable forecast script pattern alongside the illustrative growth-rate math.

DimensionReasoningScore

Conciseness

The core procedure (Steps 1-8) is efficient, but several sections explain concepts Claude already knows: pattern taxonomy ('Growth Pattern: Consistent upward trend'), moving averages ('7-day moving average for daily data... Helps identify true trend vs. noise'), and generic tips ('Context matters', 'Don't over-forecast'). The ~90-line output-format template and ~60-line pattern/cause catalog add padding. Mostly efficient with some unnecessary explanation — the 3 anchor; not 2 because the padding is sectioned rather than woven throughout, not 4 because the pattern catalog and tips sections are largely redundant with Claude's existing knowledge.

3 / 5

Actionability

Concrete API calls with parameters ('get_cost_data(granularity="daily", date_range="last 90 days", cost_type="real_cost")') and an executable Python growth-rate script make most guidance directly usable. Minor gaps: the forecast section uses illustrative pseudo-math ('If showing 6% monthly growth: Next month = Current month * 1.06') rather than a runnable script, and the script example uses placeholder constants with no guidance on binding real API data. Not 5 for those gaps; clearly above the 3 anchor's pseudocode level.

4 / 5

Workflow Clarity

An explicit, well-sequenced 8-step procedure (period → overall trend → growth metrics → dimensions → patterns → decomposition → forecast → drivers) with sensible defaults in Step 1 ('Last 90 days with daily granularity if not specified'). Checkpoints are mostly implicit — there is no step verifying data completeness or handling sparse/empty results before computing growth, and error handling is deferred to an external reference. Fits the 4 anchor (clear sequence, minor validation gaps); not 5 because no explicit validation or feedback-loop step exists, not 3 because the sequencing itself is unambiguous and defaults are handled.

4 / 5

Progressive Disclosure

No bundle files exist (references/, scripts/, assets/ are absent), and the body references only external plugin-root files ('${CLAUDE_PLUGIN_ROOT}/references/best-practices.md', error-handling.md, dimensions-reference.md, cost-types-reference.md) whose existence cannot be confirmed here. Within the ~415-line body, content that clearly belongs in separate files is inlined — the full output-format template, the pattern taxonomy, and the 'Common Trend Patterns and Causes' catalog — with the five cross-references buried in a 'See Also' list at the bottom rather than signaled at point of use. This matches the 3 anchor: structure exists, but separable content is inline and references are not clearly signaled.

3 / 5

Total

14

/

20

Passed

Description

70%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 solid description with an explicit 'Use when' trigger, natural user phrasing, and a clearly differentiated niche in cost analysis. Its main weakness is that the 'what' is folded into the trigger clause rather than stated as concrete capabilities (e.g., computing growth rates, decomposing trends, projecting spend).

DimensionReasoningScore

Specificity

The description names the domain ('analyzing whether costs are growing, declining, or stable over time') which functions as the 'what', but it lists no concrete actions such as calculating growth rates or producing forecasts — it only alludes to them via 'for forecasting, budget planning'. It sits between the 2-anchor (domain named, generic actions) and 4-anchor (several specific actions), but is closer to the middle anchor since 'analyzing cost trends' is a single fairly abstract action.

3 / 5

Completeness

Both elements are present: the 'what' (analyzing whether costs are growing, declining, or stable) is embedded in the 'Use when' clause, and the 'when' is explicit ('Use when analyzing... for forecasting, budget planning'). It is not a 5 because the 'what' is implicit in the trigger phrasing rather than stated as distinct capabilities, and not a 3 because the 'when' is explicit and specific.

4 / 5

Trigger Term Quality

Includes natural phrases users would say — 'costs are growing, declining, or stable over time', 'forecasting', 'budget planning' — but misses common variations like 'trend', 'month over month', 'spend growth', or 'cost increase/decrease'. Good coverage with a few natural terms missing, matching the 4 anchor; not 5 because synonym coverage is incomplete, not 3 because the phrases present are genuinely natural user language.

4 / 5

Distinctiveness Conflict Risk

The temporal-direction framing ('growing, declining, or stable over time') carves a clear niche distinct from anomaly detection or one-off cost analysis, and the trigger phrases are specific to trend questions. Minor overlap risk with sibling cost-analysis skills that also mention forecasting or budget planning; not a 5 for that reason, but well above the 'somewhat specific' 3 anchor.

4 / 5

Total

15

/

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
Cloudzero/cloudzero-claude-marketplace
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.