How to use the Popup CRO agent skill (popups)

What is an agent skill and what does the popups skill do?

An agent skill is a folder containing a SKILL.md file with instructions that an agent loads when a request matches the skill's description. The popups skill is the file set from coreyhaines31/marketingskills under skills/popups, released under the MIT licence.

Once installed, the agent works as a popup and modal optimization expert. It starts by checking for product marketing context, then asks about the popup's purpose, current performance, and traffic sources. It then recommends a popup type, trigger, targeting rules, frequency capping, copy and design notes, plus privacy and accessibility points.

The skill provides guidance and copy. It is not a tool that builds or deploys the popup, so you will still need to implement the result on your site.

• Popup types covered: email capture, lead magnet, discount/promotion, exit intent, announcement banner and slide-in
• Trigger options: time-based, scroll-based, exit intent, click-triggered, page count or session-based, and behavior-based
• Frequency and targeting rules, including once-per-session limits and remembering dismissals
• Copy formulas for headlines, subheadlines, CTA buttons and decline options
• Compliance and accessibility checklists, with a note that it is not legal advice

Install the popups skill from the ZIP download

Download the ZIP for the popups skill from our page and unzip it. The skill's files are evals/evals.json and SKILL.md.

For a personal install, unzip the folder into ~/.claude/skills/. To limit the skill to one project, unzip it into that project's .claude/skills/ folder instead.

If you use the Claude apps rather than a local setup, you can upload the skill under Settings → Capabilities → Skills.

• Personal install: ~/.claude/skills/
• Project install: the .claude/skills/ folder inside your project
• Claude apps: Settings → Capabilities → Skills, then upload

How to trigger the popups skill with natural requests

You do not need a special command. The skill's description lists the situations it covers, so the agent loads it when your request is about an overlay or interrupt-style conversion element. Phrases the description names include "exit intent," "email popup," "lead capture popup," "announcement banner," "scroll trigger," "sticky bar" and "notification bar."

Say what you want the popup to do and, if you can, what the page is for. The agent will ask follow-up questions about goal and traffic, so answering them gives a better plan.

For general form or page optimization outside overlays, the skill's description points to the separate cro skill instead.

• "Create an exit-intent popup for my pricing page that offers a demo call."
• "Write an email popup for a weekly newsletter on a blog about home coffee."
• "Design an announcement banner for our spring sale that dismisses and comes back after a week."
• "Suggest a scroll-triggered lead magnet popup for long guides."

What the agent will ask and recommend

Before giving recommendations, the skill asks you to define the popup purpose (for example email capture, discount, announcement or survey), the current state (existing performance, triggers in use, complaints, mobile experience) and the traffic context (sources, new versus returning visitors, and page types where it appears).

Its core principles are timing, clear value and respect for the user: the popup should be easy to dismiss, should not trap or trick, should remember preferences and should not ruin the visit. Trigger advice includes avoiding a 5-second delay and showing a popup after 30-60 seconds for general visitors, with a 25-50% scroll depth typical for long articles.

• Expect a popup design with type, trigger, targeting, frequency, copy (headline, subhead, CTA, decline) and design notes
• Expect mobile advice such as bottom slide-ups instead of full-screen overlays, because exit intent cannot be detected on mobile
• Expect a measurement list of metrics and events to track, such as impression rate, conversion rate, close rate and escape key use

Safety notes: scripts, network and legal limits

The popups skill does not run scripts and does not use the network. It requires nothing beyond the agent itself, according to its listing.

The skill gives general best practices on consent, privacy and accessibility. It is not legal advice. If you need consent or GDPR wording approved, have a qualified legal reviewer check it.

The skill also notes that intrusive interstitials can hurt SEO, especially on mobile, and that cookie notices, age verification and reasonable banners are allowed while full-screen content before the page on mobile should be avoided.

• Runs scripts: no
• Uses network: no
• Requires: nothing listed
• Not legal advice: check consent and privacy wording with a lawyer

Tips for getting useful popup advice

Give the agent real numbers if you have them, such as current conversion, close rate or traffic sources. The skill's benchmarks are described as typical ranges, so treat them as context rather than targets for your site.

Ask for a different offer on exit intent than on entry. The skill recommends acknowledging that the visitor is leaving and addressing a common objection.

Ask for a decline option that is polite. The skill advises against guilt-trip wording and recommends options such as "No thanks" or "Maybe later."

• Include the page type, so the agent can match the offer to context and exclude checkout flows
• Ask for frequency rules, such as showing a popup once per session and remembering dismissals for a set period
• Ask for an accessibility check covering keyboard use, focus trapping, screen reader support and colour contrast