← All skills
browser-driver
80 / 100 · Low risk
Fine to try.
By MhmdElGazzar/agentex (GitHub) · writing · 21 stars · scanned at commit a6bb627
The browser driver for test-execution runs. It drives a real browser through playwright-cli for unprefixed (prose) spec steps and covers isolated sessions, screenshot and console evidence, login modes, and the failure signatures that decide retry versus defect. Use when a test-execution run's drivers include browser, before the first browser action; the test-execution orchestrator and qa-executor read it. Not a standalone entry point.
Works with any agent that supports SKILL.md skills.
What this skill can do
Downloads and installs other software
The author does not mention this.
Found in 19 places.
Show 16 more
- skills/browser-driver/references/experience/gotchas.md, line 28
- `npx playwright-cli` exiting non-zero with a driver error rather than a test result, or `snapshot` returning no page. - skills/browser-driver/references/techniques/browser-checks.md, line 4
- **Evidence:** `screenshot` on every PASSED and FAILED scenario, e.g. `npx playwright-cli -s=<session> screenshot --filename=<SESSION_DIR>/screenshots/s1-home. - skills/browser-driver/references/techniques/browser-checks.md, line 5
- **Console:** `npx playwright-cli -s=<session> console error > <SESSION_DIR>/logs/s1-console.log`. Errors are defects even when the UI looks fine. - skills/browser-driver/references/techniques/browser-checks.md, line 8
- Everything since the page loaded: act with the plain command, then `npx playwright-cli -s=<s> requests --filter "/api/orders" > <SESSION_DIR>/logs/s1-network. - skills/browser-driver/references/techniques/browser-checks.md, line 10
`npx playwright-cli -s=<s> run-code "async (page) => { const r=[]; page.on('request',q=>r.push(q.method()+' '+q.url())); await page.getByRole('button', { name: - skills/browser-driver/references/techniques/browser-checks.md, line 13
- **Viewport** (ui-check steps): `npx playwright-cli -s=<s> resize 1440 900`. Only where `--help resize` shows no such command, use `run-code "async (page) => { - skills/browser-driver/references/tools/fill-secret.md, line 64
npx playwright-cli -s=run-ab12 snapshot # refs BEFORE any secret is on the page - skills/browser-driver/references/tools/fill-secret.md, line 65
npx playwright-cli -s=run-ab12 fill e3 "qa.tester@example.com" # non-secret fields first - skills/browser-driver/references/tools/fill-secret.md, line 69
npx playwright-cli -s=run-ab12 snapshot # the next page; safe again - skills/browser-driver/references/tools/playwright-cli.md, line 6
- The CLI is the npm package **`@playwright/cli`**. Invoke it as `npx playwright-cli <command>` (a local devDependency, not global). - skills/browser-driver/references/tools/playwright-cli.md, line 7
- Trust the `preflight.js` verdict for it: the probe judges by output, not exit code alone (see `../experience/gotchas.md`). If it reports `ok: false`: `npm ins - skills/browser-driver/references/tools/playwright-cli.md, line 8
- `preflight.js` also reports **`playwright`**: the npm library, a different thing from this CLI. A run does not need it: this CLI loads and saves a `storageSta - skills/browser-driver/references/tools/playwright-cli.md, line 9
- Headed (demos, watching): add `--headed`, e.g. `npx playwright-cli open <url> --headed`. Parallel and regression runs are headless. - skills/browser-driver/references/tools/playwright-cli.md, line 14
2. **A plain command first.** If a command in the shape table below does it, use that command. Not sure of its shape? Run `npx playwright-cli --help <command>` - skills/browser-driver/references/tools/playwright-cli.md, line 44
**Options that do not exist (an `Unknown option` error):** `--ref`, `--r`, `--e`, `--element`, `--target`, any per-command `--timeout`, and a positional screens - skills/browser-driver/references/tools/playwright-cli.md, line 48
1. First usage error on this step: run `npx playwright-cli --help <command>` (or `--help` for the list), or reread the run-code contract, and correct the call o
Runs commands on your computer
The author does not mention this.
Found in 12 places.
Show 9 more
- skills/browser-driver/scripts/fill_secret.test.js, line 120
const r = spawnSync(process.execPath, [SCRIPT, ...args], { cwd, env, encoding: 'utf8', timeout: 30000 }); - skills/browser-driver/scripts/fill_secret.test.js, line 229
const driver = `const { spawn } = require('node:child_process'); - skills/browser-driver/scripts/fill_secret.test.js, line 233
const r = spawnSync(process.execPath, ['-e', driver], { env, encoding: 'utf8', timeout: 20000 }); - skills/browser-driver/scripts/login_state.js, line 48
const { spawnSync } = require('node:child_process'); - skills/browser-driver/scripts/login_state.js, line 126
const r = spawnSync(cmd, args, { - skills/browser-driver/scripts/login_state.js, line 229
const r = spawnSync('git', ['check-ignore', '-q', '--', rel], { cwd, stdio: 'ignore', windowsHide: true }); - skills/browser-driver/scripts/login_state.test.js, line 15
const { spawnSync } = require('node:child_process'); - skills/browser-driver/scripts/login_state.test.js, line 71
if (git) spawnSync('git', ['init', '-q'], { cwd: dir }); - skills/browser-driver/scripts/login_state.test.js, line 93
const r = spawnSync(process.execPath, [SCRIPT, ...args], { cwd, env, encoding: 'utf8', timeout: 30000 });
Install
Paste this into your terminal. It downloads exactly the version we scanned, not whatever is newest.
if [ -e ~/.agents/skills/'browser-driver' ] || [ -L ~/.agents/skills/'browser-driver' ]; then echo 'A skill folder named browser-driver already exists — not replacing it' >&2; false; else d=$(mktemp -d) && git clone --quiet --filter=blob:none --no-checkout 'https://github.com/MhmdElGazzar/agentex' "$d" && git -C "$d" checkout --quiet 'a6bb627c3c59340d7b708f93787ff8355b0e6c2d' -- 'skills/browser-driver' && mkdir -p ~/.agents/skills && cp -R "$d"/'skills/browser-driver' ~/.agents/skills/'browser-driver' && rm -rf "$d"; fi
Codex reads ~/.agents/skills directly. For Claude Code, Cursor, Copilot, Gemini CLI, Antigravity or OpenCode, also link it. For Claude Code: ln -s ~/.agents/skills/'browser-driver' ~/.claude/skills/'browser-driver' (other agents: ~/.cursor/skills, ~/.copilot/skills, ~/.gemini/skills, ~/.gemini/config/skills, ~/.config/opencode/skills). Or install through the finder skill, which does both.
Badge for your README
The badge for MhmdElGazzar/agentex shows the score of its lowest-scoring skill.
[](https://zalavijaysinh.github.io/skilltrust/repos/MhmdElGazzar/agentex/)
Score history
| Date | Version | Score |
|---|
| 2026-11-10 | a6bb627 | 80 |