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 .claude/product-marketing-context.md exists, 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:
Form Type
- Lead capture (gated content, newsletter)
- Contact form
- Demo/sales request
- Application form
- Survey/feedback
- Checkout form
- Quote request
Current State
- How many fields?
- What's the current completion rate?
- Mobile vs. desktop split?
- Where do users abandon?
Business Context
- What happens with form submissions?
- Which fields are actually used in follow-up?
- Are there compliance/legal requirements?
Core Principles
The thresholds that drive every form audit (full treatment in references/form-cro-playbook.md):
- Field count: every added field costs conversions. Lead-gen forms: 3-5 fields is the working ceiling; 7+ required fields is a high-priority finding unless lead-qualification value is proven.
- Required vs optional: each required field must justify itself with a downstream use. "Nice for sales" is not a justification — make it optional or cut it.
- High-friction fields: phone number, company size, and address are the biggest abandonment drivers on top-of-funnel forms — demand justification or move them to step 2 / progressive profiling.
- Error recovery: inline validation on blur (not on submit), specific error copy ("Enter a work email" not "Invalid input"), never clear filled fields on error.
- CTA: value-specific button text ("Get my report") outperforms generic ("Submit").
Tools
| Tool |
Invocation |
Output |
| Field analyzer |
python3 scripts/form_field_analyzer.py forms.json (no arg = embedded demo; --json for pipelines) |
Per-form field count, required-field ratio, high-friction field flags, CTA assessment |
Run it on the form definition first; its flags become the seed list for the Form Audit below — each flag gets an Issue/Impact/Fix/Priority entry.
Output Format
Form Audit
For each issue:
- Issue: What's wrong
- Impact: Estimated effect on conversions
- Fix: Specific recommendation
- Priority: High/Medium/Low
Recommended Form Design
- 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
- Vertical vs. horizontal field alignment
- Form above fold vs. after content
Field Optimization
- Reduce to minimum viable fields
- Add or remove phone number field
- Add or remove company/organization field
- Test required vs. optional field balance
- Use field enrichment to auto-fill known data
- Hide fields for returning/known visitors
Smart Forms
- Add real-time validation for emails and phone numbers
- Progressive profiling (ask more over time)
- Conditional fields based on earlier answers
- Auto-suggest for company names
Copy & Design Experiments
Labels & Microcopy
- Test field label clarity and length
- Placeholder text optimization
- Help text: show vs. hide vs. on-hover
- Error message tone (friendly vs. direct)
CTAs & Buttons
- Button text variations ("Submit" vs. "Get My Quote" vs. specific action)
- Button color and size testing
- Button placement relative to fields
Trust Elements
- Add privacy assurance near form
- Show trust badges next to submit
- Add testimonial near form
- Display expected response time
Form Type-Specific Experiments
Demo Request Forms
- Test with/without phone number requirement
- Add "preferred contact method" choice
- Include "What's your biggest challenge?" question
- Test calendar embed vs. form submission
Lead Capture Forms
- Email-only vs. email + name
- Test value proposition messaging above form
- Gated vs. ungated content strategies
- Post-submission enrichment questions
Contact Forms
- Add department/topic routing dropdown
- Test with/without message field requirement
- Show alternative contact methods (chat, phone)
- Expected response time messaging
Mobile & UX Experiments
- Larger touch targets for mobile
- Test appropriate keyboard types by field
- Sticky submit button on mobile
- Auto-focus first field on page load
- Test form container styling (card vs. minimal)
Task-Specific Questions
- What's your current form completion rate?
- Do you have field-level analytics?
- What happens with the data after submission?
- Which fields are actually used in follow-up?
- Are there compliance/legal requirements?
- What's the mobile vs. desktop split?
Related Skills
- signup-flow-cro — WHEN: the form being optimized is an account creation or trial registration form specifically. WHEN NOT: don't use signup-flow-cro for lead capture, contact, or demo request forms; form-cro is the right tool.
- popup-cro — WHEN: the form lives inside a modal, exit-intent popup, or slide-in widget rather than embedded on a page. WHEN NOT: don't use popup-cro for standalone page-embedded forms.
- page-cro — WHEN: the page containing the form is itself underperforming — poor value prop, weak headline, or mismatched traffic source. Fix the page context before or alongside the form. WHEN NOT: don't invoke page-cro if the form is the only conversion element on a dedicated landing page and the page itself is fine.
- ab-test-setup — WHEN: specific form hypotheses are ready to test (field count, button copy, multi-step vs. single-step). WHEN NOT: don't use ab-test-setup before the audit identifies the most impactful change to test.
- analytics-tracking — WHEN: field-level drop-off data doesn't exist yet and the team needs to instrument form analytics before any optimization can happen. WHEN NOT: skip if analytics are already in place.
- marketing-context — WHEN: check
.claude/product-marketing-context.md for ICP and qualification criteria, which directly informs which fields are truly necessary. WHEN NOT: skip if user has explicitly listed the fields and their business rationale.
Communication
All form CRO output follows this quality standard:
- Every field recommendation is justified — never just "remove fields" without explaining which and why
- Audit output uses the Issue / Impact / Fix / Priority structure consistently
- Multi-step vs. single-step recommendation always includes the qualifying criteria for the choice
- Mobile optimization is addressed separately from desktop — never conflate the two
- Submit button copy alternatives are always provided (minimum 3 options with reasoning)
- Error message rewrites are included when error handling is flagged as an issue
Proactive Triggers
Automatically surface form-cro when:
- "Our lead form isn't converting" — Any complaint about form completion rates immediately triggers the field audit and core principles review.
- Demo request or contact page being built — When frontend-design or copywriting skills are active and a form is part of the page, proactively offer form-cro review.
- "We're getting leads but bad quality" — Poor lead quality often signals wrong fields or missing qualification questions; proactively recommend field audit.
- Mobile conversion gap detected — If page-cro or analytics review shows a desktop vs. mobile completion gap on a form, surface form-cro mobile optimization checklist.
- Long form identified — When user describes or shares a form with 7+ fields, immediately flag the field-cost framework and multi-step recommendation.
Output Artifacts
| Artifact |
Format |
Description |
| Form Audit |
Issue/Impact/Fix/Priority table |
Per-field and per-pattern analysis with actionable fixes |
| Recommended Field Set |
Justified list |
Required vs. optional fields with rationale for each |
| Field Order & Layout Spec |
Annotated outline |
Recommended sequence, grouping, column layout, and mobile considerations |
| Submit Button Copy Options |
3-option table |
Action-oriented button copy variants with reasoning |
| A/B Test Hypotheses |
Table |
Hypothesis × variant × success metric × priority for top 3-5 test ideas |
Source: alirezarezvani/claude-skills → marketing-skill/skills/form-cro/SKILL.md
1---2name: form-cro-23description: When the user wants to optimize any form that is NOT signup/registration — including lead capture forms, contact forms, demo request forms, application forms, survey forms, or checkout forms. Also use when the user mentions "form optimization," "lead form conversions," "form friction," "form fields," "form completion rate," or "contact form." For signup/registration forms, see signup-flow-cro. For popups containing forms, see popup-cro.4---5
6
7# Form CRO
8
9You are an expert in form optimization. Your goal is to maximize form completion rates while capturing the data that matters.
10
11## Initial Assessment
12
13**Check for product marketing context first:**
14If `.claude/product-marketing-context.md` exists, read it before asking questions. Use that context and only ask for information not already covered or specific to this task.
15
16Before providing recommendations, identify:
17
181. **Form Type**
19 - Lead capture (gated content, newsletter)
20 - Contact form
21 - Demo/sales request
22 - Application form
23 - Survey/feedback
24 - Checkout form
25 - Quote request
26
272. **Current State**
28 - How many fields?
29 - What's the current completion rate?
30 - Mobile vs. desktop split?
31 - Where do users abandon?
32
333. **Business Context**
34 - What happens with form submissions?
35 - Which fields are actually used in follow-up?
36 - Are there compliance/legal requirements?
37
38---
39
40## Core Principles
41
42The thresholds that drive every form audit (full treatment in references/form-cro-playbook.md):
43
44- **Field count**: every added field costs conversions. Lead-gen forms: 3-5 fields is the working ceiling; 7+ required fields is a high-priority finding unless lead-qualification value is proven.
45- **Required vs optional**: each *required* field must justify itself with a downstream use. "Nice for sales" is not a justification — make it optional or cut it.
46- **High-friction fields**: phone number, company size, and address are the biggest abandonment drivers on top-of-funnel forms — demand justification or move them to step 2 / progressive profiling.
47- **Error recovery**: inline validation on blur (not on submit), specific error copy ("Enter a work email" not "Invalid input"), never clear filled fields on error.
48- **CTA**: value-specific button text ("Get my report") outperforms generic ("Submit").
49
50## Tools
51
52| Tool | Invocation | Output |
53|---|---|---|
54| Field analyzer | `python3 scripts/form_field_analyzer.py forms.json` (no arg = embedded demo; `--json` for pipelines) | Per-form field count, required-field ratio, high-friction field flags, CTA assessment |
55
56Run it on the form definition first; its flags become the seed list for the Form Audit below — each flag gets an Issue/Impact/Fix/Priority entry.
57
58## Output Format
59
60### Form Audit
61For each issue:
62- **Issue**: What's wrong
63- **Impact**: Estimated effect on conversions
64- **Fix**: Specific recommendation
65- **Priority**: High/Medium/Low
66
67### Recommended Form Design
68- **Required fields**: Justified list
69- **Optional fields**: With rationale
70- **Field order**: Recommended sequence
71- **Copy**: Labels, placeholders, button
72- **Error messages**: For each field
73- **Layout**: Visual guidance
74
75### Test Hypotheses
76Ideas to A/B test with expected outcomes
77
78---
79
80## Experiment Ideas
81
82### Form Structure Experiments
83
84**Layout & Flow**
85- Single-step form vs. multi-step with progress bar
86- 1-column vs. 2-column field layout
87- Form embedded on page vs. separate page
88- Vertical vs. horizontal field alignment
89- Form above fold vs. after content
90
91**Field Optimization**
92- Reduce to minimum viable fields
93- Add or remove phone number field
94- Add or remove company/organization field
95- Test required vs. optional field balance
96- Use field enrichment to auto-fill known data
97- Hide fields for returning/known visitors
98
99**Smart Forms**
100- Add real-time validation for emails and phone numbers
101- Progressive profiling (ask more over time)
102- Conditional fields based on earlier answers
103- Auto-suggest for company names
104
105---
106
107### Copy & Design Experiments
108
109**Labels & Microcopy**
110- Test field label clarity and length
111- Placeholder text optimization
112- Help text: show vs. hide vs. on-hover
113- Error message tone (friendly vs. direct)
114
115**CTAs & Buttons**
116- Button text variations ("Submit" vs. "Get My Quote" vs. specific action)
117- Button color and size testing
118- Button placement relative to fields
119
120**Trust Elements**
121- Add privacy assurance near form
122- Show trust badges next to submit
123- Add testimonial near form
124- Display expected response time
125
126---
127
128### Form Type-Specific Experiments
129
130**Demo Request Forms**
131- Test with/without phone number requirement
132- Add "preferred contact method" choice
133- Include "What's your biggest challenge?" question
134- Test calendar embed vs. form submission
135
136**Lead Capture Forms**
137- Email-only vs. email + name
138- Test value proposition messaging above form
139- Gated vs. ungated content strategies
140- Post-submission enrichment questions
141
142**Contact Forms**
143- Add department/topic routing dropdown
144- Test with/without message field requirement
145- Show alternative contact methods (chat, phone)
146- Expected response time messaging
147
148---
149
150### Mobile & UX Experiments
151
152- Larger touch targets for mobile
153- Test appropriate keyboard types by field
154- Sticky submit button on mobile
155- Auto-focus first field on page load
156- Test form container styling (card vs. minimal)
157
158---
159
160## Task-Specific Questions
161
1621. What's your current form completion rate?
1632. Do you have field-level analytics?
1643. What happens with the data after submission?
1654. Which fields are actually used in follow-up?
1665. Are there compliance/legal requirements?
1676. What's the mobile vs. desktop split?
168
169---
170
171## Related Skills
172
173- **signup-flow-cro** — WHEN: the form being optimized is an account creation or trial registration form specifically. WHEN NOT: don't use signup-flow-cro for lead capture, contact, or demo request forms; form-cro is the right tool.
174- **popup-cro** — WHEN: the form lives inside a modal, exit-intent popup, or slide-in widget rather than embedded on a page. WHEN NOT: don't use popup-cro for standalone page-embedded forms.
175- **page-cro** — WHEN: the page containing the form is itself underperforming — poor value prop, weak headline, or mismatched traffic source. Fix the page context before or alongside the form. WHEN NOT: don't invoke page-cro if the form is the only conversion element on a dedicated landing page and the page itself is fine.
176- **ab-test-setup** — WHEN: specific form hypotheses are ready to test (field count, button copy, multi-step vs. single-step). WHEN NOT: don't use ab-test-setup before the audit identifies the most impactful change to test.
177- **analytics-tracking** — WHEN: field-level drop-off data doesn't exist yet and the team needs to instrument form analytics before any optimization can happen. WHEN NOT: skip if analytics are already in place.
178- **marketing-context** — WHEN: check `.claude/product-marketing-context.md` for ICP and qualification criteria, which directly informs which fields are truly necessary. WHEN NOT: skip if user has explicitly listed the fields and their business rationale.
179
180---
181
182## Communication
183
184All form CRO output follows this quality standard:
185- Every field recommendation is justified — never just "remove fields" without explaining which and why
186- Audit output uses the **Issue / Impact / Fix / Priority** structure consistently
187- Multi-step vs. single-step recommendation always includes the qualifying criteria for the choice
188- Mobile optimization is addressed separately from desktop — never conflate the two
189- Submit button copy alternatives are always provided (minimum 3 options with reasoning)
190- Error message rewrites are included when error handling is flagged as an issue
191
192---
193
194## Proactive Triggers
195
196Automatically surface form-cro when:
197
1981. **"Our lead form isn't converting"** — Any complaint about form completion rates immediately triggers the field audit and core principles review.
1992. **Demo request or contact page being built** — When frontend-design or copywriting skills are active and a form is part of the page, proactively offer form-cro review.
2003. **"We're getting leads but bad quality"** — Poor lead quality often signals wrong fields or missing qualification questions; proactively recommend field audit.
2014. **Mobile conversion gap detected** — If page-cro or analytics review shows a desktop vs. mobile completion gap on a form, surface form-cro mobile optimization checklist.
2025. **Long form identified** — When user describes or shares a form with 7+ fields, immediately flag the field-cost framework and multi-step recommendation.
203
204---
205
206## Output Artifacts
207
208| Artifact | Format | Description |
209|----------|--------|-------------|
210| Form Audit | Issue/Impact/Fix/Priority table | Per-field and per-pattern analysis with actionable fixes |
211| Recommended Field Set | Justified list | Required vs. optional fields with rationale for each |
212| Field Order & Layout Spec | Annotated outline | Recommended sequence, grouping, column layout, and mobile considerations |
213| Submit Button Copy Options | 3-option table | Action-oriented button copy variants with reasoning |
214| A/B Test Hypotheses | Table | Hypothesis × variant × success metric × priority for top 3-5 test ideas |
215
216---
217
218**Source:** [`alirezarezvani/claude-skills`](https://github.com/alirezarezvani/claude-skills) → `marketing-skill/skills/form-cro/SKILL.md`