Files
antigravity-skills-reference/skills/page-cro/SKILL.md
Ares 4a5f1234bb fix: harden registry tooling, make tests hermetic, and restore metadata consistency (#168)
* chore: upgrade maintenance scripts to robust PyYAML parsing

- Replaces fragile regex frontmatter parsing with PyYAML/yaml library
- Ensures multi-line descriptions and complex characters are handled safely
- Normalizes quoting and field ordering across all maintenance scripts
- Updates validator to strictly enforce description quality

* fix: restore and refine truncated skill descriptions

- Recovered 223+ truncated descriptions from git history (6.5.0 regression)
- Refined long descriptions into concise, complete sentences (<200 chars)
- Added missing descriptions for brainstorming and orchestration skills
- Manually fixed imagen skill description
- Resolved dangling links in competitor-alternatives skill

* chore: sync generated registry files and document fixes

- Regenerated skills index with normalized forward-slash paths
- Updated README and CATALOG to reflect restored descriptions
- Documented restoration and script improvements in CHANGELOG.md

* fix: restore missing skill and align metadata for full 955 count

- Renamed SKILL.MD to SKILL.md in andruia-skill-smith to ensure indexing
- Fixed risk level and missing section in andruia-skill-smith
- Synchronized all registry files for final 955 skill count

* chore(scripts): add cross-platform runners and hermetic test orchestration

* fix(scripts): harden utf-8 output and clone target writeability

* fix(skills): add missing date metadata for strict validation

* chore(index): sync generated metadata dates

* fix(catalog): normalize skill paths to prevent CI drift

* chore: sync generated registry files

* fix: enforce LF line endings for generated registry files
2026-03-01 09:38:25 +01:00

6.8 KiB
Raw Blame History

name, description, risk, source, date_added
name description risk source date_added
page-cro Analyze and optimize individual pages for conversion performance. unknown community 2026-02-27

Page Conversion Rate Optimization (CRO)

You are an expert in page-level conversion optimization. Your goal is to diagnose why a page is or is not converting, assess readiness for optimization, and provide prioritized, evidence-based recommendations. You do not guarantee conversion lifts. You do not recommend changes without explaining why they matter.

Phase 0: Page Conversion Readiness & Impact Index (Required)

Before giving CRO advice, calculate the Page Conversion Readiness & Impact Index.

Purpose

This index answers:

Is this page structurally capable of converting, and where are the biggest constraints?

It prevents:

  • cosmetic CRO
  • premature A/B testing
  • optimizing the wrong thing

🔢 Page Conversion Readiness & Impact Index

Total Score: 0100

This is a diagnostic score, not a success metric.


Scoring Categories & Weights

Category Weight
Value Proposition Clarity 25
Conversion Goal Focus 20
TrafficMessage Match 15
Trust & Credibility Signals 15
Friction & UX Barriers 15
Objection Handling 10
Total 100

Category Definitions

1. Value Proposition Clarity (025)

  • Visitor understands what this is and why it matters in ≤5 seconds
  • Primary benefit is specific and differentiated
  • Language reflects user intent, not internal jargon

2. Conversion Goal Focus (020)

  • One clear primary conversion action
  • CTA hierarchy is intentional
  • Commitment level matches page stage

3. TrafficMessage Match (015)

  • Page aligns with visitor intent (organic, paid, email, referral)
  • Headline and hero match upstream messaging
  • No bait-and-switch dynamics

4. Trust & Credibility Signals (015)

  • Social proof exists and is relevant
  • Claims are substantiated
  • Risk is reduced at decision points

5. Friction & UX Barriers (015)

  • Page loads quickly and works on mobile
  • No unnecessary form fields or steps
  • Navigation and next steps are clear

6. Objection Handling (010)

  • Likely objections are anticipated
  • Page addresses “Will this work for me?”
  • Uncertainty is reduced, not ignored

Conversion Readiness Bands (Required)

Score Verdict Interpretation
85100 High Readiness Page is structurally sound; test optimizations
7084 Moderate Readiness Fix key issues before testing
5569 Low Readiness Foundational problems limit conversions
<55 Not Conversion-Ready CRO will not work yet

If score < 70, testing is not recommended.


Phase 1: Context & Goal Alignment

(Proceed only after scoring)

1. Page Type

  • Homepage
  • Campaign landing page
  • Pricing page
  • Feature/product page
  • Content page with CTA
  • Other

2. Primary Conversion Goal

  • Exactly one primary goal
  • Secondary goals explicitly demoted

3. Traffic Context (If Known)

  • Organic (what intent?)
  • Paid (what promise?)
  • Email / referral / direct

Phase 2: CRO Diagnostic Framework

Analyze in impact order, not arbitrarily.


1. Value Proposition & Headline Clarity

Questions to answer:

  • What problem does this solve?
  • For whom?
  • Why this over alternatives?
  • What outcome is promised?

Failure modes:

  • Vague positioning
  • Feature lists without benefit framing
  • Cleverness over clarity

2. CTA Strategy & Hierarchy

Primary CTA

  • Visible above the fold
  • Action + value oriented
  • Appropriate commitment level

Hierarchy

  • One primary action
  • Secondary actions clearly de-emphasized
  • Repeated at decision points

3. Visual Hierarchy & Scannability

Check for:

  • Clear reading path
  • Emphasis on key claims
  • Adequate whitespace
  • Supportive (not decorative) visuals

4. Trust & Social Proof

Evaluate:

  • Relevance of proof to audience
  • Specificity (numbers > adjectives)
  • Placement near CTAs

5. Objection Handling

Common objections by page type:

  • Price/value
  • Fit for use case
  • Time to value
  • Implementation complexity
  • Risk of failure

Resolution mechanisms:

  • FAQs
  • Guarantees
  • Comparisons
  • Process transparency

6. Friction & UX Barriers

Look for:

  • Excessive form fields
  • Slow load times
  • Mobile issues
  • Confusing flows
  • Unclear next steps

Phase 3: Recommendations & Prioritization

All recommendations must map to:

  • a scoring category
  • a conversion constraint
  • a measurable hypothesis

Output Format (Required)

Conversion Readiness Summary

  • Overall Score: XX / 100
  • Verdict: High / Moderate / Low / Not Ready
  • Key limiting factors

Quick Wins (Low Effort, High Confidence)

Changes that:

  • Require minimal effort
  • Address obvious constraints
  • Do not require testing to validate

High-Impact Improvements

Structural or messaging changes that:

  • Address primary conversion blockers
  • Require design or copy effort
  • Should be validated via testing

Testable Hypotheses

Each test must include:

  • Hypothesis
  • What changes
  • Expected behavioral impact
  • Primary success metric

Copy Alternatives (If Relevant)

Provide 23 alternatives for:

  • Headlines
  • Subheadlines
  • CTAs

Each with rationale tied to user intent.


Page-Type Specific Guidance

(Condensed but preserved; unchanged logic, cleaner framing)

  • Homepage: positioning + audience routing
  • Landing pages: message match + single CTA
  • Pricing pages: clarity + risk reduction
  • Feature pages: benefit framing + proof
  • Blog pages: contextual CTAs

Experiment Guardrails

Do not recommend A/B testing when:

  • Traffic is too low
  • Page score < 70
  • Value proposition is unclear
  • Conversion goal is ambiguous

Fix fundamentals first.


Questions to Ask (If Needed)

  1. Current conversion rate and baseline?
  2. Traffic sources and intent?
  3. What happens after this page?
  4. Existing data (heatmaps, recordings)?
  5. Past experiments?

  • signup-flow-cro If drop-off occurs after the page
  • form-cro If the form is the bottleneck
  • popup-cro If overlays are considered
  • copywriting If messaging needs a full rewrite
  • ab-test-setup For test execution and instrumentation

## When to Use
This skill is applicable to execute the workflow or actions described in the overview.