Agent skill

Playwright CLI

by flonat in flonat/flonat-research

Automate browser interactions and inspect or test web pages through Playwright commands.

MITAuto-check passedTesting & QA

Install Playwright CLI

skills CLI
$ npx skills add flonat/flonat-research --skill playwright-cli -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install flonat/flonat-research playwright-cli --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/flonat/flonat-research.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/playwright-cli .claude/skills/playwright-cli && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
playwright-cli
GitHub stars
146
Token cost
~1.4k tokens
SKILL.md length
208 words
Files
11 (incl. references)
Skills in repo
83
Repo updated
First seen
Licence
MIT

At a glance

Automate browser interactions and inspect or test web pages through Playwright commands.

  • The task requires deterministic browser navigation
  • SKILL.md covers Quick start, Commands, Snapshots and Targeting elements, plus 6 more sections
  • Calls npx and npm; reaches playwright.dev
  • Playwright-test work

What it does

Playwright CLI is an agent skill from flonat/flonat-research. Automate browser interactions and inspect or test web pages through Playwright commands. Use when the task requires deterministic browser navigation, screenshots, selectors, or Playwright-test work. For a full local-webapp test workflow, use $webapp-testing.

Its SKILL.md is about 1.4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 11 other files, including reference files (for example `references/commands.md`, `references/element-attributes.md` and `references/playwright-tests.md`).

It sits in Testing & QA, covering Browser testing and Browser automation. It works with Playwright. The repository describes itself as: Shareable Claude Code + Codex infrastructure for PhD researchers — skills, agents, hooks, and rules for academic workflows. The licence is MIT.

When your agent uses it

  • The task requires deterministic browser navigation
  • Playwright-test work

Example prompts

  • “/playwright-cli”

Requirements

  • Python 3
  • Node.js
  • Pre-approved tools (allowed-tools): Bash(playwright-cli:*), Bash(npx:*), Bash(npm:*)

What it can do on your machine

Read from SKILL.md and the folder at commit da27600. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Bash(playwright-cli:*)
    • Bash(npx:*)
    • Bash(npm:*)

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • npx
    • npm

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • playwright.dev

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Playwright CLI loads about 1.4k tokens when it runs, and up to ~10k if it reads all its reference files. Until then it costs about 68 tokens; SKILL.md has 208 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~68
When it runs · the whole SKILL.md, loaded when a task matches
~1.4k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~10k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from flonat/flonat-research at commit da27600, republished under its MIT licence (© flonat). 208 words, ~1,359 tokens.

Download SKILL.mdSave it as .claude/skills/playwright-cli/SKILL.md (or your agent's skills folder). This skill also uses 10 other files; get the full folder from GitHub.
name
playwright-cli
description
Automate browser interactions and inspect or test web pages through Playwright commands. Use when the task requires deterministic browser navigation, screenshots, selectors, or Playwright-test work. For a full local-webapp test workflow, use $webapp-testing.
allowed-tools
Bash(playwright-cli:*), Bash(npx:*), Bash(npm:*)
skill-dependencies
webapp-testing

Browser Automation with playwright-cli

Use this skill for ad-hoc browser navigation, inspection, and interaction using CLI snapshots. When a local application needs managed server startup, custom Python assertions, or a repeatable Python test script, use $webapp-testing.

Quick start

bash
# open new browser
playwright-cli open
# navigate to a page
playwright-cli goto https://playwright.dev
# interact with the page using refs from the snapshot
playwright-cli click e15
playwright-cli type "page.click"
playwright-cli press Enter
# take a screenshot (rarely used, as snapshot is more common)
playwright-cli screenshot
# close the browser
playwright-cli close

Commands

See references/commands.md for the complete catalogue of all commands organized by category: Core, Navigation, Keyboard, Mouse, Save as, Tabs, Storage (Cookies/LocalStorage/SessionStorage), Network, DevTools, Open Parameters, Browser Sessions, and Raw Output Mode.

Snapshots

After each command, playwright-cli provides a snapshot of the current browser state.

bash
> playwright-cli goto https://example.com
### Page
- Page URL: https://example.com/
- Page Title: Example Domain
### Snapshot
[Snapshot](.playwright-cli/page-2026-02-14T19-22-42-679Z.yml)

You can also take a snapshot on demand using playwright-cli snapshot command. All the options below can be combined as needed.

bash
# default - save to a file with timestamp-based name
playwright-cli snapshot

# save to file, use when snapshot is a part of the workflow result
playwright-cli snapshot --filename=after-click.yaml

# snapshot an element instead of the whole page
playwright-cli snapshot "#main"

# limit snapshot depth for efficiency, take a partial snapshot afterwards
playwright-cli snapshot --depth=4
playwright-cli snapshot e34

Targeting elements

By default, use refs from the snapshot to interact with page elements.

bash
# get snapshot with refs
playwright-cli snapshot

# interact using a ref
playwright-cli click e15

You can also use css selectors or Playwright locators.

bash
# css selector
playwright-cli click "#main > button.submit"

# role locator
playwright-cli click "getByRole('button', { name: 'Submit' })"

# test id
playwright-cli click "getByTestId('submit-button')"

Browser Sessions

bash
# create new browser session named "mysession" with persistent profile
playwright-cli -s=mysession open example.com --persistent
# same with manually specified profile directory (use when requested explicitly)
playwright-cli -s=mysession open example.com --profile=/path/to/profile
playwright-cli -s=mysession click e6
playwright-cli -s=mysession close  # stop a named browser
playwright-cli -s=mysession delete-data  # delete user data for persistent session

playwright-cli list
# Close all browsers
playwright-cli close-all
# Forcefully kill all browser processes
playwright-cli kill-all

Installation

If global playwright-cli command is not available, try a local version via npx playwright-cli:

bash
npx --no-install playwright-cli --version

When local version is available, use npx playwright-cli in all commands. Otherwise, install playwright-cli as a global command:

bash
npm install -g @playwright/cli@latest

Example: Form submission

bash
playwright-cli open https://example.com/form
playwright-cli snapshot

playwright-cli fill e1 "user@example.com"
playwright-cli fill e2 "password123"
playwright-cli click e3
playwright-cli snapshot
playwright-cli close

Example: Multi-tab workflow

bash
playwright-cli open https://example.com
playwright-cli tab-new https://example.com/other
playwright-cli tab-list
playwright-cli tab-select 0
playwright-cli snapshot
playwright-cli close

Example: Debugging with DevTools

bash
playwright-cli open https://example.com
playwright-cli click e4
playwright-cli fill e7 "test"
playwright-cli console
playwright-cli network
playwright-cli close
bash
playwright-cli open https://example.com
playwright-cli tracing-start
playwright-cli click e4
playwright-cli fill e7 "test"
playwright-cli tracing-stop
playwright-cli close

Specific tasks

© flonat, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 10 other files (references) in skills/playwright-cli of flonat/flonat-research.

  • SKILL.md
  • references/commands.md
  • references/element-attributes.md
  • references/playwright-tests.md
  • references/request-mocking.md
  • references/running-code.md
  • references/session-management.md
  • references/storage-state.md
  • references/test-generation.md
  • references/tracing.md
  • references/video-recording.md

Open the folder on GitHubat commit da27600

Compare with similar skills

Playwright CLI next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Playwright CLI compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Playwright CLI this skillflonat/flonat-research146—~1.4kAutomated safety check: PassMIT
playwright-cli Browser Automationgithub/gh-aw5.4k23 repos~2.8kAutomated safety check: PassMIT
Playwright Skilllackeyjb/playwright-skill3.2k—~1.9kAutomated safety check: PassMIT
Playwright CLItestdino-hq/playwright-skill3901 repos~2.5kAutomated safety check: PassMIT
Playwright Bot Bypassgreekr4/playwright-bot-bypass201—~3.4kAutomated safety check: PassMIT
UI Previewtingly-dev/tingly-box351—~2kAutomated safety check: NotesMPL-2.0

Similar skills

  • Official

    Drives a real browser from the command line with playwright-cli to open pages, interact, mock requests, save state and work with Playwright tests.

    5.4k GitHub starsUsed in 23 repos~2.8k tokens
    Testing & QAAuto-check passed
  • Playwright Skill

    lackeyjb/playwright-skill

    Complete browser automation with Playwright. An agent skill from lackeyjb/playwright-skill.

    3.2k GitHub stars~1.9k tokensUpdated 9 days ago
    Testing & QAAuto-check passed
  • Playwright CLI

    testdino-hq/playwright-skill

    Automates browser interactions for testing and validating your own web applications using playwright-cli.

    390 GitHub starsUsed in 1 repo~2.5k tokens
    Testing & QAAuto-check passed
  • Playwright Bot Bypass

    greekr4/playwright-bot-bypass

    This skill should be used when the user asks to "bypass bot detection", "avoid CAPTCHA", "stealth browser automation", "undetected playwright", "bypass Google bot check", "rebrowser-playwright", or…

    201 GitHub stars~3.4k tokensUpdated 1 mo ago
    Testing & QAAuto-check passed
  • UI Preview

    tingly-dev/tingly-box

    Capture headless-Chrome screenshots of the tingly-box frontend (running locally in mock mode) so frontend changes can be visually verified in environments without a real browser.

    351 GitHub stars~2k tokensUpdated today
    Testing & QAAuto-check: notes
  • Open Browser

    JasonHonKL/Openbrowser

    A skill your agent uses whenever the task involves browsing web pages, extracting page content, clicking forms, or completing web workflows.

    114 GitHub stars~1.6k tokensUpdated 5 mo ago
    Testing & QAAuto-check passed

More from flonat/flonat-research

All 83 skills in this repo
  • Latex Posters

    flonat/flonat-research

    Create a large-format academic poster in LaTeX using beamerposter, tikzposter, or baposter.

    146 GitHub stars~1.5k tokensUpdated 10 days ago
    Auto-check: notes
  • Skill Creator

    flonat/flonat-research

    Create, revise, and evaluate reusable AI workflow skills, including trigger-quality tests.

    146 GitHub stars~4.4k tokensUpdated 10 days ago
    Auto-check passed
  • DOCX

    flonat/flonat-research

    Create, read, edit, or convert Microsoft Word documents while preserving professional document structure.

    146 GitHub stars~1.2k tokensUpdated 10 days ago
    Auto-check passed
  • PDF

    flonat/flonat-research

    Read, create, combine, split, rotate, OCR, watermark, secure, or extract content from PDF files.

    146 GitHub stars~488 tokensUpdated 10 days ago
    Auto-check passed
  • Init Project Orchestration

    flonat/flonat-research

    Create or migrate project-level agents, repeatable project workflows, and planning state from one client-neutral contract, then render repository-scoped adapters for both Claude Code and Codex.

    146 GitHub stars~1.6k tokensUpdated 10 days ago
    Auto-check passed
  • Pre Commit Audit

    flonat/flonat-research

    Deliver a fast pre-commit safety scan: file size, anonymity (author / affiliation strings in tex/bib), hardcoded secrets, and invisible-Unicode carriers.

    146 GitHub stars~2.8k tokensUpdated 10 days ago
    Auto-check: notes

Works with

Categories

Questions about Playwright CLI

What does Playwright CLI do?

Automate browser interactions and inspect or test web pages through Playwright commands. Playwright CLI is an agent skill from flonat/flonat-research. Automate browser interactions and inspect or test web pages through Playwright commands.

When should I use Playwright CLI?

Playwright CLI fits situations like: the task requires deterministic browser navigation; playwright-test work.

How do I install Playwright CLI in Claude Code?

Run `npx skills add flonat/flonat-research --skill playwright-cli -a claude-code`. Or copy the skill folder (skills/playwright-cli in flonat/flonat-research) into .claude/skills/playwright-cli in your project. Claude Code loads it when a task matches its description.

How do I install Playwright CLI in Codex?

Run `npx skills add flonat/flonat-research --skill playwright-cli -a codex`. Or copy the skill folder (skills/playwright-cli in flonat/flonat-research) into .agents/skills/playwright-cli in your project. Codex loads it when a task matches its description.

Can I use Playwright CLI in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add flonat/flonat-research --skill playwright-cli -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/playwright-cli, .gemini/skills/playwright-cli, .github/skills/playwright-cli and .opencode/skills/playwright-cli in your project.

What does Playwright CLI need to run?

Going by SKILL.md and its folder, Playwright CLI needs the command-line tools its instructions call (npx and npm). Our summary lists: Python 3; Node.js. Its frontmatter pre-approves these tools: Bash(playwright-cli:*), Bash(npx:*), Bash(npm:*).

Does Playwright CLI access the network?

SKILL.md names 1 domain. In commands or code: playwright.dev; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Playwright CLI safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Playwright CLI use?

Playwright CLI is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Playwright CLI use?

About 1.4k tokens (SKILL.md is roughly 5.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 8.9k tokens, read only when the agent opens those files.

What are the alternatives to Playwright CLI?

Skills that share tags, products or a category with Playwright CLI: playwright-cli Browser Automation (github/gh-aw, 5.4k stars), Playwright Skill (lackeyjb/playwright-skill, 3.2k stars), Playwright CLI (testdino-hq/playwright-skill, 390 stars) and Playwright Bot Bypass (greekr4/playwright-bot-bypass, 201 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Playwright CLI?

flonat (a GitHub user) maintains it in flonat/flonat-research, which has 146 GitHub stars. The repository holds 83 skills in this directory. The repository was last updated on September 29, 2026.

Source: flonat/flonat-research on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.