Lead Gen Calculator Skill

Lead Gen Calculator Skill

Multi-step calculator UI. Requires astro-forms for backend.

Purpose

Step-by-step calculator interface. Captures leads through progressive questions.

Output

calculator_ready: true
steps: [...]
step_limits: { max_steps: 7, max_fields_per_step: 4 }
primary_conversion: { type: calculator, id: "quote-calc" }
conversion_verdict: PASS | WARN | FAIL

Primary Conversion Declaration

Calculator IS the primary conversion on its page.

primary_conversion:
  type: calculator
  id: "quote-calculator"
  page: "/​kalkulator"

No other forms on calculator pages.

Page Exclusion Rules

Calculator on forbidden page = FAIL.

Step Limits (Cognitive Load)

step_limits:
  max_steps: 7
  max_fields_per_step: 4
  max_options_per_question: 6

Progressive Disclosure

Personal data only in final step.

Email before final step = FAIL.

Step Types & Auto-Advance

Data Integrity Contract

Calculator submissions MUST include:

data_contract:
  required:
    - quote_id         # Unique hash
    - all_answers      # Complete step data
    - source_page      # Calculator URL
    - timestamp        # ISO datetime
    - gdpr_consent     # true + timestamp
  calculated:
    - price_estimate   # If pricing enabled
    - breakdown        # Line items

Post-Submit Flow Contract

post_submit_flow:
  1_result_page: required      # /​eredmeny/[hash]
  2_confirmation_email: required
  3_analytics_event: required  # calculator_submit

Any missing = FAIL.

Visual Rules

Loading Strategy

GTM Events (Required)

gtm_events:
  - calculator_step      # Step viewed
  - calculator_option    # Option selected
  - calculator_submit    # Form submitted
  - calculator_value     # Quote amount

Missing events = WARN.

Browser State

Conversion Verdict

conversion_verdict: PASS | WARN | FAIL
issues: []

FAIL States

WARN States

References

• components.md — UI components
• client.md — Client JS
• gtm.md — Analytics events

Definition of Done

• Primary conversion declared
• Steps ≤7, fields/​step ≤4
• Personal data only in final step
• Data contract complete
• Post-submit flow complete
• GTM events configured
• Browser back handled
• conversion_verdict = PASS