CtrlK
BlogDocsLog inGet started
Tessl Logo

calculator-design

Designing interactive calculators (ROI calculators, pricing estimators, savings projections, mortgage calculators, custom assessments) that deliver real decision-support value while serving as lead magnets and qualified-traffic generators. Honest about vanity-calculator (no real value), lead-trap (hides the answer behind email), and transparent-decision-tool (gives the result and earns the email through tiered value) patterns. Triggers on calculator, ROI calculator, pricing estimator, savings calculator, custom calculator, interactive tool, decision tool, financial calculator. Also triggers when an audience needs a calculation-driven lead magnet, when a vanity calculator is producing leads but no qualified ones, or when a calculator is being scoped for the first time.

58

Quality

67%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./skills/calculator-design/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

100%

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

This is a strong, well-crafted description that clearly defines a specific niche (interactive calculators as lead magnets), lists concrete actions and calculator types, and provides both keyword-based and situational triggers. The named patterns (vanity-calculator, lead-trap, transparent-decision-tool) add distinctive conceptual vocabulary that aids both selection and differentiation. Minor note: it's slightly verbose but the detail is substantive rather than padded.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions and types: ROI calculators, pricing estimators, savings projections, mortgage calculators, custom assessments. Also names specific patterns (vanity-calculator, lead-trap, transparent-decision-tool) which add concrete detail.

3 / 3

Completeness

Clearly answers both 'what' (designing interactive calculators for decision-support and lead generation, with awareness of different calculator patterns) and 'when' (explicit trigger terms listed, plus situational triggers like scoping a calculator for the first time or diagnosing poor lead quality).

3 / 3

Trigger Term Quality

Excellent coverage of natural trigger terms users would say: 'calculator', 'ROI calculator', 'pricing estimator', 'savings calculator', 'interactive tool', 'decision tool', 'financial calculator', 'lead magnet'. Also includes situational triggers like 'vanity calculator is producing leads but no qualified ones'.

3 / 3

Distinctiveness Conflict Risk

Highly distinctive niche combining interactive calculators with lead generation strategy. The specific calculator types, named patterns (vanity-calculator, lead-trap, transparent-decision-tool), and marketing-oriented framing make it very unlikely to conflict with generic coding or math skills.

3 / 3

Total

12

/

12

Passed

Implementation

35%

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

This skill is a thoughtful, opinionated guide to calculator design with a strong conceptual framework (vanity vs lead-trap vs transparent-decision-tool) and a useful 12-point checklist. However, it is significantly over-length, repeating core concepts across multiple sections, and lacks concrete actionable artifacts like templates, spec outlines, or example outputs. The content would benefit greatly from aggressive trimming and the addition of executable deliverables.

Suggestions

Cut content by 50%+: remove the introductory philosophy, voice description, repeated explanations of vanity/lead-trap/transparent-tool across sections, and basic concept explanations (input types like sliders and dropdowns). State each concept once.

Add a concrete artifact: include a sample calculator design spec template or a filled-out example showing inputs, formulas, tier structure, and methodology disclosure — something Claude can adapt directly.

Move detailed anti-patterns, input design patterns, and result presentation patterns entirely into the referenced files rather than duplicating them inline, making the SKILL.md a true overview.

Add explicit validation steps to the 12-consideration framework: e.g., 'After step 4, test methodology disclosure with a non-expert — can they explain the result?' to create a real workflow with checkpoints.

DimensionReasoningScore

Conciseness

Extremely verbose at ~300+ lines. Extensively explains concepts Claude already understands (what a vanity calculator is, what a lead-trap is, what input types exist like sliders and dropdowns). The same points about transparency, lead-traps, and vanity calculators are repeated across multiple sections. The introductory framing, voice description, and philosophical positioning consume significant tokens without adding actionable value.

1 / 3

Actionability

Provides a clear 12-point framework checklist and concrete anti-patterns with diagnostic descriptions, which is useful guidance. However, there are no executable code examples, no template structures, no sample calculator specs, and no concrete output formats. The worked example (B2B SaaS pricing calculator tiers) is helpful but remains at the conceptual level rather than providing copy-paste-ready artifacts.

2 / 3

Workflow Clarity

The 12-consideration framework provides a reasonable sequence for designing or auditing a calculator, and the failure-modes section offers diagnostic value. However, there are no explicit validation checkpoints, no feedback loops for iterating on a design, and no clear 'do this, then check that' workflow. The process is more of a checklist than a sequenced workflow with verification steps.

2 / 3

Progressive Disclosure

References 9 separate reference files with clear descriptions and relative paths, which is good structure. However, no bundle files were provided, so the references are unverifiable. More importantly, the SKILL.md itself is monolithic — much of the inline content (anti-patterns, input design patterns, result presentation patterns) duplicates what the reference files presumably contain, defeating the purpose of progressive disclosure.

2 / 3

Total

7

/

12

Passed

Validation

90%

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

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

10

/

11

Passed

Repository
rampstackco/claude-skills
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.