Dev & Engineering

playwright-cli Browser Automation Skill

Drives Playwright from the command line so an AI agent can navigate sites, fill forms, capture screenshots, and extract data without you writing browser scripts.

56/ 100
Use with care

Useful, but reliability, evidence or controls still have material gaps.

See how it was scored ↓
Works as-is in
Codex · Claude Code
Stars
★ 11k
Last updated
27d ago
License
MIT
playwrightbrowser-automationweb-testingscreenshots
+3web-scrapinge2e-testingcli

What does this skill do, and when should you use it?

playwright-cli is an Agent Skill bundled in the VoltAgent repository's examples directory that packages browser automation into a directly callable CLI. It works through a snapshot loop: a snapshot returns element refs (like e15), which the agent then uses for clicks, typing, and uploads. Beyond core interaction, it covers multi-tab handling, cookies and web storage, request mocking, console/network inspection, tracing, and video recording. Its frontmatter uses Claude Code's `allowed-tools: Bash(playwright-cli:*)` syntax, so it is a Claude Code-style skill file that needs minor edits to port elsewhere.

Runs the playwright-cli command-line tool: opens browser sessions (choosing chrome/firefox/webkit/msedge or a persistent profile), navigates pages, uses snapshot to obtain element refs, then performs click/type/fill/select/upload/hover/drag actions, captures page or element screenshots, exports PDFs, evaluates JavaScript (eval / run-code), manages tabs, saves and loads cookies/localStorage/sessionStorage, mocks network responses with route, inspects console and network logs, and runs tracing or records WebM video. Seven references/ documents cover request mocking, test generation, session management, and more.

Good fit
  • A frontend developer wants an agent to run end-to-end checks on a local or live web app: open pages, interact, and verify via snapshots and screenshots
  • A QA engineer needs to batch-fill forms, submit them, and capture result screenshots instead of manual regression passes
  • A data analyst extracting information from pages where a saved storage state can restore an authenticated session
  • A debugger investigating frontend issues by reading console errors and network requests, replaying steps under tracing
  • A QA team generating test code or recording operation videos to attach to bug reports

How do you install this skill?

Before you start
Your agent needs
  • Shell / CLI
  • Network access
  • Local filesystem
Install first
  • playwright-cli
  • installable browser via 'playwright-cli install-browser'

The skill lives at examples/with-workspace/workspace/skills/playwright-cli/ in the VoltAgent repo, containing SKILL.md and a references/ folder. Copy that folder into your Agent Skills client's skills directory. SKILL.md mentions playwright-cli install --skills and playwright-cli install-browser, but the source does not document a standalone installation channel for the playwright-cli binary itself — consult its own docs for that.

Generic route: install into Claude Code manually (macOS / Linux)
tmp="$(mktemp -d)"
git clone --depth 1 https://github.com/VoltAgent/voltagent.git "$tmp"
mkdir -p ~/.claude/skills
cp -R "$tmp/examples/with-workspace/workspace/skills/playwright-cli" ~/.claude/skills/
rm -rf "$tmp"

Generated from the source repository and skill path; it copies only this skill's folder. If the author's install steps above differ, follow those first. To scope it to one project, replace ~/.claude/skills with that project's .claude/skills.

How do you use this skill?

Try saying

Once installed, send your agent any of these to trigger it:

  • Open https://example.com, fill in [email protected], submit the form, then take a screenshot.

After installing a browser, trigger it with natural language, e.g.: 'Open https://example.com, fill in [email protected], submit the form, then take a screenshot.' The agent follows the SKILL.md flow: playwright-cli open <url> → snapshot to get refs → fill/click interactions → screenshot → close. Use --browser=chrome to pick a browser and -s=<name> to manage multiple concurrent named sessions.

What are this skill's strengths and limitations?

Pros
  • Extremely broad command coverage: interaction, tabs, storage, network mocking, DevTools, tracing, and video in one tool
  • Snapshot-ref interaction model is LLM-friendly and more stable than coordinates or CSS selectors
  • Named sessions and persistent profiles suit multi-task workflows that need login state
  • Strong documentation with ready-made form, multi-tab, and debugging examples plus seven reference guides
Limitations
  • Frontmatter uses Claude Code's `allowed-tools: Bash(...)` syntax and needs manual adjustment on other platforms
  • Standalone installation of the playwright-cli binary is not fully documented in the source
  • Requires a real browser environment and network access; sandboxed or offline setups cannot run it
  • The repo README describes the whole VoltAgent platform and says nothing about this skill's capabilities — evaluation must rely on SKILL.md alone

How does this skill compare with similar options?

Side by side with related skills; every score comes from the same FSRS standard.

Skill FS score Stars Last updated License
playwright-cli Browser Automation Skill this page 56 · Use with care ★ 11k 27d ago MIT
Playwright Browser Automation Skill 68 · Recommended ★ 3.2k 2mo ago MIT
Web App Testing Skill 49 · Use with care ★ 3.1k 8mo ago MIT
Playwright Browser Automation ✓ Microsoft · Official 46 · Use with care ★ 98k 11d ago Apache-2.0
Playwright Development Guide ✓ Microsoft · Official 45 · Not recommended ★ 98k 11d ago Apache-2.0

The source names no direct competitor. A sponsor blurb in the README claims Ego Lite is 3.45x faster than agent-browser (Vercel), but that is sponsored content about the VoltAgent platform overall and cannot serve as an objective comparison for this skill.

How did FollowSkills review this skill?

FollowSkills review · FSRS-1.0
Use with care
56/ 100 5-point scale 2.8 / 5
1Utility11 / 20 · 2.8/5
2Reliability11 / 20 · 2.8/5
3Safety17 / 25 · 3.4/5

A browser-automation example skill (open browser, click, fill forms, screenshot) — same risk category as other Playwright-family skills (id 758): fundamentally arbitrary browser-interaction capability; here it's a framework example, not an independently published production skill.

4Evidence5 / 15 · 1.7/5
5Usability7 / 10 · 3.5/5
6Maintenance5 / 10 · 2.5/5
1 2 3 4 5 6

Open a dimension to read why it scored that way

Reviewed Jul 17, 2026 Review evidence[1]

Evidence confidence:Low — Mostly static review, author material or a limited demo; useful for discovery, not high-risk decisions.

This review was completed under FSRS 1.0. Dimension scores are not converted; it is queued for re-review under FSRS 2.0.

See the full review method →

FAQ

What runtime environment is required?
A shell-capable environment, an installable browser (via `playwright-cli install-browser`), and network access. It cannot run in browser-less or offline sandboxes.
How is login state handled?
Use `state-save`/`state-load` to export/import auth state, set cookies or storage manually, or run with `--persistent` to keep a durable profile.
Can it run on platforms other than Claude Code?
The body is portable generic CLI documentation, but the `allowed-tools: Bash(playwright-cli:*)` frontmatter is Claude Code permission syntax that must be removed or rewritten when porting.
Does it cost anything?
The code is MIT-licensed (VoltAgent, Copyright © 2026-present), and SKILL.md references no paid services.

More skills from this repository

All from VoltAgent/voltagent

Related skills