Popup Cro
Design and tune website popups—triggers, timing, and offers—so solo builders capture leads without wrecking trust or UX.
Overview
popup-cro is an agent skill most often used in Launch—distribution (also Validate—landing, Grow—lifecycle) that guides popup timing, triggers, and respectful UX so solo builders improve on-site conversion without hostile
Install
npx skills add https://github.com/alirezarezvani/claude-skills --skill popup-croWhat is this skill?
- Three core CRO principles: timing, obvious value, and respectful dismiss UX
- Six trigger strategies—time, scroll (25–50% depth), exit intent, click, page-count/session, and behavior-based segments
- Timing guidance: avoid 5-second blasts; favor 30–60 seconds or engagement-based triggers
- Popup-type patterns including email capture with page-context relevance
- Mobile-aware notes (e.g., exit-intent alternatives: back button or scroll-up)
- Six trigger strategy families: time-based, scroll-based, exit intent, click-triggered, page-count/session, and behavior-
- Scroll-based triggers typically use 25–50% scroll depth
- Time-based guidance favors 30–60 seconds of engagement over ~5-second auto-show
Adoption & trust: 518 installs on skills.sh; 17.5k GitHub stars; 3/3 security scanners passed (skills.sh audits).
What problem does it solve?
You added a popup to your site but it fires too early, feels spammy, or misses high-intent moments—so signups stall and visitors bounce.
Who is it for?
Solo builders shipping or iterating a web landing page, blog, or small ecommerce site who want email capture or lead offers tied to scroll, exit, or behavior triggers.
Skip if: Teams with no web surface (API-only, CLI-only), products where modals are banned by platform policy, or flows where the spec is already locked and you only need pixel-perfect CSS with zero CRO changes.
When should I use this skill?
You are designing, reviewing, or implementing website popups and need CRO rules for triggers, timing, popup types, and respectful UX.
What do I get? / Deliverables
You leave with trigger, timing, and value rules aligned to page context and user respect, ready to implement or A/B test popups that match real engagement signals.
- Trigger and timing specification per page type (scroll, exit, click, behavior)
- Popup copy/value checklist mapped to page context
- Dismissal, frequency, and preference-respect UX rules
Recommended Skills
Journey fit
Spans multiple journey phases - primary shelf plus alternate fits below.
On-site popups are a core distribution lever once a product or landing page is live and you need measurable signups or sales from traffic you already earn. Distribution covers converting visitors in-session via modals, exit intent, and click-triggered offers rather than off-channel SEO or app-store ASO alone.
Where it fits
Pick click-triggered gating for a lead magnet on a prototype landing page instead of a 5-second auto popup.
Configure exit-intent capture on pricing after repeat visits signal comparison behavior.
Align scroll-based newsletter offers on long-form content with obvious value and one-click dismiss.
Ensure organic landing traffic sees context-relevant offers at 30–60s engagement rather than immediate interruption.
How it compares
Use for popup strategy and trigger design—not as a generic frontend component library or a full analytics/attribution stack.
Common Questions / FAQ
Who is popup-cro for?
Solo and indie builders who own a marketing site or landing funnel and want agent-guided popup conversion optimization without guessing at timing, triggers, or dismiss patterns.
When should I use popup-cro?
Use it when scoping a validate landing experiment, tuning launch distribution modals (exit intent or scroll-depth offers), or refining grow lifecycle email capture—any time you are choosing when and why a popup should appear.
Is popup-cro safe to install?
Treat it as procedural marketing guidance only; review the Security Audits panel on this Prism page before installing any skill from the catalog and avoid piping untrusted scripts into production without your own review.
SKILL.md
READMESKILL.md - Popup Cro
# popup-cro reference ## Core Principles ### 1. Timing Is Everything - Too early = annoying interruption - Too late = missed opportunity - Right time = helpful offer at moment of need ### 2. Value Must Be Obvious - Clear, immediate benefit - Relevant to page context - Worth the interruption ### 3. Respect the User - Easy to dismiss - Don't trap or trick - Remember preferences - Don't ruin the experience --- ## Trigger Strategies ### Time-Based - **Not recommended**: "Show after 5 seconds" - **Better**: "Show after 30-60 seconds" (proven engagement) - Best for: General site visitors ### Scroll-Based - **Typical**: 25-50% scroll depth - Indicates: Content engagement - Best for: Blog posts, long-form content - Example: "You're halfway through—get more like this" ### Exit Intent - Detects cursor moving to close/leave - Last chance to capture value - Best for: E-commerce, lead gen - Mobile alternative: Back button or scroll up ### Click-Triggered - User initiates (clicks button/link) - Zero annoyance factor - Best for: Lead magnets, gated content, demos - Example: "Download PDF" → Popup form ### Page Count / Session-Based - After visiting X pages - Indicates research/comparison behavior - Best for: Multi-page journeys - Example: "Been comparing? Here's a summary..." ### Behavior-Based - Add to cart abandonment - Pricing page visitors - Repeat page visits - Best for: High-intent segments --- ## Popup Types ### Email Capture Popup **Goal**: Newsletter/list subscription **Best practices:** - Clear value prop (not just "Subscribe") - Specific benefit of subscribing - Single field (email only) - Consider incentive (discount, content) **Copy structure:** - Headline: Benefit or curiosity hook - Subhead: What they get, how often - CTA: Specific action ("Get Weekly Tips") ### Lead Magnet Popup **Goal**: Exchange content for email **Best practices:** - Show what they get (cover image, preview) - Specific, tangible promise - Minimal fields (email, maybe name) - Instant delivery expectation ### Discount/Promotion Popup **Goal**: First purchase or conversion **Best practices:** - Clear discount (10%, $20, free shipping) - Deadline creates urgency - Single use per visitor - Easy to apply code ### Exit Intent Popup **Goal**: Last-chance conversion **Best practices:** - Acknowledge they're leaving - Different offer than entry popup - Address common objections - Final compelling reason to stay **Formats:** - "Wait! Before you go..." - "Forget something?" - "Get 10% off your first order" - "Questions? Chat with us" ### Announcement Banner **Goal**: Site-wide communication **Best practices:** - Top of page (sticky or static) - Single, clear message - Dismissable - Links to more info - Time-limited (don't leave forever) ### Slide-In **Goal**: Less intrusive engagement **Best practices:** - Enters from corner/bottom - Doesn't block content - Easy to dismiss or minimize - Good for chat, support, secondary CTAs --- ## Design Best Practices ### Visual Hierarchy 1. Headline (largest, first seen) 2. Value prop/offer (clear benefit) 3. Form/CTA (obvious action) 4. Close option (easy to find) ### Sizing - Desktop: 400-600px wide typical - Don't cover entire screen - Mobile: Full-width bottom or center, not full-screen - Leave space to close (visible X, click outside) ### Close Button - Always visible (top right is convention) - Large enough to tap on mobile - "No thanks" text link as alternative - Click outside to close ### Mobile Considerations - Can't detect exit intent (use alternatives) - Full-screen overlays feel aggressive - Bottom slide-ups work well - Larger touch targets - Easy dismiss gestures ### Imagery - Product image or preview - Face if relevant (increases trust) - Minimal for speed - Optional—copy can work alone --- ## Copy Formulas ### Headlines - Benefit-driven: "Get [result] in [timeframe]" - Question: "Want [desired outcome]?" - Command: "Don't miss [thing]" - Social proof: "Join [X] people who..." - C