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

344 lines
6.8 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
---
name: page-cro
description: Analyze and optimize individual pages for conversion performance.
risk: unknown
source: community
date_added: '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?
---
## Related Skills
* **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.