CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

roi-calculator

Use when the user asks to "calculate influencer ROI", "prove campaign value", or "what was our ROAS"; produces direct ROI/ROAS, earned media value, attribution-modeled revenue, LTV-based ROI, and a stakeholder-ready summary. Not for building the full slide/written report — use report-generator. 达人营销ROI计算/投资回报测算

Quality

92%

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

SKILL.md
Quality
Evals
Security

Quality

Content

88%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 dense, high-precision instruction skill: fully executable formulas, a worked example, and a well-validated ten-step workflow with explicit NEEDS_INPUT checkpoints and a completion checklist. The deductions are minor — some repeated policy text and STAR gating detail that could live in the referenced benchmark file.

Suggestions

State the denominator-verification rule once (either the 'Done when' item or the paragraph after step 10) and reference it elsewhere, trimming the duplicated passage.

Move step 9's R1–R6 mapping detail into the referenced star-benchmark.md and keep only the handoff instruction inline, shortening the SKILL.md body.

Break step 6's single multi-clause sentence into a short checklist of LTV-input requirements for easier scanning.

DimensionReasoningScore

Conciseness

The body explains no concepts Claude already knows — its length is genuine precision policy — but the denominator-verification rule is stated twice ("Done when" item 4 and the paragraph after step 10) and step 6 packs roughly nine conditions into a single run-on sentence. Efficient with minor trimmable repetition fits anchor 4; it is not anchor 5 because not every token earns its place, and not 3 because nothing explained is unnecessary.

4 / 5

Actionability

Every methodology has an explicit formula (Simple ROI, ROAS, both EMV bases, ((New Customers × contribution-margin LTV) − Investment) / Investment × 100, sum(attributed revenue)/sum(spend)), a full worked example with input and output, and per-step fill-in templates that exist in references/roi-templates.md with matching anchors. For an instruction-only skill this is copy-paste-ready guidance covering the common cases.

5 / 5

Workflow Clarity

Ten explicitly sequenced steps with per-step NEEDS_INPUT feedback loops (e.g., "If no valid comparator exists, return NEEDS_INPUT for EMV"), a four-item "Done when" checklist, mandatory denominator validation, a profitability-verification gate, and a termination rule (visited-set, max 3 hops). Clear sequence with explicit validation and error-recovery checkpoints matches anchor 5; no destructive/batch cap applies.

5 / 5

Progressive Disclosure

Good one-level-deep structure: core formulas inline, bulk templates in the verified references/roi-templates.md, each step linked to its anchor block, and a described Reference Materials section. Falls short of anchor 5 because step 9's three paragraphs of STAR R1–R6 gating detail overlap the already-referenced star-benchmark.md, and numerous ../../../ cross-skill links are unresolvable within this bundle.

4 / 5

Total

18

/

20

Passed

Description

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

An exemplary description: concrete enumerated capabilities, quoted natural trigger phrases in two languages, and both explicit 'when' guidance and a negative boundary. The only weakness is residual overlap with adjacent analytics skills in the same family beyond the one explicitly disambiguated.

DimensionReasoningScore

Specificity

"produces direct ROI/ROAS, earned media value, attribution-modeled revenue, LTV-based ROI, and a stakeholder-ready summary" lists five concrete outputs covering the full methodology set, in third person. This matches the comprehensive-coverage anchor; score 4 would require only 'several' actions with gaps, but coverage here is complete for the domain.

5 / 5

Completeness

Explicitly answers both questions: 'what' via the enumerated outputs and 'when' via "Use when the user asks to..." with concrete trigger phrases, and adds a negative boundary ("Not for building the full slide/written report — use report-generator"). This is the anchor-5 pattern; the 'when' clause is explicit, not weakly implied as at 4.

5 / 5

Trigger Term Quality

Quotes verbatim natural user phrases — "calculate influencer ROI", "prove campaign value", "what was our ROAS" — plus ROI/ROAS/EMV/LTV vocabulary and bilingual synonyms (达人营销ROI计算/投资回报测算). Trigger phrasing is quoted as users would actually say it, exceeding the 'good coverage, few missing' anchor at 4.

5 / 5

Distinctiveness Conflict Risk

The influencer-ROI niche is clear and the closest conflict (report writing) is explicitly fenced off, but "prove campaign value" and "stakeholder-ready summary" retain minor overlap with same-family skills (performance-analyzer, budget-optimizer) that are not disambiguated. Fits 'mostly distinct; minor overlap risk with closely related skills' rather than the minimal-conflict anchor at 5.

4 / 5

Total

19

/

20

Passed

Validation

81%

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

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_field

'metadata' should map string keys to string values

Warning

frontmatter_unknown_keys

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

Warning

relative_links

Relative link issues: 18 suspicious

Warning

Total

13

/

16

Passed

Repository

aaron-he-zhu/aaron-marketing-skills

Path

influencer/report/roi-calculator/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.