Terminal
Terminal/Skill
Removes cookie banners, consent prompts, modals and paywalls from a web page so screenshots, scraping and automation work.
By Adobe
Works with
npx skills add adobe/skills --skill page-prepDetect and remove overlays (cookie banners, GDPR consent, modals, paywalls,
login walls) before screenshots, scraping, or browser automation.
Uses playwright-cli as the browser layer. Node 22+ required. No npm
dependencies. Run playwright-cli --help for the command reference.
The mode parameter controls dismiss strategy and verification depth.
Default is thorough. Callers can request quick mode in natural language
("use page-prep in quick mode") or the agent infers from context.
| Mode | Dismiss | Verification | Use case |
|---|---|---|---|
thorough (default) | Click-first, hide as fallback | DOM check + viewport screenshot | Persistent sessions, interactive work |
quick | Hide-only (CSS injection) | DOM check only | Ephemeral sessions, repeated evaluations |
if [[ -n "${CLAUDE_SKILL_DIR:-}" ]]; then
PAGE_PREP_DIR="${CLAUDE_SKILL_DIR}/scripts"
else
PAGE_PREP_DIR="$(dirname "$(command -v overlay-db.js 2>/dev/null || \
find ~/.claude -path "*/page-prep/scripts/overlay-db.js" -type f 2>/dev/null | head -1)")"
fi
Store in PAGE_PREP_DIR and prefix all commands below with
node "$PAGE_PREP_DIR/overlay-db.js".
Resolve PAGE_PREP_DIR using the block above. Verify the path is non-empty
before continuing.
node "$PAGE_PREP_DIR/overlay-db.js" refresh
Updates the local overlay database. Skips if cache < 7 days old; use --force to refresh now.
BUNDLE="$(node "$PAGE_PREP_DIR/overlay-db.js" bundle)"
Evaluate $BUNDLE in the active page via playwright-cli eval. Returns a detection report.
playwright-cli eval "$(node "$PAGE_PREP_DIR/overlay-db.js" bundle)"
Parse the detection report. Each overlay has a source field: "cmp-match" or "heuristic".
dismiss recipe. Use it directly.dismiss: null): compose a dismiss sequence — try Escape key,
then close buttons, then element removal (see Agent Fallback).Combine hide and dismiss recipes for all detected overlays into a single
manifest (see Recipe Manifest Format). Include the global scroll_fix if
scroll_locked is true.
Thorough mode (default) — click-first:
dismiss.steps sequentially.
Clicking sets consent cookies that persist across all tabs — overlay
will not reappear.dismiss: null): run the Agent Fallback
sequence (see below).scroll_fix if scroll_locked is true.hide.js rule).Quick mode — hide-only:
hide.js rules in one playwright-cli eval call.scroll_fix if scroll_locked is true.Find remaining position:fixed blockers the script didn't catch:
playwright-cli eval "JSON.stringify([...document.querySelectorAll('*')].filter(el => { var s = getComputedStyle(el); var r = el.getBoundingClientRect(); return s.position === 'fixed' && parseInt(s.zIndex, 10) > 1000 && (el.offsetWidth > 100 || el.offsetHeight > 100) && r.right > 0 && r.bottom > 0 && r.left < window.innerWidth && r.top < window.innerHeight; }).map(el => { var s = getComputedStyle(el); return { tag: el.tagName, id: el.id, cls: (el.className || '').slice(0, 50), z: s.zIndex, w: el.offsetWidth, h: el.offsetHeight }; }))"
This returns position:fixed elements with z-index > 1000, non-trivial
dimensions, and within the visible viewport — off-screen elements (e.g.
slide-in panels in their closed state) are excluded by the getBoundingClientRect()
bounds check. Ignore legitimate elements (navigation bars, toolbars) and
remove the rest:
document.querySelector('<selector>')?.remove().In quick mode, stop here. In thorough mode, continue to Step 9b.
playwright-cli -s <session> screenshot --filename .playwright-cli/page-prep-check.png
Then use the Read tool on .playwright-cli/page-prep-check.png to view it.
Note: --filename must be a path within the project root or .playwright-cli/ —
/tmp/ paths are not allowed. Do not pass the path as a positional argument;
that is interpreted as a CSS selector, not a file path.For multi-step sessions where new overlays may appear (SPAs, lazy-loaded banners), inject the watch mode snippet after cleanup (see Watch Mode).
See references/formats.md for the Detection Report and Recipe Manifest JSON schemas.
When dismiss is null, attempt in order:
[aria-label*="close" i], [aria-label*="dismiss" i], .close,
button:has(svg), button[class*="close"].document.querySelector('<selector>')?.remove().Consult known patterns for CMP-specific dismiss patterns when the above three steps fail.
Inject after cleanup for pages that load overlays dynamically (SPAs, lazy banners). See references/watch-mode.md for the full snippet.
Two modes: hide (default) auto-removes newly detected overlays via MutationObserver;
dismiss queues them in window.__pagePrep.pending() for agent processing.
Call window.__pagePrep.stop() when the session is done.
refresh --force if detection misses a known CMP — the database may be stale.node "$PAGE_PREP_DIR/overlay-db.js" status to check cache age and entry count.node "$PAGE_PREP_DIR/overlay-db.js" lookup <cmp-name> to check if a CMP is in
the database before injecting.