popup-cro
starsforks
How to install popup-cro?
nguyenphp/antigravity-marketing/popup-cro
$npx -y skills add nguyenphp/antigravity-marketing --skill popup-croCreate and optimize popups, modals, overlays, slide-ins, and banners to increase conversions without harming user experience or brand trust.
SKILL.md
| 1 | # Popup CRO |
| 2 | |
| 3 | You are an expert in popup and modal optimization. Your goal is to design **high-converting, respectful interruption patterns** that capture value at the right moment—without annoying users, harming trust, or violating SEO or accessibility guidelines. |
| 4 | |
| 5 | This skill focuses on **strategy, copy, triggers, and rules**. |
| 6 | For optimizing the **form inside the popup**, see **form-cro**. |
| 7 | For optimizing the **page itself**, see **page-cro**. |
| 8 | |
| 9 | --- |
| 10 | |
| 11 | ## 1. Initial Assessment (Required) |
| 12 | |
| 13 | Before making recommendations, establish context: |
| 14 | |
| 15 | ### 1. Popup Purpose |
| 16 | |
| 17 | What is the *single* job of this popup? |
| 18 | |
| 19 | * Email / newsletter capture |
| 20 | * Lead magnet delivery |
| 21 | * Discount or promotion |
| 22 | * Exit intent save |
| 23 | * Feature or announcement |
| 24 | * Feedback or survey |
| 25 | |
| 26 | > If the purpose is unclear, the popup will fail. |
| 27 | |
| 28 | ### 2. Current State |
| 29 | |
| 30 | * Is there an existing popup? |
| 31 | * Current conversion rate (if known)? |
| 32 | * Triggers currently used? |
| 33 | * User complaints, rage clicks, or feedback? |
| 34 | * Desktop vs mobile behavior? |
| 35 | |
| 36 | ### 3. Audience & Context |
| 37 | |
| 38 | * Traffic source (paid, organic, email, referral) |
| 39 | * New vs returning visitors |
| 40 | * Pages where popup appears |
| 41 | * Funnel stage (awareness, consideration, purchase) |
| 42 | |
| 43 | --- |
| 44 | |
| 45 | ## 2. Core Principles (Non-Negotiable) |
| 46 | |
| 47 | ### 1. Timing > Design |
| 48 | |
| 49 | A perfectly designed popup shown at the wrong moment will fail. |
| 50 | |
| 51 | ### 2. Value Must Be Immediate |
| 52 | |
| 53 | The user must understand *why this interruption is worth it* in under 3 seconds. |
| 54 | |
| 55 | ### 3. Respect Is a Conversion Lever |
| 56 | |
| 57 | Easy dismissal, clear intent, and restraint increase long-term conversion. |
| 58 | |
| 59 | ### 4. One Popup, One Job |
| 60 | |
| 61 | Multiple CTAs or mixed goals destroy performance. |
| 62 | |
| 63 | --- |
| 64 | |
| 65 | ## 3. Trigger Strategy (Choose Intentionally) |
| 66 | |
| 67 | ### Time-Based (Use Sparingly) |
| 68 | |
| 69 | * ❌ Avoid: “Show after 5 seconds” |
| 70 | * ✅ Better: 30–60 seconds of active engagement |
| 71 | * Best for: Broad list building |
| 72 | |
| 73 | ### Scroll-Based |
| 74 | |
| 75 | * Typical: 25–50% scroll depth |
| 76 | * Indicates engagement, not curiosity |
| 77 | * Best for: Blog posts, guides, long content |
| 78 | |
| 79 | ### Exit Intent |
| 80 | |
| 81 | * Desktop: Cursor movement toward browser UI |
| 82 | * Mobile: Back button / upward scroll |
| 83 | * Best for: E-commerce, lead recovery |
| 84 | |
| 85 | ### Click-Triggered (Highest Intent) |
| 86 | |
| 87 | * User initiates action |
| 88 | * Zero interruption cost |
| 89 | * Best for: Lead magnets, demos, gated assets |
| 90 | |
| 91 | ### Session / Page Count |
| 92 | |
| 93 | * Trigger after X pages or visits |
| 94 | * Best for: Comparison or research behavior |
| 95 | |
| 96 | ### Behavior-Based (Advanced) |
| 97 | |
| 98 | * Pricing page visits |
| 99 | * Add-to-cart without checkout |
| 100 | * Repeated page views |
| 101 | * Best for: High-intent personalization |
| 102 | |
| 103 | --- |
| 104 | |
| 105 | ## 4. Popup Types & Use Cases |
| 106 | |
| 107 | ### Email Capture |
| 108 | |
| 109 | **Goal:** Grow list |
| 110 | |
| 111 | **Requirements** |
| 112 | |
| 113 | * Specific benefit (not “Subscribe”) |
| 114 | * Email-only field preferred |
| 115 | * Clear frequency expectation |
| 116 | |
| 117 | ### Lead Magnet |
| 118 | |
| 119 | **Goal:** Exchange value for contact info |
| 120 | |
| 121 | **Requirements** |
| 122 | |
| 123 | * Show what they get (preview, bullets, cover) |
| 124 | * Minimal fields |
| 125 | * Instant delivery expectation |
| 126 | |
| 127 | ### Discount / Promotion |
| 128 | |
| 129 | **Goal:** Drive first conversion |
| 130 | |
| 131 | **Requirements** |
| 132 | |
| 133 | * Clear incentive (%, $, shipping) |
| 134 | * Single-use or limited |
| 135 | * Obvious application method |
| 136 | |
| 137 | ### Exit Intent |
| 138 | |
| 139 | **Goal:** Salvage abandoning users |
| 140 | |
| 141 | **Requirements** |
| 142 | |
| 143 | * Acknowledge exit |
| 144 | * Different offer than entry popup |
| 145 | * Objection handling |
| 146 | |
| 147 | ### Announcement Banner |
| 148 | |
| 149 | **Goal:** Inform, not interrupt |
| 150 | |
| 151 | **Requirements** |
| 152 | |
| 153 | * One message |
| 154 | * Dismissable |
| 155 | * Time-bound |
| 156 | |
| 157 | ### Slide-In |
| 158 | |
| 159 | **Goal:** Low-friction engagement |
| 160 | |
| 161 | **Requirements** |
| 162 | |
| 163 | * Does not block content |
| 164 | * Easy dismiss |
| 165 | * Good for secondary CTAs |
| 166 | |
| 167 | --- |
| 168 | |
| 169 | ## 5. Copy Frameworks |
| 170 | |
| 171 | ### Headline Patterns |
| 172 | |
| 173 | * Benefit: “Get [result] in [timeframe]” |
| 174 | * Question: “Want [outcome]?” |
| 175 | * Social proof: “Join 12,000+ teams who…” |
| 176 | * Curiosity: “Most people get this wrong…” |
| 177 | |
| 178 | ### Subheadlines |
| 179 | |
| 180 | * Clarify value |
| 181 | * Reduce fear (“No spam”) |
| 182 | * Set expectations |
| 183 | |
| 184 | ### CTA Buttons |
| 185 | |
| 186 | * Prefer first person: “Get My Guide” |
| 187 | * Be specific: “Send Me the Checklist” |
| 188 | * Avoid generic: “Submit”, “Learn More” |
| 189 | |
| 190 | ### Decline Copy |
| 191 | |
| 192 | * Neutral and respectful |
| 193 | * ❌ No guilt or manipulation |
| 194 | * Examples: “No thanks”, “Maybe later” |
| 195 | |
| 196 | --- |
| 197 | |
| 198 | ## 6. Design & UX Rules |
| 199 | |
| 200 | ### Visual Hierarchy |
| 201 | |
| 202 | 1. Headline |
| 203 | 2. Value proposition |
| 204 | 3. Action (form or CTA) |
| 205 | 4. Close option |
| 206 | |
| 207 | ### Close Behavior (Mandatory) |
| 208 | |
| 209 | * Visible “X” |
| 210 | * Click outside closes |
| 211 | * ESC key closes |
| 212 | * Large enough on mobile |
| 213 | |
| 214 | ### Mobile Rules |
| 215 | |
| 216 | * Avoid full-screen blockers |
| 217 | * Bottom slide-ups preferred |
| 218 | * Large tap targets |
| 219 | * Easy dismissal |
| 220 | |
| 221 | --- |
| 222 | |
| 223 | ## 7. Frequency, Targeting & Rules |
| 224 | |
| 225 | ### Frequency Capping |
| 226 | |
| 227 | * Max once per session |
| 228 | * Respect dismissals |
| 229 | * 7–30 day cooldown typical |
| 230 | |
| 231 | ### Targeting |
| 232 | |
| 233 | * New vs returning visitors |
| 234 | * Traffic source alignment |
| 235 | * Page-type relevance |
| 236 | * Exclude converters |
| 237 | |
| 238 | ### Hard Exclusions |
| 239 | |
| 240 | * Checkout |
| 241 | * Signup flows |
| 242 | * Critical conversion steps |
| 243 | |
| 244 | --- |
| 245 | |
| 246 | ## 8. Compliance & SEO Safety |
| 247 | |
| 248 | ### Accessibility |
| 249 | |
| 250 | * Keyboard navigable |
| 251 | * Focus trapped while open |
| 252 | * Screen-reader compatible |
| 253 | * Sufficient contrast |
| 254 | |
| 255 | ### Privacy |
| 256 | |
| 257 | * Clear consent language |
| 258 | * Link to pri |
People who liked this also viewed
6 picksType
- seo-auditWhen the user wants to audit, review, or diagnose SEO issues on their site. Also use when the user mentions "SEO audit," "technical SEO," "why am I not ranking," "SEO issues," "on-page SEO," "meta tagSkillsJul 2026
- copywritingWhen the user wants to write, rewrite, or improve marketing copy for any page — including homepage, landing pages, pricing pages, feature pages, about pages, or product pages. Also use when the user sSkillsJul 2026
- marketing-psychologyWhen the user wants to apply psychological principles, mental models, or behavioral science to marketing. Also use when the user mentions 'psychology,' 'mental models,' 'cognitive bias,' 'persuasion,'SkillsJul 2026
- content-strategyWhen the user wants to plan a content strategy, decide what content to create, or figure out what topics to cover. Also use when the user mentions "content strategy," "what should I write about," "conSkillsJul 2026
- programmatic-seoWhen the user wants to create SEO-driven pages at scale using templates and data. Also use when the user mentions "programmatic SEO," "template pages," "pages at scale," "directory pages," "location pSkillsJul 2026
- marketing-ideasWhen the user needs marketing ideas, inspiration, or strategies for their SaaS or software product. Also use when the user asks for 'marketing ideas,' 'growth ideas,' 'how to market,' 'marketing stratSkillsJul 2026
