New: Earn 20% as an AgentAlley affiliate. Share your link and earn on every sale you refer. Join now New: Earn 20% as an affiliate. Join now

Optimize any form that is NOT signup/registration

Form CRO

by alirezarezvani · MIT license · ★ 26,349 on GitHub · updated Aug 30

Form CRO cover

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…

---
name: "form-cro"
description: 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.
license: MIT
metadata:
  version: 1.0.0
  author: Alireza Rezvani
  category: marketing
  updated: 2026-03-06
---

# 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:**

Overview

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

Manual install (npx, ZIP)
Claude Codenpx skills add alirezarezvani/claude-skills --skill form-cro -g -a claude-code
Claude Code (manual)mkdir -p ~/.claude/skills && curl -sL https://codeload.github.com/alirezarezvani/claude-skills/tar.gz/19392f7a0826 \ | tar -xz -C ~/.claude/skills --strip-components=3 claude-skills-19392f7a0826/marketing-skill/skills/form-cro
Windows (PowerShell)New-Item -ItemType Directory -Force "$HOME\.claude\skills" | Out-Null; Invoke-WebRequest "https://m.agentalley.io/zip/ecd1f8429ffc109958d1/form-cro.zip" -OutFile "$env:TEMP\form-cro.zip"; Expand-Archive "$env:TEMP\form-cro.zip" -DestinationPath "$HOME\.claude\skills" -Force
Claude.ai / desktopDownload the ZIP and upload it under Settings → Capabilities → Skills.
Codex, Cursor, other agentsPoint them at SKILL.md. The other files are plain text.

Connects with Agent Alley MCP · agentalley.io/mcp

Files included

  • SKILL.md9.2 KB
  • references/1 file · 6.0 KB
  • scripts/1 file · 9.9 KB
Read the files here
alirezarezvani/19392f73 files
SKILL.md
Show the full text220 lines

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:

  1. Form Type

    • Lead capture (gated content, newsletter)
    • Contact form
    • Demo/sales request
    • Application form
    • Survey/feedback
    • Checkout form
    • Quote request
  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 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
  • 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

  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?

  • 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:

  1. "Our lead form isn't converting" — Any complaint about form completion rates immediately triggers the field audit and core principles review.
  2. 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.
  3. "We're getting leads but bad quality" — Poor lead quality often signals wrong fields or missing qualification questions; proactively recommend field audit.
  4. 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.
  5. 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
1---
2name: "form-cro"
3description: 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.
4license: MIT
5metadata:
6 version: 1.0.0
7 author: Alireza Rezvani
8 category: marketing
9 updated: 2026-03-06
10---
11 
12# Form CRO
13 
14You are an expert in form optimization. Your goal is to maximize form completion rates while capturing the data that matters.
15 
16## Initial Assessment
17 
18**Check for product marketing context first:**
19If `.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.
20 
21Before providing recommendations, identify:
22 
231. **Form Type**
24 - Lead capture (gated content, newsletter)
25 - Contact form
26 - Demo/sales request
27 - Application form
28 - Survey/feedback
29 - Checkout form
30 - Quote request
31 
322. **Current State**
33 - How many fields?
34 - What's the current completion rate?
35 - Mobile vs. desktop split?
36 - Where do users abandon?
37 
383. **Business Context**
39 - What happens with form submissions?
40 - Which fields are actually used in follow-up?
41 - Are there compliance/legal requirements?
42 
43---
44 
45## Core Principles
46 
47The thresholds that drive every form audit (full treatment in references/form-cro-playbook.md):
48 
49- **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.
50- **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.
51- **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.
52- **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.
53- **CTA**: value-specific button text ("Get my report") outperforms generic ("Submit").
54 
55## Tools
56 
57| Tool | Invocation | Output |
58|---|---|---|
59| 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 |
60 
61Run 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.
62 
63## Output Format
64 
65### Form Audit
66For each issue:
67- **Issue**: What's wrong
68- **Impact**: Estimated effect on conversions
69- **Fix**: Specific recommendation
70- **Priority**: High/Medium/Low
71 
72### Recommended Form Design
73- **Required fields**: Justified list
74- **Optional fields**: With rationale
75- **Field order**: Recommended sequence
76- **Copy**: Labels, placeholders, button
77- **Error messages**: For each field
78- **Layout**: Visual guidance
79 
80### Test Hypotheses
81Ideas to A/B test with expected outcomes
82 
83---
84 
85## Experiment Ideas
86 
87### Form Structure Experiments
88 
89**Layout & Flow**
90- Single-step form vs. multi-step with progress bar
91- 1-column vs. 2-column field layout
92- Form embedded on page vs. separate page
93- Vertical vs. horizontal field alignment
94- Form above fold vs. after content
95 
96**Field Optimization**
97- Reduce to minimum viable fields
98- Add or remove phone number field
99- Add or remove company/organization field
100- Test required vs. optional field balance
101- Use field enrichment to auto-fill known data
102- Hide fields for returning/known visitors
103 
104**Smart Forms**
105- Add real-time validation for emails and phone numbers
106- Progressive profiling (ask more over time)
107- Conditional fields based on earlier answers
108- Auto-suggest for company names
109 
110---
111 
112### Copy & Design Experiments
113 
114**Labels & Microcopy**
115- Test field label clarity and length
116- Placeholder text optimization
117- Help text: show vs. hide vs. on-hover
118- Error message tone (friendly vs. direct)
119 
120**CTAs & Buttons**
121- Button text variations ("Submit" vs. "Get My Quote" vs. specific action)
122- Button color and size testing
123- Button placement relative to fields
124 
125**Trust Elements**
126- Add privacy assurance near form
127- Show trust badges next to submit
128- Add testimonial near form
129- Display expected response time
130 
131---
132 
133### Form Type-Specific Experiments
134 
135**Demo Request Forms**
136- Test with/without phone number requirement
137- Add "preferred contact method" choice
138- Include "What's your biggest challenge?" question
139- Test calendar embed vs. form submission
140 
141**Lead Capture Forms**
142- Email-only vs. email + name
143- Test value proposition messaging above form
144- Gated vs. ungated content strategies
145- Post-submission enrichment questions
146 
147**Contact Forms**
148- Add department/topic routing dropdown
149- Test with/without message field requirement
150- Show alternative contact methods (chat, phone)
151- Expected response time messaging
152 
153---
154 
155### Mobile & UX Experiments
156 
157- Larger touch targets for mobile
158- Test appropriate keyboard types by field
159- Sticky submit button on mobile
160- Auto-focus first field on page load
161- Test form container styling (card vs. minimal)
162 
163---
164 
165## Task-Specific Questions
166 
1671. What's your current form completion rate?
1682. Do you have field-level analytics?
1693. What happens with the data after submission?
1704. Which fields are actually used in follow-up?
1715. Are there compliance/legal requirements?
1726. What's the mobile vs. desktop split?
173 
174---
175 
176## Related Skills
177 
178- **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.
179- **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.
180- **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.
181- **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.
182- **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.
183- **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.
184 
185---
186 
187## Communication
188 
189All form CRO output follows this quality standard:
190- Every field recommendation is justified — never just "remove fields" without explaining which and why
191- Audit output uses the **Issue / Impact / Fix / Priority** structure consistently
192- Multi-step vs. single-step recommendation always includes the qualifying criteria for the choice
193- Mobile optimization is addressed separately from desktop — never conflate the two
194- Submit button copy alternatives are always provided (minimum 3 options with reasoning)
195- Error message rewrites are included when error handling is flagged as an issue
196 
197---
198 
199## Proactive Triggers
200 
201Automatically surface form-cro when:
202 
2031. **"Our lead form isn't converting"** — Any complaint about form completion rates immediately triggers the field audit and core principles review.
2042. **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.
2053. **"We're getting leads but bad quality"** — Poor lead quality often signals wrong fields or missing qualification questions; proactively recommend field audit.
2064. **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.
2075. **Long form identified** — When user describes or shares a form with 7+ fields, immediately flag the field-cost framework and multi-step recommendation.
208 
209---
210 
211## Output Artifacts
212 
213| Artifact | Format | Description |
214|----------|--------|-------------|
215| Form Audit | Issue/Impact/Fix/Priority table | Per-field and per-pattern analysis with actionable fixes |
216| Recommended Field Set | Justified list | Required vs. optional fields with rationale for each |
217| Field Order & Layout Spec | Annotated outline | Recommended sequence, grouping, column layout, and mobile considerations |
218| Submit Button Copy Options | 3-option table | Action-oriented button copy variants with reasoning |
219| A/B Test Hypotheses | Table | Hypothesis × variant × success metric × priority for top 3-5 test ideas |
220 
View all files on GitHub →

Details

Updated
Aug 30, 2026
License
MIT
Stars on the repo
★ 26,349
Checked
Source
alirezarezvani/claude-skills ↗
Creator
alirezarezvani · 363 listings
View creator

Similar skills

See all →
SkillReverse engineer native, managed, Electron/JavaScriptREAmorluto/rea · by morlutoReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.★ 316k GitHub starsSkillBrainstorms ideas into designs before any creative workBrainstorming Ideas Into Designsobra/superpowers · by obraYou MUST use this before any creative work - creating features, building components, adding functionality, or modifying behavior. Explores user intent, requirements and design before implementation.★ 290k GitHub starsSkillRequires technical rigor and verificationCode Review Receptionobra/superpowers · by obraUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation★ 290k GitHub starsSkillDiagnosis loop for hard bugs and performance regressionsDiagnosing bugsmattpocock/skills · by mattpocockDiagnosis loop for hard bugs and performance regressions. Use when the user says "diagnose"/"debug this", or reports something broken/throwing/failing/slow.★ 267k GitHub starsSkillImplement the result of /to-spec and /to-tickets in codeImplement specmattpocock/skills · by mattpocockImplement the result of /to-spec and /to-tickets in code.★ 267k GitHub starsSkillWriting a PR bodymattpocock/skills · by mattpocockUse when writing a PR body.★ 267k GitHub stars

More from alirezarezvani

SkillResume a paused experiment/ar:ar-resume — Resume Experimentalirezarezvani/claude-skills · by alirezarezvaniResume a paused experiment. Checkout the experiment branch, read results history, continue iterating. Use when the user runs /ar:ar-resume or asks to pick up a previously started autoresearch experiment.★ 26.3k GitHub starsSkillShow experiment dashboard with results, active loops/ar:ar-status — Experiment Dashboardalirezarezvani/claude-skills · by alirezarezvaniShow experiment dashboard with results, active loops, and progress. Use when the user runs /ar:ar-status or asks how an autoresearch experiment is going.★ 26.3k GitHub starsSkillStart an autonomous experiment loop with user-selected/ar:loop — Autonomous Experiment Loopalirezarezvani/claude-skills · by alirezarezvaniStart an autonomous experiment loop with user-selected interval (10min, 1h, daily, weekly, monthly). Uses CronCreate for scheduling. Use when the user runs /ar:loop or asks to run an autoresearch experiment continuously on a schedule.★ 26.3k GitHub starsSkillRun a single experiment iteration/ar:run — Single Experiment Iterationalirezarezvani/claude-skills · by alirezarezvaniRun a single experiment iteration. Edit the target file, evaluate, keep or discard. Use when the user runs /ar:run or asks for one manual autoresearch iteration.★ 26.3k GitHub starsSkillSet up a new autoresearch experiment interactively/ar:setup — Create New Experimentalirezarezvani/claude-skills · by alirezarezvaniSet up a new autoresearch experiment interactively. Collects domain, target file, eval command, metric, direction, and evaluator. Use when the user runs /ar:setup or asks to start optimizing a file with the autoresearch loop.★ 26.3k GitHub starsSkill/cs:boardroom <brief/cs:boardroom — Multi-Role Boardroom Deliberationalirezarezvani/claude-skills · by alirezarezvani/cs:boardroom <brief> — 6-phase multi-role deliberation across the C-suite with Phase 2 isolation, critic pre-screen, and synthesis. Outputs a board memo. Use when a decision spans multiple executive domains — e.g. a pricing change touching finance, positioning, and product, or a raise-vs-cut runway call.★ 26.3k GitHub stars