qa-page-scout
Page fingerprint probe — runs ONE browser_evaluate per cell before skill dispatch. Returns 100 boolean flags (hasForms, hasImages, hasTables, etc.) that qa-cell-worker uses to filter out skills whose
SKILL.mdskills/qa-page-scout/SKILL.md
GitHubqa-page-scout — Page Fingerprint
Runs as the FIRST probe on every cell. Returns a compact boolean fingerprint the worker uses to
skip skills whose requires: flags are all absent from this page.
Logic: requires: [flag1, flag2] = run skill if flag1 OR flag2 is true in the fingerprint.
Skills with requires: [] always run regardless.
Probe (browser_evaluate)
() => {
const q = (sel, min) => { try { return document.querySelectorAll(sel).length > (min||0); } catch(e) { return false; } };
const re = (pattern, slice) => { try { return pattern.test((document.body.innerText||'').slice(0,slice||5000)); } catch(e) { return false; } };
const mm = q2 => { try { return window.matchMedia(q2).matches; } catch(e) { return false; } };
const css = slice => { try { return [...document.styleSheets].flatMap(ss => { try { return [...ss.cssRules].map(r => r.cssText); } catch(e) { return []; } }).join('').slice(0,slice||8000); } catch(e) { return ''; } };
return {
// ── FORMS ──────────────────────────────────────────
hasForms: q('form'),
hasInputs: q('input:not([type=hidden]),textarea,select'),
hasPasswordField: q('input[type=password]'),
hasFileUpload: q('input[type=file]'),
hasSearchInput: q('input[type=search],[placeholder*=search i],[class*=search-input]'),
hasRequiredFields: q('[required],[aria-required=true]'),
hasDateTimePicker: q('input[type=date],input[type=time],input[type=datetime-local],[class*=datepicker],[class*=timepicker]'),
hasMultiStepForm: q('[class*=wizard],[class*=stepper],[class*=step-form],[data-step]'),
hasRichTextEditor: q('[contenteditable=true],[class*=quill],[class*=tiptap],[class*=ck-editor],[class*=froala]'),
hasOAuthButtons: q('[class*=social-login],[class*=oauth],[href*=google],[href*=github]'),
hasAutoComplete: q('[list],[class*=autocomplete],[class*=typeahead]'),
hasFormErrors: q('[class*=error-msg],[class*=invalid-feedback],[aria-invalid=true]'),
// ── TABLES / DATA GRID ─────────────────────────────
hasTables: q('table,[role=grid],[role=treegrid]'),
hasSortableColumns: q('[aria-sort],[class*=sortable],[class*=sort-header]'),
hasEditableRows: q('[class*=inline-edit],[data-editable],[class*=row-edit]'),
hasRowSelection: q('[class*=row-select],[class*=select-row]'),
hasFilters: q('[class*=filter-bar],[class*=filter-panel],input[type=search]'),
hasPagination: q('[class*=pagination],[class*=pager],[class*=page-nav]'),
hasInfiniteScroll: q('[data-infinite],[class*=infinite-scroll],[class*=load-more]'),
hasEmptyState: q('[class*=empty-state],[class*=no-data],[class*=no-results]'),
hasBulkActions: q('[class*=bulk-action],[class*=select-all],[class*=mass-action]'),
hasDataGrid: q('[class*=ag-grid],[class*=handsontable],[class*=data-grid]'),
// ── NAVIGATION ─────────────────────────────────────
hasNavigation: q('nav,[role=navigation]'),
hasSidebar: q('[class*=sidebar],[class*=sidenav],[class*=side-menu],[class*=left-nav]'),
hasTopNavbar: q('header nav,[class*=topbar],[class*=navbar],[class*=top-nav]'),
hasBottomTabBar: q('[class*=bottom-nav],[class*=tab-bar],[class*=footer-tabs]'),
hasBreadcrumb: q('[aria-label*=breadcrumb i],[class*=breadcrumb]'),
hasTabs: q('[role=tablist],[role=tab],[class*=tab-nav],[class*=nav-tabs]'),
hasHamburgerMenu: q('[class*=hamburger],[class*=menu-toggle],[class*=burger],[aria-label*=menu i]'),
hasMegaMenu: q('[class*=mega-menu],[class*=nav-dropdown]'),
hasBackButton: q('[class*=btn-back],[aria-label*=go back i],[onclick*=history]'),
hasStepIndicator: q('[class*=step-indicator],[class*=progress-steps],[class*=wizard-steps]'),
// ── MODALS / OVERLAYS / DROPDOWNS ──────────────────
hasModals: q('[role=dialog],[class*=modal-dialog],[class*=modal-content]'),
hasDrawer: q('[class*=drawer],[class*=offcanvas],[class*=slide-panel]'),
hasDropdownMenus: q('[role=listbox],[role=combobox],[class*=dropdown-menu],[class*=select-menu]'),
hasTooltips: q('[role=tooltip],[data-tooltip],[data-bs-toggle=tooltip]'),
hasPopovers: q('[data-bs-toggle=popover],[class*=popover],[class*=flyout]'),
hasToastContainer: q('[class*=toast-container],[class*=snackbar],[class*=notification-stack]'),
hasAlertBanners: q('[role=alert],[class*=alert-banner],[class*=inline-message]'),
hasBottomSheet: q('[class*=bottom-sheet],[class*=action-sheet]'),
hasContextMenu: q('[class*=context-menu],[data-contextmenu]'),
hasOverlayBackdrop: q('[class*=backdrop],[class*=overlay-bg]'),
// ── MEDIA ──────────────────────────────────────────
hasImages: q('img,[role=img]'),
hasLazyImages: q('img[loading=lazy],[data-src],[data-lazy-src]'),
hasSrcsetImages: q('img[srcset],picture source'),
hasAvatars: q('[class*=avatar],[class*=profile-img],[class*=user-photo]'),
hasBrokenImgSrc: q('img[src=""],[img]:not([src])'),
hasVideo: q('video,iframe[src*=youtube],iframe[src*=vimeo],[class*=video-player]'),
hasAudio: q('audio,[class*=audio-player]'),
hasIcons: q('svg use,i[class*=fa-],i[class*=icon-],[class*=material-icons]', 3),
hasInlineBgImages: q('[style*=background-image]'),
hasThirdPartyIframe: q('iframe:not([src*=youtube]):not([src*=vimeo])'),
// ── CHARTS / DATA VIZ ──────────────────────────────
hasCharts: q('canvas,[class*=chart],[class*=recharts],[class*=echarts],[class*=apexcharts],[class*=highcharts]'),
hasProgressBars: q('[role=progressbar],[class*=progress-bar]'),
hasGauges: q('[class*=gauge],[class*=dial],[class*=meter]'),
hasKPICards: q('[class*=stat-card],[class*=kpi],[class*=metric-card]'),
hasMaps: q('[id*=map],[class*=leaflet],[class*=mapbox],[class*=google-map]'),
hasSparklines: q('[class*=sparkline],[class*=mini-chart]'),
// ── CONTENT BLOCKS / WIDGETS ───────────────────────
hasCards: q('[class*=card]:not([class*=card-body]):not([class*=card-header])', 2),
hasCarousel: q('[class*=carousel],[class*=swiper],[class*=slick],[class*=splide]'),
hasAccordion: q('[class*=accordion],[class*=collapse-item],details,summary'),
hasTimeline: q('[class*=timeline],[class*=activity-feed],[class*=audit-log]'),
hasKanban: q('[class*=kanban],[class*=task-board],[class*=sprint-board]'),
hasCalendar: q('[class*=calendar],[class*=fc-],[class*=fullcalendar]'),
hasTreeView: q('[role=tree],[role=treeitem],[class*=treeview],[class*=tree-node]'),
hasDashboardTiles: q('[class*=tile-grid],[class*=app-grid],[class*=widget-grid]'),
// ── INTERACTIVE CONTROLS ───────────────────────────
hasDragDrop: q('[draggable=true],[data-dnd],[class*=drag-handle],[class*=sortable-handle]'),
hasToggleSwitches: q('[role=switch],[class*=toggle-switch]'),
hasRangeSlider: q('input[type=range],[class*=range-slider],[class*=slider-thumb]'),
hasRatingWidget: q('[class*=star-rating],[class*=rating-stars]'),
hasColorPicker: q('input[type=color],[class*=color-picker]'),
hasCheckboxGroup: q('input[type=checkbox]', 2),
hasRadioGroup: q('input[type=radio]', 1),
hasNumberStepper: q('input[type=number],[class*=qty-input],[class*=stepper-input]'),
hasHoverElements: q('[class*=hover-],[data-hover],[class*=hoverable]'),
hasResizable: q('[class*=resizable],[data-resize]'),
// ── LAYOUT PATTERNS ────────────────────────────────
hasStickyHeader: (() => { try { const h = document.querySelector('header,nav'); return !!(h && ['sticky','fixed'].includes(getComputedStyle(h).position)); } catch(e){return false;} })(),
hasStickyElements: q('[class*=sticky],[class*=affix],[class*=fixed-top]'),
hasScrollContainers: q('[class*=scroll-area],[class*=scrollable],[class*=overflow-auto]'),
hasAnimations: q('[class*=animate__],[data-aos],[class*=motion-],[class*=animated]'),
hasTransitions: q('[class*=fade-in],[class*=slide-in],[class*=transition-]'),
hasParallax: q('[data-parallax],[class*=parallax]'),
hasVirtualScroll: q('[class*=virtual-scroll],[class*=cdk-virtual]'),
hasLoadingSpinner: q('[class*=spinner],[class*=loader],[class*=loading-icon]'),
hasSkeletonScreen: q('[class*=skeleton],[class*=shimmer],[class*=placeholder-glow]'),
// ── CRUD / DATA ACTIONS ────────────────────────────
hasAddButton: q('[class*=btn-add],[class*=add-new],[aria-label*=add i],[aria-label*=create i],[title*=add i],[title*=create i],gf-button[title*=add i],gf-button[title*=create i]'),
hasEditButton: q('[class*=btn-edit],[class*=edit-action],[aria-label*=edit i],[title*=edit i],[title*=update i],gf-button[title*=edit i],gf-button[title*=update i],[class*=fa-edit],[class*=fa-pencil]'),
hasDeleteButton: q('[class*=btn-delete],[class*=delete-action],[aria-label*=delete i],[title*=delete i],[title*=remove i],gf-button[title*=delete i],gf-button[title*=remove i],[class*=fa-trash]'),
hasExportOption: re(/export|download csv|export pdf|export report/i),
hasImportOption: re(/import|bulk upload|upload file|upload data/i),
hasPrintOption: q('[onclick*=print],[class*=btn-print],[aria-label*=print i]'),
hasCopyButton: q('[class*=copy-btn],[aria-label*=copy i],[class*=clipboard]'),
hasBatchOperation: q('[class*=batch-action],[class*=bulk-edit],[class*=multi-select-action]'),
// ── AUTH / PERMISSIONS ─────────────────────────────
hasLoginForm: !!(document.querySelector('input[type=password]') && document.querySelector('form')),
hasLogoutOption: re(/log.?out|sign.?out/i, 3000),
hasUserMenu: q('[class*=user-menu],[class*=profile-dropdown],[class*=account-menu]'),
hasRoleIndicator: q('[data-role],[class*=role-badge],[class*=permission-tag]'),
hasRestrictedContent: q('[class*=locked],[class*=restricted],[class*=forbidden]'),
hasTwoFactor: re(/two.factor|2fa|otp|verification code/i),
// ── NOTIFICATIONS / FEEDBACK ───────────────────────
hasToastMessages: q('[class*=toast],[class*=snackbar],[class*=notification-toast]'),
hasInlineAlerts: q('[role=alert],[class*=alert-success],[class*=alert-error],[class*=alert-warning]'),
hasProgressIndicator: q('[class*=step-progress],[class*=wizard-progress]'),
hasNotificationBadge: q('[class*=badge-count],[class*=notification-dot],[class*=unread-badge]'),
hasConfirmDialog: q('[class*=confirm-dialog],[class*=confirm-modal]'),
// ── THEME / I18N / RTL ─────────────────────────────
hasThemeToggle: q('[class*=theme-toggle],[aria-label*=dark mode i],[data-theme-switch]'),
hasDarkModeActive: document.documentElement.classList.contains('dark') || document.documentElement.getAttribute('data-theme') === 'dark' || document.documentElement.getAttribute('data-bs-theme') === 'dark',
hasLanguageSwitcher: q('[class*=lang-switch],[class*=language-select],[aria-label*=language i]'),
hasRTL: document.documentElement.dir === 'rtl' || document.body.dir === 'rtl',
hasI18nAttributes: q('[data-i18n],[data-translate],[i18n]'),
hasCurrencySymbols: re(/[$€£¥₹]/u),
// ── ACCESSIBILITY SIGNALS ──────────────────────────
hasSkipLink: q('[href="#main"],[href="#content"],[class*=skip-nav],[class*=skip-link]'),
hasARIALandmarks: q('[role=main],[role=banner],[role=contentinfo]', 1),
hasLiveRegions: q('[aria-live],[role=status],[role=log]'),
hasImgWithoutAlt: q('img:not([alt]),img[alt=""]'),
hasMissingLabels: q('input:not([aria-label]):not([id]):not([title])'),
hasFocusTrap: q('[class*=focus-trap],[data-focus-trap]'),
// ── TOOLBAR / ACTION BAR ───────────────────────────
hasToolbar: q('[role=toolbar],[class*=toolbar],[class*=action-bar]'),
hasActionButtons: q('[class*=btn-primary],[class*=btn-action],[class*=cta-btn]'),
hasFloatingAction: q('[class*=fab],[class*=floating-btn]'),
hasSplitButton: q('[class*=split-btn],[class*=button-group],[role=group]'),
// ── SEARCH ─────────────────────────────────────────
hasGlobalSearch: q('[role=search],[class*=global-search],[class*=site-search]'),
hasSearchResults: q('[class*=search-results],[class*=search-hits]'),
hasSearchSuggestions: q('[class*=search-suggest],[class*=autocomplete-list]'),
// ── WORKFLOW / MULTI-STEP ──────────────────────────
hasWorkflowProcess: q('[class*=workflow],[class*=pipeline-step],[class*=approval-flow]'),
hasWizardFlow: q('[class*=wizard],[class*=onboarding],[class*=setup-guide]'),
hasApprovalActions: re(/approve|reject|submit for review|pending approval/i),
hasStatusBadges: q('[class*=status-badge],[class*=state-chip],[class*=tag-status]'),
// ── CSS / OS-LEVEL SIGNALS ─────────────────────────
hasCSSVariables: (getComputedStyle(document.documentElement).getPropertyValue('--primary') !== '' || getComputedStyle(document.documentElement).getPropertyValue('--color-primary') !== ''),
hasPrefersColorScheme: mm('(prefers-color-scheme: dark)'),
hasPrefersReducedMotion: mm('(prefers-reduced-motion: reduce)'),
hasForcedColors: mm('(forced-colors: active)'),
hasViewportUnits: /\b(dvh|dvw|svh|svw|lvh|vw|vh|vmin|vmax)\b/.test(css()),
hasNotchSafeArea: /env\(safe-area-inset/i.test(css()),
// ── PERFORMANCE / DOM COMPLEXITY ───────────────────
hasLargeDOM: document.querySelectorAll('*').length > 1500,
hasManyImages: document.querySelectorAll('img').length > 20,
hasManyScripts: document.querySelectorAll('script[src]').length > 15,
hasLazyLoading: q('[loading=lazy],[data-src]'),
hasThirdPartyEmbeds: q('iframe[src*=google],iframe[src*=facebook],[class*=embed-widget]'),
hasManyFonts: q('link[href*=fonts]', 3),
// ── META ───────────────────────────────────────────
pageTitle: document.title,
pageUrl: location.pathname,
domNodeCount: document.querySelectorAll('*').length,
viewportWidth: window.innerWidth,
viewportHeight: window.innerHeight
};
}