CRO Optimization
Purpose
Analyze a landing page and deliver a comprehensive CRO audit with specific, actionable recommendations to maximize conversions.
Execution Logic
Check $ARGUMENTS first to determine execution mode:
If $ARGUMENTS is empty or not provided:
Respond with: "cro-optimization loaded, provide your landing page URL or paste your HTML/CSS code"
Then wait for the user to provide their landing page in the next message.
If $ARGUMENTS contains content:
Proceed immediately to Task Execution (skip the "loaded" message).
Task Execution
When landing page is available (either from initial $ARGUMENTS or follow-up message):
1. MANDATORY: Read Reference Files FIRST
BLOCKING REQUIREMENT — DO NOT SKIP THIS STEP
Before doing ANYTHING else, you MUST use the Read tool to read ALL three reference files:
What you will find:
- cro_principles.md: 13 core CRO principles with detection criteria and fix patterns
- landing_page_patterns.md: Real patterns from high-converting pages (ClickUp, Notion, Stripe, Apple, etc.) organized by category
- element_audit_framework.md: Systematic framework for auditing HTML elements, CTAs, forms, and visual hierarchy
DO NOT PROCEED to Step 2 until you have read all files and have the principles, patterns, and audit framework loaded in context.
2. Check for Business Context
Check if FOUNDER_CONTEXT.md exists in the project root.
- If it exists: Read it and use the business context to personalize recommendations (industry, target audience, product type, competitors).
- If it doesn't exist: Proceed with analysis based on page content alone.
3. Fetch and Extract Landing Page
If user provided a URL:
- Use WebFetch to retrieve the landing page content
- Extract and catalog key elements (see Element Extraction below)
If user provided HTML/CSS directly:
- Analyze the provided code directly
- Note any missing context (live styling, images, etc.)
4. Element Extraction
Extract and catalog these elements from the page:
Typography:
- H1 (should be exactly one)
- H2s (section headers)
- Body text samples
- CTA button copy
Visual Structure:
- Above-the-fold content
- Section sequence
- Image/visual placement
- Color scheme and contrast
Conversion Elements:
- Primary CTA (copy, placement, design)
- Secondary CTAs
- Forms (field count, labels)
- Trust signals (logos, testimonials, badges)
- Social proof (metrics, reviews, case studies)
Technical:
- Mobile responsiveness indicators
- Load speed concerns (large images, etc.)
5. Audit Against CRO Principles
For each of the 13 principles in cro_principles.md:
- Check if the page violates the principle
- Note specific violations with evidence
- Determine severity (High/Medium/Low)
- Draft specific recommendations
Prioritize by impact:
- High: Above-fold clarity, CTA effectiveness, major trust gaps
- Medium: Objection handling, visual hierarchy, scannability
- Low: Minor copy tweaks, nice-to-have additions
6. Compare to High-Converting Patterns
Using landing_page_patterns.md:
- Identify the most relevant category (B2B SaaS, E-commerce, etc.)
- Compare page structure to proven patterns
- Note missing elements that top performers include
- Identify opportunities to adopt successful patterns
7. Generate Recommendations
For each issue found, provide:
- What to change — specific element and action
- Why it matters — principle violated and expected impact
- How to implement — concrete example or rewrite
- Priority — High/Medium/Low with reasoning
8. Format and Verify
- Structure output according to Output Format section
- Complete Quality Checklist self-verification
- Ensure recommendations are specific and actionable (not generic advice)
Writing Rules
Hard constraints. No interpretation.
Core Rules
- Every recommendation must be specific and actionable
- Include before/after examples for copy changes
- Reference the specific principle violated
- Prioritize by conversion impact, not ease of implementation
- Frame changes as testable hypotheses when possible
- Never recommend changes without explaining the "why"
Analysis Rules
- Audit systematically — don't skip principles
- Note what's working well, not just problems
- Consider the page's apparent target audience
- Account for likely traffic sources
- Distinguish between critical issues and optimizations
Recommendation Rules
- Lead with highest-impact changes
- Group related recommendations together
- Provide specific copy rewrites, not just "make it clearer"
- Include placement suggestions, not just content suggestions
- Consider mobile experience separately
Output Format
BEFORE: [Current copy/element] AFTER: [Recommended copy/element]
BEFORE: [Current] AFTER: [Recommended]
References
All three files MUST be read using the Read tool before analysis (see Step 1):
Why all three matter: Principles tell you what's wrong. Patterns show you what good looks like. The audit framework ensures you check everything systematically. Together they produce specific, evidence-based recommendations instead of generic CRO advice.
Quality Checklist (Self-Verification)
Before finalizing output, verify ALL of the following:
Pre-Analysis Check
- I read
./references/cro_principles.mdbefore analyzing - I read
./references/landing_page_patterns.mdbefore analyzing - I read
./references/element_audit_framework.mdbefore analyzing - I have all 13 principles, category patterns, and audit criteria in context
Extraction Check
- I identified the H1 and assessed its clarity
- I catalogued all CTAs and their copy
- I noted social proof elements and placement
- I evaluated above-the-fold content
- I assessed the section sequence
Analysis Check
- Each principle was evaluated against the page
- Issues cite specific principles violated
- Recommendations include before/after examples
- Priority is assigned based on conversion impact
- I compared to relevant high-converting patterns
Output Check
- Executive summary captures key findings
- Critical issues are listed first
- Every recommendation is specific and actionable
- Testing roadmap provides clear next steps
- "What's working well" section is included
If ANY check fails → revise before presenting.
Defaults & Assumptions
Use these unless context indicates otherwise:
- Page type: SaaS landing page (most common)
- Traffic temperature: Mixed (cold to warm)
- Primary goal: Signups or demo requests
- Audience: Business decision-makers
- Device split: 60% desktop, 40% mobile
- Conversion definition: Primary CTA click
If the page type is clearly different (e-commerce, content site, etc.), adjust analysis accordingly.
Document any assumptions made in the Executive Summary.

