Playwright CLI Skill

The Playwright CLI Skill is an official workflow guide from OpenAI’s curated openai/skills repository. Its direct primary source is https://github.com/openai/skills/tree/main/skills/.curated/playwright. It is intended for coding agents and other compatible harnesses that need to drive a real browser from a terminal. That includes navigation, filling forms, checking page state, capturing screenshots, and investigating user-interface flows. The guide is not a separate web service or a complete test suite. It is a narrowly scoped operating workflow for the Playwright CLI.

Purpose and classification

According to the provider, the skill should be used in a CLI-first way. The agent first opens a target page, takes a current DOM snapshot, and receives stable references for interactive elements. It then performs a concrete action and takes another snapshot after navigation or a substantial interface change. This sequence makes interactions easier to understand because an agent does not blindly rely on stale element numbers or improvised selectors. The workflow therefore fits reproducible journeys through a sign-in mockup or checkout flow, visual review of an application, and investigation of a user-interface defect.

Practical workflow

The official guide recommends the bundled wrapper script so the CLI can run through npx without requiring a global installation. The prerequisite is checking that npx is available. The agent then opens the page, creates a snapshot, uses references from that snapshot for clicks, text entry, or keyboard actions, and captures another snapshot after meaningful changes. A headed browser can help with visual checks. For traceable debugging, the workflow also supports starting and stopping tracing sessions. Multiple tabs are managed with dedicated tab actions, followed by a fresh snapshot after switching tabs.

Boundaries and safety

A reference from an old snapshot can become invalid after navigation. The guide therefore says to avoid bypassing the snapshot workflow with arbitrary code when references are stale and instead capture the page again. Explicit CLI commands are preferred over eval or run-code unless a special need exists. Browser automation can submit forms, open external sites, and expose data on screen. Before an action with side effects, an agent should confirm the target, scope, and authorization. Credentials, tokens, personal data, and confidential screenshots should not be stored in skill files or test artifacts. A browser running locally also does not mean that content remains local to the user; that depends on the selected agent, model, and transport path.

Installation and compatibility

The primary source describes Codex-oriented workflows, so this catalog entry is assigned to the existing Codex compatibility. The skill can also serve as procedural guidance in another harness when that harness can execute the Playwright CLI from a terminal. According to the provider, the openai/skills repository is public and licensed under Apache-2.0. Review the license, CLI version, and available commands at the official source before production use. Skill Road does not sell this skill and does not assert a specific cost; any expense associated with a model, runtime, browser, or external service should be evaluated separately.

Suitable tasks

The skill is most useful when an agent must inspect a real web interface rather than only call HTTP endpoints. Suitable work includes visual regressions, reproducible UI steps, checking form states, and collecting evidence for a defect report. It does not replace domain approvals or security review, and it does not guarantee complete coverage across browsers, devices, or network conditions. Teams should continue to use their established project test workflow for ordinary source-code tests. This description was checked on September 9, 2026 against the official SKILL.md and official OpenAI resources about Codex.