ghost-qa
Run autonomous headless Playwright browser QA across Desktop, Tablet, and Mobile viewports to catch hydration, layout, overflow, and a11y bugs.
Try your first task
A source-grounded starter task has not been verified for this skill yet.
SKILL.md
name: ghost-qadescription: "Run autonomous headless Playwright browser QA across Desktop, Tablet, and Mobile viewports to catch hydration, layout, overflow, and a11y bugs."category: testingrisk: criticalsource: selfsource_type: selfdate_added: "2026-11-14"author: "@avivgerz-hue"tags: - testing - playwright - qa - browser-automation - accessibility - frontend - e2e - mcpGhost-QA — Autonomous Headless Playwright Browser QA Skill
Overview
ghost-qa is a local headless Playwright browser verification CLI and MCP server that inspects running web applications across Desktop (1440x900), Tablet (768x1024), and Mobile (375x812) viewports. Its 8-Trap Engine detects console exceptions, React/Next.js hydration mismatches, failed network requests (4xx/5xx), dead interactions, horizontal viewport overflow, bounding-box element collisions, accessibility violations, and dark-mode contrast failures.
When to Use This Skill
- Use this skill after building or modifying frontend pages, layouts, or interactive components to verify real browser rendering before deployment.
- Use this skill when diagnosing mobile
375pxoverflow, overlapping sticky headers, or client-side hydration errors. - Do not use this skill against third-party production websites without authorization; run it against local development servers (
http://localhost:3000,http://localhost:5173, etc.).
Prerequisites and side effects
Use an authorized disposable localhost application with test data. The browser can navigate and interact with controls and forms, and the CLI writes reports. Keep production services, credentials, and webhooks disconnected. Review the pinned package and get authorization before installing dependencies or running the browser interactions. Install Chromium separately if required, following the upstream setup guide.
Workflow & Commands
1. Run Autonomous Multi-Viewport Browser QA
npx -y ghost-qa@2.1.2 test http://localhost:3000 --out-dir ghost-qa-out
2. Inspect Findings & Health Score
- Review the generated
0-100QA Health Score, per-viewport trap breakdown, andreport.htmlartifact. - Fix any reported
scrollWidth > clientWidthoverflow, bounding-box overlaps, console errors, or missing ARIA labels.
3. Re-Verify Fix
npx -y ghost-qa@2.1.2 test http://localhost:3000 --out-dir ghost-qa-out
Verification Checklist
- Confirm
ghost-qareports 0 uncaught console/page errors and 0 hydration mismatches. - Confirm Desktop (
1440x900), Tablet (768x1024), and Mobile (375x812) viewports have zero horizontal overflow or overlapping interactive elements.
Examples
For a disposable local dashboard with a mobile overflow report, run the viewport check, inspect the first overflow finding in the HTML report, then rerun after correcting the responsible component.
Limitations
- An automated crawl cannot establish coverage of signed-in flows or accessibility conformance.
- The interaction filter cannot guarantee that a control is harmless. Restrict the run to a disposable fixture even when a button appears safe.
- Browser artifacts may contain application content. Review them before sharing.