Popup Generator
Design and trigger lead-capture popups and modals with engagement-based timing so solo sites capture emails and offers without mobile-intrusive SEO penalties.
Overview
Popup-generator is an agent skill most often used in Validate (also Grow lifecycle, Launch distribution) that designs popup and modal triggers, timing, and offers for lead capture while avoiding intrusive mobile patterns
Install
npx skills add https://github.com/kostja94/marketing-skills --skill popup-generatorWhat is this skill?
- Frames well-timed popups up to ~25% conversion vs harm from load-time and intrusive mobile overlays
- Trigger guidance: scroll 25–50%, time on page, exit intent, click—not immediate page load
- Initial assessment: goal (newsletter, discount, lead magnet, demo), trigger type, mobile constraints
- Reads project-context for offers and audience when `.claude` or `.cursor` project-context exists
- Points to conversion-optimization skill for broader CRO beyond modal design
- Well-designed popups cited up to 25% conversion in SKILL.md
- Preferred engagement triggers include scroll 25–50% and exit intent
Adoption & trust: 740 installs on skills.sh; 586 GitHub stars; 3/3 security scanners passed (skills.sh audits).
What problem does it solve?
You need more signups or demo requests but blast popups on load and risk SEO penalties and angry mobile users.
Who is it for?
Solo builders adding or fixing one primary capture modal on a marketing site with a clear offer and acceptable engagement triggers.
Skip if: Aggressive interstitial stacks on every page view or sites that must stay popup-free for brand or accessibility reasons.
When should I use this skill?
User wants popups, modals, lightboxes, overlays, exit-intent, popup forms, modal design, lead popup, popup timing, or popup triggers.
What do I get? / Deliverables
You leave with trigger, timing, and design constraints matched to goal and mobile context, with a pointer to conversion-optimization when the problem is full-funnel CRO not modal copy alone.
- Trigger and timing recommendations
- Design and value-first messaging constraints
- Mobile and SEO risk notes
Recommended Skills
Journey fit
Spans multiple journey phases - primary shelf plus alternate fits below.
Popups are specified while shaping landing and offer mechanics in validate; they are revisited at grow for lifecycle capture even though the canonical shelf is validate/landing. Landing experiments and lead magnets are where popup goals, triggers, and value-first copy are decided before implementation.
Where it fits
Choose scroll-depth trigger and discount copy for a waitlist modal on the pricing landing page.
Differentiate popup rules for returning visitors versus first-time readers on the blog.
Time a launch-week demo modal after engagement instead of on first paint.
How it compares
Modal timing and offer playbook—not a replacement for full conversion-optimization audits across the whole funnel.
Common Questions / FAQ
Who is popup-generator for?
Indie operators and solo SaaS or content marketers who implement or review lead popups and modals in their own stack.
When should I use popup-generator?
Use in validate when defining landing lead magnets, in grow when tuning lifecycle capture for returning visitors, and at launch when aligning offer modals with a release—when users mention popup, exit-intent, lightbox, or modal triggers.
Is popup-generator safe to install?
It provides copy and UX guidance only; confirm package integrity via the Security Audits panel on this page before running it in automated agent sessions.
SKILL.md
READMESKILL.md - Popup Generator
# Components: Popup / Modal Guides popup and modal design for conversion. Well-designed popups can achieve up to 25% conversion; poorly timed or intrusive ones hurt UX and SEO. Google penalizes intrusive mobile popups. **When invoking**: On **first use**, if helpful, open with 1-2 sentences on what this skill covers and why it matters, then provide the main output. On **subsequent use** or when the user asks to skip, go directly to the main output. ## Initial Assessment **Check for project context first:** If `.claude/project-context.md` or `.cursor/project-context.md` exists, read it for offers and audience. Identify: 1. **Goal**: Newsletter, discount, lead magnet, demo 2. **Trigger**: Time delay, scroll %, exit intent, click 3. **Mobile**: Critical; smaller screens = easier to interrupt ## Best Practices ### Timing and Context - **Avoid**: Popup on page load; users hate it - **Prefer**: After engagement (scroll 25-50%, time on page, exit intent) - **Personalize**: Returning visitors, cart abandoners, discount users - **Value-first**: Offer genuine value; act as "helpful teammate" not spam ### Design - **Short copy**: Clear headline, one benefit, single CTA - **Visual hierarchy**: Guide attention to CTA; don't distract - **Easy exit**: Clear X, visible "No Thanks"; friction-free exit increases trust and conversion - **Brand consistency**: Build instant comfort ### Mobile - **Size**: Fit screen; thumb-friendly close - **Lightweight**: Avoid heavy assets; affects LCP - **SEO**: Google penalizes intrusive interstitials; avoid full-page takeover on mobile ### Avoid - Dark patterns (fake close, hidden options) - Too early or too frequent - Multiple popups in one session - Blocking content without clear value ## Triggers | Trigger | Use | |---------|-----| | **Time delay** | 5-15s typical; after some engagement | | **Scroll %** | 25-50% read; user invested | | **Exit intent** | Mouse leaving viewport; last chance | | **Click** | User-initiated; least intrusive | ## Output Format - **Offer** and copy - **Trigger** (timing, scroll, exit intent) - **Design** (size, CTA, exit) - **Mobile** checklist ## Related Skills - **signup-login-page-generator**: Full account signup → dedicated page preferred; popup for lightweight capture - **landing-page-generator**: Lead capture popups on landing pages; popup as alternative to full-page form - **newsletter-signup-generator**: Popup often contains signup form - **cta-generator**: Popup CTA design - **top-banner-generator**: Alternative to popup; less intrusive for announcements - **sidebar-generator**: Alternative for CTAs; in-content often converts better - **brand-visual-generator**: Popup styling