browserstack
Run tests on BrowserStack. Use when user mentions "browserstack", "cross-browser", "cloud testing", "browser matrix", "test on safari", "test on firefox", or "browser compatibility".
Security Assessment
About browserstack
The BrowserStack skill integrates Playwright test suites with BrowserStack's cloud browser grid so tests can run across real browser and operating-system combinations instead of only locally. It addresses the common cross-browser compatibility problem: verifying that an application behaves correctly on Chrome, Firefox, and WebKit/Safari across Windows and macOS without maintaining that device matrix yourself.
The skill provides a set of sub-commands. Setup edits `playwright.config.ts` to add BrowserStack `connectOptions` (a `wss://cdp.browserstack.com` websocket endpoint) gated on the presence of credentials, plus an npm script for cloud runs. Other commands run the suite against selected browser projects, fetch build and session results (status, browser/OS, duration, video and log URLs), list available Playwright-compatible browsers, and configure a BrowserStack Local tunnel for testing localhost or firewalled staging environments. It reads credentials from the `BROWSERSTACK_USERNAME` and `BROWSERSTACK_ACCESS_KEY` environment variables, and if they are unset it directs the user to the account settings page and stops. A companion set of MCP tools (get_plan, get_browsers, get_builds, get_sessions, get_session, update_session, get_logs) drives result retrieval and session marking.
It targets QA engineers and frontend developers who already use Playwright and want cross-browser cloud coverage, per-browser pass/fail reporting, and links to BrowserStack video and screenshots for debugging failures.
FAQ
What testing framework does this work with?
Playwright. It configures Playwright projects to connect to BrowserStack's cloud grid via a CDP websocket endpoint.
What credentials are required?
The `BROWSERSTACK_USERNAME` and `BROWSERSTACK_ACCESS_KEY` environment variables. If they are missing, the skill points you to browserstack.com account settings and stops rather than proceeding.
Which browsers can I test?
Playwright-compatible combinations such as Chrome, Firefox, and WebKit on Windows and macOS; the `browsers` command lists what your plan supports.
Can I test a local or firewalled environment?
Yes. The local command installs `browserstack-local` and sets up a tunnel so localhost or staging behind a firewall can be reached by the cloud grid.
How do I see results and debugging artifacts?
The results command pulls the latest build's sessions and reports per-session status, browser/OS, duration, and links to BrowserStack video and log URLs.
Install browserstack
Quick Setup:
- Copy the skill folder to
.claude/skills/ - Claude will automatically detect and use the skill
Repository
alirezarezvani/claude-skills