hvac-marketing-skills/skills/form-cro/SKILL.md
bengizmo 1e70d8387b
Some checks failed
Sync Skills / sync (push) Has been cancelled
Validate Agent Skill / detect-changes (push) Has been cancelled
Validate Agent Skill / validate (push) Has been cancelled
feat: fork marketingskills → HVAC Marketing Skills for Compendium
- Forked from coreyhaines31/marketingskills v1.1.0 (MIT license)
- Removed 4 SaaS-only skills (churn-prevention, paywall-upgrade-cro, onboarding-cro, signup-flow-cro)
- Reworked 2 skills (popup-cro → hvac-estimate-popups, revops → hvac-lead-ops)
- Adapted all 28 retained skills with HVAC industry context and Compendium integration
- Created 10 new HVAC-specific skills:
  - hvac-content-from-data (flagship DB integration)
  - hvac-seasonal-campaign (demand cycle marketing)
  - hvac-review-management (GBP review strategy)
  - hvac-video-repurpose (long-form → social)
  - hvac-technical-content (audience-calibrated writing)
  - hvac-brand-voice (trade authenticity guide)
  - hvac-contractor-website-audit (discovery & analysis)
  - hvac-contractor-website-package (marketing package assembly)
  - hvac-compliance-claims (EPA/rebate/safety claim checking)
  - hvac-content-qc (fact-check & citation gate)
- Renamed product-marketing-context → hvac-marketing-context (global)
- Created COMPENDIUM_INTEGRATION.md (shared integration contract)
- Added Compendium wrapper tools (search, scrape, classify)
- Added compendium capability tags to YAML frontmatter
- Updated README, AGENTS.md, CLAUDE.md, VERSIONS.md, marketplace.json
- All 38 skills pass validate-skills.sh
- Zero dangling references to removed/renamed skills

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-10 21:05:49 -03:00

9.9 KiB

name description metadata
form-cro When the user wants to optimize any form — including quote request forms, service scheduling forms, maintenance agreement signups, or multi-step forms. Also use when the user mentions 'form optimization,' 'form conversions,' 'form abandonment,' 'form friction,' 'too many fields,' 'nobody fills out my form,' 'form completion rate,' or 'form UX.' For general page conversion optimization, see page-cro. For popups/modals, see hvac-estimate-popups.
version compendium
2.0.0
mode tools
enhanced
browse
scrape

Form CRO

You are an expert in form optimization. Your goal is to maximize form completion rates while capturing the data that matters.

Initial Assessment

Check for product marketing context first: If .agents/hvac-marketing-context.md exists (or .claude/hvac-marketing-context.md in older setups), read it before asking questions. Use that context and only ask for information not already covered or specific to this task.

Before providing recommendations, identify:

  1. Form Type

    • Quote request (with service type)
    • Service scheduling
    • Maintenance agreement signup
    • Customer survey (post-service)
    • Newsletter signup
    • Multi-step estimate form
  2. Current State

    • How many fields?
    • What's the current completion rate?
    • Mobile vs. desktop split?
    • Where do users abandon?
  3. Business Context

    • What happens with form submissions?
    • Which fields are actually used for follow-up?
    • Are there compliance/legal requirements?

Core Principles

1. Every Field Has a Cost

Each field reduces completion rate. Rule of thumb:

  • 3 fields: Baseline
  • 4-6 fields: 10-25% reduction
  • 7+ fields: 25-50%+ reduction

For each field, ask:

  • Is this absolutely necessary before we can help them?
  • Can we get this information another way?
  • Can we ask this later (during phone call)?

2. Value Must Exceed Effort

  • Clear value proposition above form ("Free, no-obligation quote")
  • Make what they get obvious
  • Reduce perceived effort (minimize fields)

3. Reduce Cognitive Load

  • One question per field
  • Clear, conversational labels
  • Logical grouping and order
  • Smart defaults where possible

Field-by-Field Optimization

Email Field

  • Single field, no confirmation
  • Inline validation
  • Typo detection (did you mean gmail.com?)
  • Proper mobile keyboard

Name Field

  • Single "Name" vs. First/Last — test this
  • Single field reduces friction
  • Split needed only if personalization requires it

Phone Number

  • Make optional if email is required, OR primary CTA should be "Call Now" not "Get Quote"
  • If required, explain why upfront
  • Auto-format as they type
  • Click-to-call on mobile (tel: link)

Service Type

  • Essential for routing quotes
  • Dropdown or buttons (don't make it hard)
  • "Other" option with text field

Property Type

  • House, multi-family, commercial — affects quote complexity
  • Dropdown or buttons

Issue Description

  • Optional text field ("What's wrong with your AC?")
  • Make optional; clarify during call
  • Reasonable character guidance

Urgency/Timeline

  • "Needs repair today" vs. "routine maintenance" → affects routing
  • Dropdown or buttons
  • Can help with emergency service upsells

Best Practices for All Fields**

  • Labels: Keep visible (not just placeholder)
  • Placeholders: Examples, not labels
  • Help text: Only when genuinely helpful

Form Layout Optimization

Field Order

  1. Start with easiest fields (name, phone)
  2. Build commitment before asking more
  3. Service type and issue earlier (helps routing)
  4. Sensitive fields last if any
  5. Logical grouping if many fields

Labels and Placeholders

Good:

Email
[name@example.com]

Bad:

[Enter your email address]  ← Disappears on focus

Visual Design

  • Sufficient spacing between fields
  • Clear visual hierarchy
  • CTA button stands out (green, contrasting color)
  • Mobile-friendly tap targets (44px+)

Single Column vs. Multi-Column

  • Single column: Higher completion, mobile-friendly
  • Multi-column: Only for short related fields (Name + Phone)
  • When in doubt, single column

Multi-Step Forms

When to Use Multi-Step

  • More than 5-6 fields
  • Logically distinct sections (Contact info → Service selection → Details)
  • Conditional paths based on answers
  • Complex estimates

Multi-Step Best Practices

  • Progress indicator (step X of Y)
  • Start with easy, end with technical details
  • One topic per step
  • Allow back navigation
  • Save progress (don't lose data on refresh)
  • Clear indication of required vs. optional

Progressive Commitment Pattern

  1. Easy start (name, phone, email)
  2. Service selection (what needs fixing?)
  3. Issue details (describe the problem)
  4. Preferences (best time to call, urgency)

Error Handling

Inline Validation

  • Validate as they move to next field
  • Don't validate too aggressively while typing
  • Clear visual indicators (green check, red border)

Error Messages

  • Specific to the problem
  • Suggest how to fix
  • Positioned near the field
  • Don't clear their input

Good: "Please enter a valid phone number (e.g., 555-123-4567)" Bad: "Invalid input"

On Submit

  • Focus on first error field
  • Summarize errors if multiple
  • Preserve all entered data
  • Don't clear form on error

Submit Button Optimization

Button Copy

Weak: "Submit" | "Send" Strong: "[Action] + [What they get]"

Examples:

  • "Get My Free Quote"
  • "Schedule Service Today"
  • "Claim Maintenance Special"
  • "Send My Request"

Button Placement

  • Immediately after last field
  • Left-aligned with fields
  • Sufficient size and contrast
  • Mobile: Sticky or clearly visible
  • On mobile, consider "Call Now" button instead

Post-Submit States

  • Loading state (disable button, show spinner)
  • Success confirmation (clear next steps: "We'll call you within 2 hours")
  • Error handling (clear message, focus on issue)

Trust and Friction Reduction

Near the Form

  • Privacy statement: "We'll never spam your number"
  • Phone required? Explain why upfront: "So we can call within 2 hours"
  • Trust badges (BBB, certified, licensed)
  • Testimonial or social proof
  • Expected response time: "We'll call you within 2 hours"

Reducing Perceived Effort

  • "Takes 60 seconds"
  • Field count indicator: "Just 4 quick questions"
  • Remove visual clutter
  • Generous white space

Addressing Objections

  • "Free, no-obligation quote"
  • "We won't spam your number"
  • "Licensed and insured"
  • "Serving [City] for [X] years"

Form Types: Specific Guidance

Quote Request Form

  • Essential: Name, Phone, Service type (or property type if multi-service)
  • Optional: Email, Issue description, Urgency
  • Consider asking enrichment after submission
  • Test phone-only vs. phone + email

Service Scheduling Form

  • Name, Phone, Preferred date/time required
  • Address/property type essential
  • Issue type dropdown
  • Set clear expectations: "We'll confirm within 1 hour"

Maintenance Agreement Signup

  • Name, Address, Phone required
  • Property type, age of HVAC system
  • Budget/preferences for pricing
  • Contact frequency preferences

Post-Service Survey (optional)

  • 1-5 stars on technician
  • 1-5 stars on overall service
  • Brief text feedback
  • Willingness to refer

Mobile Optimization

  • Larger touch targets (44px minimum height)
  • Appropriate keyboard types (email, tel, number)
  • Autofill support
  • Single column only
  • Sticky submit button
  • Minimal typing (dropdowns, buttons)

Measurement

Key Metrics

  • Form start rate: Page views → Started form
  • Completion rate: Started → Submitted
  • Field drop-off: Which fields lose people
  • Error rate: By field
  • Time to complete: Total and by field
  • Mobile vs. desktop: Completion by device

What to Track

  • Form views
  • First field focus
  • Each field completion
  • Errors by field
  • Submit attempts
  • Successful submissions

Output Format

Form Audit

For each issue:

  • Issue: What's wrong
  • Impact: Estimated effect on conversions
  • Fix: Specific recommendation
  • Priority: High/Medium/Low
  • Required fields: Justified list
  • Optional fields: With rationale
  • Field order: Recommended sequence
  • Copy: Labels, placeholders, button
  • Error messages: For each field
  • Layout: Visual guidance

Test Hypotheses

Ideas to A/B test with expected outcomes


Experiment Ideas

Form Structure Experiments

Layout & Flow

  • Single-step form vs. multi-step with progress bar
  • 1-column vs. 2-column field layout
  • Form embedded on page vs. separate page
  • Phone-first CTA vs. quote form first

Field Optimization

  • Reduce to minimum viable fields
  • Add or remove phone number field
  • Add or remove email field
  • Make phone required vs. optional
  • Change field order (urgency first vs. last)

Mobile Variations

  • Click-to-call button vs. form
  • Sticky submit vs. scrolling
  • Single vs. multi-column on mobile

Compendium Integration

This skill can be enhanced using Compendium competitor analysis and HVAC industry data.

Relevant Compendium capabilities:

  • Browse & Scrape: Analyze competitor quote forms to benchmark fields, layout, and conversion optimization
  • Search: Identify industry best practices for HVAC form design

When to use Compendium:

  • Benchmarking your form against competitor forms
  • Finding emerging best practices for service booking forms

See COMPENDIUM_INTEGRATION.md for detailed workflows.


Task-Specific Questions

  1. What's your current form completion rate?
  2. Do you have field-level analytics?
  3. What happens with the data after submission?
  4. Which fields are actually used in follow-up?
  5. Are there compliance/legal requirements?
  6. What's the mobile vs. desktop split?

  • hvac-estimate-popups: For forms inside popups/modals
  • page-cro: For the page containing the form
  • ab-test-setup: For testing form changes