rampstackco/claude-skills / skills/calculator-design
calculator-design
VerifiedDesigning 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.
| File | Kind | Size |
|---|---|---|
| README.md | markdown | 358 B |
| SKILL.md | skill md | 23.2 KB |
| references/calculation-logic-transparency.md | markdown | 11.4 KB |
| references/calculator-anti-patterns.md | markdown | 10.1 KB |
| references/calculator-investment-criteria.md | markdown | 9.8 KB |
| references/common-calculator-failures.md | markdown | 9.1 KB |
| references/email-capture-decision-tree.md | markdown | 10.6 KB |
| references/input-design-patterns.md | markdown | 10.7 KB |
| references/methodology-disclosure-templates.md | markdown | 10.4 KB |
| references/result-presentation-patterns.md | markdown | 10.6 KB |
| references/tiered-value-structures.md | markdown | 10.3 KB |
references/email-capture-decision-tree.md
View on GitHub# Email-capture decision tree
What to give freely, what to gate. The lead-trap failure and the transparent-tool win.
The single most consequential decision in calculator design is what gets shown freely and what requires an email. Get this wrong and the calculator is either a lead-trap (gating the result the user came for) or a missed opportunity (giving away everything with no capture mechanism).
---
## The honest principle
Give the audience the result they came for. Gate the additional value.
The audience showed up to run a calculation. They want the answer. Gating the answer is bait-and-switch: the calculator promised a result, the user provided inputs, and the result is held hostage until they trade an email.
The transparent alternative: give the result freely. The audience gets what they came for. The brand offers additional value (a PDF report, a saved scenario, a custom analysis) that the audience can opt in for. The email exchange is then for additional value, not for the result the calculator promised.
---
## What to give freely
Tier 1, no gate.
**The headline result.** The number the user came for. "Your annual savings: $14,200" or "Recommended plan: Growth."
**The breakdown.** The components that explain how the headline number was calculated. Necessary for the audience to defend the result.
**A basic visualization.** A chart or comparison that helps the user see the relationship.
**The methodology disclosure.** Either inline formulas or a methodology link. Necessary for the audience to trust the result.
**Source citations.** Where the calculator's benchmarks come from.
**The assumption list.** What the calculator assumes about the user's situation.
This set is what the audience needs to use the calculator's output in their decision. Holding any of it hostage is the lead-trap pattern.
---
## What to gate (with email)
Tier 2, email-required.
**A formatted PDF report.** The result, breakdown, methodology, and assumptions in a shareable format. The user can send this to their stakeholders. The PDF has to be genuinely better than a screenshot of the result; otherwise the gate is not justified.
**A saved scenario the user can revisit.** Persistence across visits. The user adjusts inputs over time, returns to compare, sees how the result has changed. Email-required to identify the user.
**A custom or deeper analysis.** A second-pass calculation that uses the user's inputs as a starting point and adds more depth (more variables, more scenarios, more methodology). Often delivered later (by email) rather than immediately.
**Email-based notifications.** When the calculator's benchmarks change or new versions launch, the user can be notified.
The discipline. Each gated tier has to add real value over the free tier. If the PDF is just "the same result in a PDF," the gate is not earning the email.
---
## What to gate (with account or sign-up)
Tier 3, account-required.
**Save-and-compare across multiple scenarios.** The user models 5 different configurations and compares them side-by-side. Account-level persistence supports this.
**Integration with the brand's product or service.** The calculator's output flows into the user's account on the brand's platform; the calculation becomes part of an ongoing workflow.
**Historical comparison.** When the calculator is used periodically (monthly cost projection, quarterly review), the user's historical inputs and results are tracked.
**Collaboration features.** Multiple users on the same account can model scenarios together.
These features warrant the higher friction of account creation. Email alone is insufficient; the user needs persistent identity for these to work.
---
## The lead-trap failure
The pattern that destroys conversion.
**The pattern.** The user enters inputs, hits Calculate, sees "enter your email to see your result."
**Why it fails.**
- The audience perceives the manipulation. The calculator promised a result; the result is hidden.
- Conversion drops. Many users abandon at the gate; some enter throwaway emails.
- The leads that do convert are unqualified or actively annoyed; downstream conversion is poor.
- The brand earns "lead-trap" reputation; future users who recognize the pattern bounce immediately.
**Why teams build lead-traps.** Short-term thinking. The team optimizes for capture rate without measuring downstream conversion. The lead-trap looks like it works because the form-fill rate is high; the lead-trap fails because the leads do not convert.
**The cure.** Restructure the calculator so the result is free and the additional value is gated. Conversion to the email gate may drop in absolute terms, but the leads that do opt in are higher-quality.
---
## The transparent-tool win
The pattern that compounds credibility.
**The pattern.** The user enters inputs, sees the result immediately, and is offered a "Get this as a PDF" or "Save this scenario" option that requires email.
**Why it works.**
- The audience trusts the brand. The calculator delivered on its promise.
- The email opt-in is for additional value, not for the result. Users who opt in are signaling real interest in the topic.
- Lead quality is higher because the lead opted in for value-add, which signals genuine interest.
- The brand earns "honest" reputation; word-of-mouth and referral grow.
**The metrics that matter.**
- Free-tier completion rate (how many users finish the calculation and see the result).
- Email-tier conversion rate (of those who see the result, how many opt in for the additional value).
- Downstream conversion (of those who opted in, how many engage with the follow-up sequence and convert to the next step).
The transparent-tool optimizes for downstream conversion, which is the metric that matters for the program.
---
## The decision tree
Walk through this for each gating decision.
**Question 1: Is this the result the user came for?**
- If yes: do not gate. Holding the user-promised result hostage is lead-trap.
- If no: continue.
**Question 2: Is this additional value the user might want?**
- If yes: gating is potentially appropriate.
- If no: do not gate; the user does not want it badly enough for the email exchange to be worthwhile.
**Question 3: Is the additional value substantial enough to justify the email?**
- If yes: gate it. The user gets real value; the brand gets the email; the exchange is honest.
- If no: do not gate; the gate is not earning its friction.
**Question 4: Could the additional value be delivered better as a follow-up after the email?**
- If yes: gate it as a follow-up offer in the post-result flow, not as a barrier to the result.
- If no: gate it as a clear "get this additional value" offer near the result.
This decision tree separates honest gating from manipulative gating.
---
## Worked examples
**Example 1: SaaS pricing calculator.**
- Free: recommended plan, monthly cost estimate, breakdown by component, methodology link.
- Email-gated: a PDF showing the recommendation, alternative plans considered, and a printable comparison table.
- Account-gated: ability to save the scenario and adjust over time as the team's needs change.
The free tier delivers what the prospect came for. The email gate delivers a shareable artifact for the prospect's internal stakeholders. The account gate enables ongoing use.
**Example 2: ROI calculator for a B2B service.**
- Free: estimated annual savings, breakdown across cost reduction and productivity gains, methodology disclosure.
- Email-gated: PDF analysis with industry-comparison context and worked-example case study.
- Account-gated: not offered. The calculator is single-use; account creation is unnecessary friction.
The free tier serves the audience. The email gate serves the prospect's internal stakeholders by providing a shareable analysis.
**Example 3: Mortgage calculator.**
- Free: estimated monthly payment, breakdown across principal, interest, taxes, insurance, methodology link.
- Email-gated: a personalized rate quote (which requires the bank to underwrite based on user inputs).
- Not offered: account creation. The calculator is a one-shot tool; account creation does not match the use case.
The email gate is justified by genuine value-add (personalized rate quote requires underwriting). The free tier delivers the calculator's promise.
---
## When the email gate is the wrong tool
Sometimes no gating is the right answer.
**Calculators built primarily for SEO or brand authority.** A widely-shared, well-ranked calculator can be a strong brand asset even without lead capture. The audience that uses it associates the brand with the topic; the SEO ranking compounds traffic.
**Calculators where lead-capture friction destroys the value proposition.** A simple, quick-use calculator may be best as a no-gate tool. The audience uses it, gets value, returns; the brand becomes the source of the tool.
**Calculators in regulated industries.** Some sectors have specific privacy or regulatory constraints on email capture. The calculator may need to operate without standard lead-capture flows.
The decision depends on the program's goals. Not every calculator needs to be a lead magnet. Some calculators serve other purposes (SEO, brand, audience-building) better without gates.
---
## Common gating failures
**Result hidden behind email.** The lead-trap. Conversion drops; downstream metrics drop further.
**Gate without value.** Email required to access something that should have been free; no real additional value behind the gate.
**Gate that lies about what is gated.** "Get the full analysis" suggests the free version was incomplete; the user expects more depth, gets the same content reformatted, feels deceived.
**Multiple gates in sequence.** Email for one tier, account for another, phone number for a third. Each step adds friction; cumulative drop-off destroys the audience.
**Gate copy that is manipulative.** "Don't lose your result, give us your email" is hostile. "Want this as a PDF? Enter your email" is honest.
**Gate placement that interrupts the result viewing.** The result loads; the user starts reading; a popup appears asking for email. The user's flow breaks; trust drops.
---
## Methodology-level choices that stay in the public skill
The honest principle. What to give freely. What to gate at email and at account level. The lead-trap failure pattern. The transparent-tool win pattern. The decision tree. Worked examples. When the email gate is the wrong tool. Common gating failures.
## Implementation choices that stay internal
Specific gating decisions for the team's calculators. Specific PDF templates and follow-up flows. Specific account-creation flows and integration patterns. Specific gate copy in brand voice. The team's downstream-conversion benchmarks. These vary by team.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |