kai-cro

Conversion rate optimization audit — analyze a landing page, signup flow, or checkout funnel using the 5-layer CRO stack (technical performance, traffic quality, offer/pricing, design/layout, copy/mes

SKILL.md

GitHub

Kai root note: knowledge/, harness/, and scripts/ paths in this skill live in the Kai install, not the user's project. Resolve them against the first ancestor directory of this SKILL.md that contains a knowledge/ folder (the Kai plugin root, ~/.claude/kai, or the kai-cmo-harness repo). MARKETING.md, memory/, and any output files live in the current project. If a referenced scripts/ command is not available in this install, say so, skip it, and continue with the file-based guidance — never fabricate its output.

Run a CRO audit using the 5-layer optimization stack. Produces a prioritized fix list.

Phase 0: Load Product Context

Check if MARKETING.md exists in the project root (same directory as CLAUDE.md, README.md, package.json).

If it exists: Read it — skip product discovery questions. It has the product name, ICP, value prop, monetization, brand voice, current channels, and competitive landscape.

If it does NOT exist: Auto-explore the codebase to create it in the project root (next to CLAUDE.md). Do NOT ask the user what the product is. Read CLAUDE.md, README.md, PROJECT.md, package.json, landing pages, and any project files. Search for email/ad/analytics config. Then create MARKETING.md using the template from /kai-email-system. Present draft to user for confirmation.


Phase 1: Page/Funnel Input

Read from MARKETING.md. Only ask about things not covered there:

  1. URL(s) — what page or flow are we auditing?
  2. Current conversion rate — if known
  3. Conversion goal — signup, purchase, demo request, download?
  4. Traffic source — where do visitors come from? (affects awareness level)
  5. Known friction points — anything they've already identified?

Phase 2: Audit Execution

Load these before starting:

  • knowledge/playbooks/conversion-rate-optimization.md
  • knowledge/playbooks/funnel-hack-offer-architecture.md
  • knowledge/checklists/cro-audit-checklist.md
  • knowledge/checklists/landing-page-messaging-checklist.md

Competitor Funnel-Hack Step (required for ecommerce/CRO)

Before recommending product-page, pricing, checkout, or subscription changes:

  1. Identify scaled competitors or adjacent ecommerce brands with active paid spend.
  2. Inspect Meta Ads Library, Google ads, TikTok Shop, Amazon, or other visible demand sources where available.
  3. Save source URLs, screenshots, or archived notes for each inspected funnel.
  4. Build an offer/pricing matrix: path, price, billing model, quantity, default status, bonuses, retention hook, risk reversal.
  5. Extract conversion mechanics separately from visual taste.
  6. Turn each mechanic into a concrete A/B test recommendation.

If source evidence, checkout access, pricing, or ad visibility is missing, list it in the audit data gaps. Do not replace it with guesses.

5-Layer CRO Stack (audit bottom-up)

Layer 1: Technical Performance (fix first)

  • Page load time (target: < 2 seconds)
  • Mobile responsiveness
  • Broken elements, JS errors
  • Form functionality
  • Payment flow reliability

Layer 2: Traffic & Audience Quality

  • Is the right audience arriving? (message-market match)
  • Ad → landing page consistency (scent trail)
  • Awareness level match (cold traffic needs more education than warm)

Layer 3: Offer & Pricing

  • Is the offer clear in 5 seconds?
  • Value prop vs price — is it a no-brainer?
  • Risk reversal (guarantee, free trial, money-back)
  • Urgency — any reason to act now?
  • For ecommerce/subscription: what winning competitor mechanics should be tested?
  • Does the audit include an offer/pricing matrix from sourced competitor funnels?
  • Are subscription defaults, one-time anchors, bonus stacks, retention hooks, upsells, and risk reversal separated from visual taste?

Layer 4: Design & Layout

  • Visual hierarchy — does the eye flow to the CTA?
  • CTA visibility and contrast
  • Above-the-fold content — does it sell or just describe?
  • Social proof placement
  • Form length (minimize fields)
  • Distractions — anything pulling attention from the goal?

Layer 5: Copy & Messaging (highest leverage)

  • Headline — does it state the outcome, not the product?
  • Specificity — numbers, examples, named results?
  • Objection handling — are the top 3 concerns addressed?
  • CTA copy — action verb + outcome ("Start saving time" not "Submit")
  • Proof — is every claim supported?

Layer 6: Lead Capture Method (often overlooked — massive impact for service businesses)

  • Is the business receiving phone calls? If yes → phone capture must be evaluated under the Phone Capture Fit Rule
  • Are calls going to voicemail during business hours? (owner on job, in meetings, etc.)
  • What happens to after-hours calls?
  • Phone vs form capture — which converts higher for this business type?
  • For local/service businesses: phone capture converts 5-10x higher than form submissions
  • Recommendation (when fit signals are present): a phone answering service or AI receptionist that answers every call 24/7, captures caller details, qualifies leads, and books appointments. Compare options (staffed reception, answering services, AI receptionists, VoIP/IVR, CRM routing, callback widgets) and name no vendor by default.
  • Configure the chosen service with: business services, pricing, service areas, qualifying questions, scheduling integration

Use the browse/gstack skill to actually view and screenshot the page if available.

Deterministic Checks And Provenance

Run repeatable CRO checks before subjective recommendations:

  • Verify page availability, status code, mobile viewport, primary CTA presence, form or checkout path, required fields, broken buttons, console errors, consent banner behavior, and analytics event firing when tools are available.
  • Record source metadata for every observed issue: URL, viewport, device, timestamp, screenshot or artifact path, tool, and confidence.
  • Separate observed facts from hypotheses. Example: "CTA hidden below first mobile viewport" is observed; "visitors do not trust the offer" is a hypothesis unless backed by research or user data.
  • Use missing_data for unavailable conversion rate, traffic mix, heatmaps, recordings, checkout access, A/B test history, or analytics events.
  • Do not include unsourced conversion rates, revenue impact, uplift percentages, or benchmark claims in the score or fix table.

Phase 3: Scoring

Score each layer 1-10:

Layer Score Key Issue Fix
Technical /10 [main issue] [specific fix]
Traffic /10
Offer /10
Design /10
Copy /10
Overall /50

Phase 4: Prioritized Fixes

Priority Fix Layer Expected Impact Effort
P0 [fix] [layer] High Low
P1 [fix] [layer] High Medium
P2 [fix] [layer] Medium Medium

Phase 5: Output

Save to workspace/cro-audit/[page-slug].md.

Include:

  • Overall health score (/50)
  • Layer-by-layer analysis
  • Competitor funnel-hack sources (URLs, screenshots, or archived notes)
  • Offer/pricing matrix
  • Extracted conversion mechanics, not generic competitor inspiration
  • Prioritized fix list
  • Before/after copy suggestions for the top 3 copy fixes
  • A/B test recommendations (what to test first)