agentleFS
CesarjoquinCesarjoquin/Marketing-Skills/skills/popups/SKILL.md

popups

Skill190 starsChanged 6 months agoMITView on GitHub

When the user wants to create or optimize popups, modals, overlays, slide-ins, or banners for conversion purposes. Also use when the user mentions "exit intent," "popup conversions," "modal optimization," "lead capture popup," "email popup," "announcement banner," "overlay," "collect emails with a popup," "exit popup," "scroll trigger," "sticky bar," or "notification bar." Use this for any overlay or interrupt-style conversion element. For forms outside of popups, see cro. For general page conversion optimization, see cro.

We split this skill into the rules it gives an agent

30 rules. About 0 are common, 29 are distinctive, and 1 is very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈29

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 1

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    If .agents/product-marketing.md exists (or .claude/product-marketing.md, or the legacy product-marketing-context.md filename, in older …

    line 15
  2. Distinctive:

    Before providing recommendations, understand:

    line 17
  3. Distinctive:

    Don't trap or trick

    line 55
  4. Distinctive:

    Don't ruin the experience

    line 57
  5. Distinctive:

    After visiting X pages

    line 87
  6. Distinctive:

    Add to cart abandonment

    line 93
  7. Distinctive:

    Consider incentive (discount, content)

    line 109
  8. Distinctive:

    Don't cover entire screen

    line 180
  9. Distinctive:

    Leave space to close (visible X, click outside)

    line 182
  10. Distinctive:

    Keep visible (top right is convention) — users who can't find the close button will bounce entirely

    line 185
  11. Distinctive:

    Avoid manipulative: "No, I don't want to save money"

    line 227
  12. Distinctive:

    Consider blog vs. product pages

    line 248
  13. Distinctive:

    Don't pre-check opt-ins

    line 258
  14. Distinctive:

    Don't rely on color alone

    line 266
  15. Distinctive:

    Avoid: Full-screen before content on mobile

    line 272
  16. Distinctive:

    Trigger: When it appears

    line 305
  17. Distinctive:

    If recommending multiple popups:

    line 312
  18. Distinctive:

    Test popup sizes on desktop and mobile

    line 363
  19. Distinctive:

    Test visibility without blocking content

    line 365
  20. Distinctive:

    Test optimal time delay (10s vs.

    line 373
  21. Distinctive:

    Test scroll depth percentage (25% vs.

    line 374
  22. Distinctive:

    Test in-content triggers vs.

    line 386
  23. Distinctive:

    Test attention-grabbing vs.

    line 393
  24. Distinctive:

    Test headline length and specificity

    line 396
  25. Distinctive:

    Test decline text (friendly vs.

    line 402
  26. Distinctive:

    Add countdown timers to create urgency

    line 405
  27. Distinctive:

    Test with/without images

    line 406
  28. Distinctive:

    Use progressive profiling (ask more over time)

    line 418
  29. Distinctive:

    Test frequency capping (once per session vs.

    line 430
  30. Distinctive:

    Test different dismiss behaviors

    line 432

≈ “Common” is an estimate: at least 1 in 5 of the 308,232 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Popup CRO

You are an expert in popup and modal optimization. Your goal is to create popups that convert without annoying users or damaging brand perception.

Initial Assessment

Check for product marketing context first: If .agents/product-marketing.md exists (or .claude/product-marketing.md, or the legacy product-marketing-context.md filename, in older setups), read it before asking questions. Use that context and only ask for information not already covered or specific to this task.

Before providing recommendations, understand:

  1. Popup Purpose
    • Email/newsletter capture
    • Lead magnet delivery
    • Discount/promotion
    • Announcement
    • Exit intent save
    • Feature promotion
    • Feedback/survey
  2. Current State
    • Existing popup performance?
    • What triggers are used?
    • User complaints or feedback?
    • Mobile experience?
  3. Traffic Context
    • Traffic sources (paid, organic, direct)
    • New vs. returning visitors
    • Page types where shown

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

  • Keep visible (top right is convention) — users who can't find the close button will bounce entirely
  • 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..."
  • Curiosity: "The one thing [audience] always get wrong about [topic]"

Subheadlines

  • Expand on the promise
  • Address objection ("No spam, ever")
  • Set expectations ("Weekly tips in 5 min")

CTA Buttons

  • First person works: "Get My Discount" vs "Get Your Discount"
  • Specific over generic: "Send Me the Guide" vs "Submit"
  • Value-focused: "Claim My 10% Off" vs "Subscribe"

Decline Options

  • Polite, not guilt-trippy
  • "No thanks" / "Maybe later" / "I'm not interested"
  • Avoid manipulative: "No, I don't want to save money"

Frequency and Rules

Frequency Capping

  • Show maximum once per session
  • Remember dismissals (cookie/localStorage)
  • 7-30 days before showing again
  • Respect user choice

Audience Targeting

  • New vs. returning visitors (different needs)
  • By traffic source (match ad message)
  • By page type (context-relevant)
  • Exclude converted users
  • Exclude recently dismissed

Page Rules

  • Exclude checkout/conversion flows
  • Consider blog vs. product pages
  • Match offer to page context

Compliance and Accessibility

GDPR/Privacy

  • Clear consent language
  • Link to privacy policy
  • Don't pre-check opt-ins
  • Honor unsubscribe/preferences

Accessibility

  • Keyboard navigable (Tab, Enter, Esc)
  • Focus trap while open
  • Screen reader compatible
  • Sufficient color contrast
  • Don't rely on color alone

Google Guidelines

  • Intrusive interstitials hurt SEO
  • Mobile especially sensitive
  • Allow: Cookie notices, age verification, reasonable banners
  • Avoid: Full-screen before content on mobile

Measurement

Key Metrics

  • Impression rate: Visitors who see popup
  • Conversion rate: Impressions → Submissions
  • Close rate: How many dismiss immediately
  • Engagement rate: Interaction before close
  • Time to close: How long before dismissing

What to Track

  • Popup views
  • Form focus
  • Submission attempts
  • Successful submissions
  • Close button clicks
  • Outside clicks
  • Escape key

Benchmarks

  • Email popup: 2-5% conversion typical
  • Exit intent: 3-10% conversion
  • Click-triggered: Higher (10%+, self-selected)

Output Format

Popup Design

  • Type: Email capture, lead magnet, etc.
  • Trigger: When it appears
  • Targeting: Who sees it
  • Frequency: How often shown
  • Copy: Headline, subhead, CTA, decline
  • Design notes: Layout, imagery, mobile

Multiple Popup Strategy

If recommending multiple popups:

  • Popup 1: [Purpose, trigger, audience]
  • Popup 2: [Purpose, trigger, audience]
  • Conflict rules: How they don't overlap

Test Hypotheses

Ideas to A/B test with expected outcomes


Common Popup Strategies

E-commerce

  1. Entry/scroll: First-purchase discount
  2. Exit intent: Bigger discount or reminder
  3. Cart abandonment: Complete your order

B2B SaaS

  1. Click-triggered: Demo request, lead magnets
  2. Scroll: Newsletter/blog subscription
  3. Exit intent: Trial reminder or content offer

Content/Media

  1. Scroll-based: Newsletter after engagement
  2. Page count: Subscribe after multiple visits
  3. Exit intent: Don't miss future content

Lead Generation

  1. Time-delayed: General list building
  2. Click-triggered: Specific lead magnets
  3. Exit intent: Final capture attempt

Experiment Ideas

Placement & Format Experiments

Banner Variations

  • Top bar vs. banner below header
  • Sticky banner vs. static banner
  • Full-width vs. contained banner
  • Banner with countdown timer vs. without

Popup Formats

  • Center modal vs. slide-in from corner
  • Full-screen overlay vs. smaller modal
  • Bottom bar vs. corner popup
  • Top announcements vs. bottom slideouts

Position Testing

  • Test popup sizes on desktop and mobile
  • Left corner vs. right corner for slide-ins
  • Test visibility without blocking content

Trigger Experiments

Timing Triggers

  • Exit intent vs. 30-second delay vs. 50% scroll depth
  • Test optimal time delay (10s vs. 30s vs. 60s)
  • Test scroll depth percentage (25% vs. 50% vs. 75%)
  • Page count trigger (show after X pages viewed)

Behavior Triggers

  • Show based on user intent prediction
  • Trigger based on specific page visits
  • Return visitor vs. new visitor targeting
  • Show based on referral source

Click Triggers

  • Click-triggered popups for lead magnets
  • Button-triggered vs. link-triggered modals
  • Test in-content triggers vs. sidebar triggers

Messaging & Content Experiments

Headlines & Copy

  • Test attention-grabbing vs. informational headlines
  • "Limited-time offer" vs. "New feature alert" messaging
  • Urgency-focused copy vs. value-focused copy
  • Test headline length and specificity

CTAs

  • CTA button text variations
  • Button color testing for contrast
  • Primary + secondary CTA vs. single CTA
  • Test decline text (friendly vs. neutral)

Visual Content

  • Add countdown timers to create urgency
  • Test with/without images
  • Product preview vs. generic imagery
  • Include social proof in popup

Personalization Experiments

Dynamic Content

  • Personalize popup based on visitor data
  • Show industry-specific content
  • Tailor content based on pages visited
  • Use progressive profiling (ask more over time)

Audience Targeting

  • New vs. returning visitor messaging
  • Segment by traffic source
  • Target based on engagement level
  • Exclude already-converted visitors

Frequency & Rules Experiments

  • Test frequency capping (once per session vs. once per week)
  • Cool-down period after dismissal
  • Test different dismiss behaviors
  • Show escalating offers over multiple visits

Task-Specific Questions

  1. What's the primary goal for this popup?
  2. What's your current popup performance (if any)?
  3. What traffic sources are you optimizing for?
  4. What incentive can you offer?
  5. Are there compliance requirements (GDPR, etc.)?
  6. Mobile vs. desktop traffic split?

Related Skills

  • lead-magnets: For planning lead magnets to promote via popups
  • cro: For optimizing the form inside the popup
  • cro: For the page context around popups
  • emails: For what happens after popup conversion
  • ab-testing: For testing popup variations

Download now (ZIP)

Trending

Steady: 0 new projects took it in the last 4 weeks, none the 4 weeks before.thin data

Week of Aug 30: 0 new projectsWeek of Sep 6: 0 new projectsWeek of Sep 13: 0 new projectsWeek of Sep 20: 0 new projectsWeek of Sep 27: 0 new projectsWeek of Oct 4: 0 new projectsWeek of Oct 11: 0 new projectsWeek of Oct 18: 0 new projects
Aug 2026Sep 2026Oct 2026
New projects taking a version of this file each week, over the 8 weeks our latest run read: only 0 in all, so this is a hint, not a trend.
  • Other versions22 projects use a version of this.

    Word for word · 19

    1. coreyhaines31/marketingskills★ 56k100% same
    2. open-fox/agents★ 55100% same
    3. SZcalligrapher/slash-skills-subscription★ 32100% same
    4. TommyBez/skillsboard★ 8100% same
    5. anis-dr/skills★ 3100% same
    6. agrivisionai/claude-skills★ 1100% same
    7. ngothanhtung/claude-code-skills★ 1100% same
    8. patinaproject/skills★ 1100% same
    9. productionx-in/Core-Skills★ 1100% same
    10. xeroc/skills★ 1100% same

    9 more not listed

    Edited · 1

    1. Gopyr/gopyr-skills-hub★ 079% same

    Wrote their own version · 2

    1. scayver/marketing-skills★ 8same name
    2. david-corroy/skills-marketing-fr★ 1same name

    How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.

  • Used alongsideProjects with it also use marketing-council, marketing-loops and 10 more.

    Other files people use alongside this one.

    Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
    • coreyhaines31Skill

      marketing-council

      When the user wants multiple expert perspectives on a marketing question — a simulated board of advisors staffed by legendary marketers (Seth Godin, David Ogilvy, Eugene Schwartz, April Dunford, Rory Sutherland, Alex Hormozi, Byron Sharp, and more). Also use when the user mentions 'marketing council,' 'board of advisors,' 'advisory board,' 'what would Seth Godin say,' 'what would Ogilvy think,' 'channel Hormozi,' 'get multiple perspectives,' 'debate this,' 'have the council review,' 'marketing mentors,' or asks how a famous marketer would approach their problem. The council gives each advisor's take through their documented frameworks, surfaces where they disagree, and synthesizes a recommendation. For executing the winning direction, hand off to positioning, offers, copywriting, ads, or the relevant skill.

      Also in 16 projects that use this

    • coreyhaines31Skill

      marketing-loops

      When the user wants to set up a recurring, self-running marketing workflow — a repeatable loop an AI agent runs on a cadence (weekly, daily, on a trigger) rather than a one-off task. Also use when the user mentions 'marketing loop,' 'recurring marketing workflow,' 'automate my marketing,' 'marketing on autopilot,' 'weekly marketing review,' 'ad fatigue check,' 'weekly ads check,' 'content refresh loop,' 'churn watch,' 'ranking drop alert,' 'run my SEO,' 'SEO operator,' 'daily SEO agent,' 'run my outbound,' 'AI SDR,' 'reply triage,' 'always-on marketing,' 'marketing automation workflow,' or 'run this every week.' Use this to pick, adapt, and schedule an ongoing marketing loop that orchestrates the other marketing skills. For one-off marketing ideas, see marketing-ideas. For the experimentation loop specifically, see ab-testing.

      Also in 6 projects that use this

    • agenkinSkill

      events

      Schema discovery — list every event name firing for the current TelemetryDeck app with 7-day and 30-day counts side by side.

      Also in 4 projects that use this

    • aiunlocked1412Skill

      influencer-marketing

      Influencer marketing AI — brief, pitch, rate evaluation, performance review แบบ data-driven

      Also in 3 projects that use this

    • riggyzSkill

      attribution

      Attribution rules for issues, pull requests, work items, reviews, and comments created or edited by the agent in GitHub, Linear, Azure DevOps, or similar collaboration systems. Use when creating, commenting on, reviewing, or modifying external tracker content.

      Also in 3 projects that use this

    • VercelSkill

      remotion-best-practices

      Best practices for Remotion - Video creation in React

      Also in 6 projects that use this

  • In this repository46 other files it gives its agents.

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

Reviews can't be read right now.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.