Agent skill

Playwright MCP Skill

by holon-run in holon-run/uxc

Run browser automation through @playwright/mcp over UXC stdio MCP, with daemon-friendly session reuse and safe action guardrails.

MITAuto-check passedTesting & QA

Install Playwright MCP Skill

skills CLI
$ npx skills add holon-run/uxc --skill playwright-mcp-skill -a claude-code

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

GitHub CLI
$ gh skill install holon-run/uxc playwright-mcp-skill --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/holon-run/uxc.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/playwright-mcp-skill .claude/skills/playwright-mcp-skill && 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-mcp-skill
GitHub stars
116
Token cost
~1.1k tokens
SKILL.md length
449 words
Files
4 (incl. scripts, references)
Skills in repo
62
Repo updated
First seen
Licence
MIT

At a glance

Run browser automation through @playwright/mcp over UXC stdio MCP, with daemon-friendly session reuse and safe action guardrails.

  • Works in 6 steps: Verify protocol/path from official… → Detect auth requirement explicitly → Use fixed link command by default → …
  • Tasks need deterministic page navigation
  • SKILL.md covers Prerequisites, Core Workflow…, Guardrails and References
  • Runs Shell scripts from its folder; calls npx; reaches github.com

What it does

Playwright MCP Skill is an agent skill from holon-run/uxc. Run browser automation through @playwright/mcp over UXC stdio MCP, with daemon-friendly session reuse and safe action guardrails. Use when tasks need deterministic page navigation, DOM snapshots, and scripted browser interaction from CLI.

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 6 other files, including scripts and reference files (for example `agents/openai.yaml`, `references/usage-patterns.md` and `scripts/validate.sh`).

It sits in Testing & QA, covering Browser testing, MCP servers and Browser automation. It works with Model Context Protocol and Playwright. The repository describes itself as: A unified CLI for discovering and invoking tools across OpenAPI, MCP, GraphQL, gRPC, and JSON-RPC. The licence is MIT.

When your agent uses it

  • Tasks need deterministic page navigation
  • Scripted browser interaction from CLI

Example prompts

  • “/playwright-mcp-skill”

Requirements

  • Node.js
  • A Bash shell

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

  1. Verify protocol/path from official source and probe
  2. Detect auth requirement explicitly
  3. Use fixed link command by default
  4. Inspect operation schema before execution
  5. Prefer read-first interaction
  6. Execute actions with explicit confirmation when impact is high

What it can do on your machine

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

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (Shell), which the agent can run.

    Shell commands in SKILL.md call:

    • npx

    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:

    • github.com

    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 MCP Skill loads about 1.1k tokens when it runs, and up to ~1.6k if it reads all its reference files. Until then it costs about 65 tokens; SKILL.md has 449 words of instructions outside code blocks.

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

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); the scripts in this folder are not scanned.

SKILL.md

The full file from holon-run/uxc at commit 562d47c, republished under its MIT licence (© holon-run). 449 words, ~1,082 tokens.

Download SKILL.mdSave it as .claude/skills/playwright-mcp-skill/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
playwright-mcp-skill
description
Run browser automation through @playwright/mcp over UXC stdio MCP, with daemon-friendly session reuse and safe action guardrails. Use when tasks need deterministic page navigation, DOM snapshots, and scripted browser interaction from CLI.

Playwright MCP Skill

Use this skill to run Playwright MCP operations through uxc using fixed stdio endpoints.

Reuse the uxc skill for generic protocol discovery, auth/error handling, and envelope parsing rules.

Prerequisites

  • uxc is installed and available in PATH.
  • npx is available in PATH (Node.js installed).
  • Network access for first-time @playwright/mcp package fetch.
  • Browser runtime can start locally (headless mode is default in this skill).

Core Workflow (Playwright-Specific)

Endpoint candidate inputs before finalizing:

  • Raw package form from docs: npx @playwright/mcp@latest
  • Reliable non-interactive form: npx -y @playwright/mcp@latest
  • Isolated/headless stable form (default for this skill):
    • npx -y @playwright/mcp@latest --headless --isolated
    • Shared-profile headless form (for persistent login state):
    • npx -y @playwright/mcp@latest --headless --user-data-dir ~/.uxc/playwright-profile
    • Shared-profile headed form (for interactive debug with same login state):
    • npx -y @playwright/mcp@latest --user-data-dir ~/.uxc/playwright-profile
  1. Verify protocol/path from official source and probe:
    • Official source: https://github.com/microsoft/playwright-mcp
    • probe candidate endpoints with:
      • uxc "npx -y @playwright/mcp@latest --headless --isolated" -h
    • Confirm protocol is MCP stdio (protocol == "mcp" in envelope).
  2. Detect auth requirement explicitly:
    • Run host help or a minimal read call and inspect envelope.
    • @playwright/mcp default flow is no OAuth/API key for local stdio use.
  3. Use fixed link command by default:
    • command -v playwright-mcp-cli
    • If missing, create it:
      • uxc link playwright-mcp-cli "npx -y @playwright/mcp@latest --headless --isolated"
    • Optional shared-profile dual command setup for persistent sessions:
      • command -v playwright-mcp-headless
      • command -v playwright-mcp-ui
      • uxc link --daemon-exclusive ~/.uxc/playwright-profile playwright-mcp-headless "npx -y @playwright/mcp@latest --headless --user-data-dir ~/.uxc/playwright-profile"
      • uxc link --daemon-exclusive ~/.uxc/playwright-profile playwright-mcp-ui "npx -y @playwright/mcp@latest --user-data-dir ~/.uxc/playwright-profile"
    • playwright-mcp-cli -h
    • If command conflict is detected and cannot be safely reused, stop and ask skill maintainers to pick another fixed command name.
  4. Inspect operation schema before execution:
    • playwright-mcp-cli browser_navigate -h
    • playwright-mcp-cli browser_snapshot -h
    • playwright-mcp-cli browser_click -h
  5. Prefer read-first interaction:
    • Start with navigation/snapshot before mutating page state.
  6. Execute actions with explicit confirmation when impact is high:
    • Confirm before form submission, checkout, delete/destructive actions, or irreversible multi-step flows.
Show full SKILL.md (138 more words)Show less

Guardrails

  • Keep automation on JSON output envelope; do not rely on --text.
  • Parse stable fields first: ok, kind, protocol, data, error.
  • Use playwright-mcp-cli as default command path.
  • playwright-mcp-cli <operation> ... is equivalent to uxc "npx -y @playwright/mcp@latest --headless --isolated" <operation> ....
  • Use direct uxc "<endpoint>" ... only as temporary fallback when link setup is unavailable.
  • If browser profile conflict appears, keep --isolated in endpoint and retry via the same fixed link command.
  • When using shared --user-data-dir, run headless/headed links serially (not concurrently).
  • To enable seamless switching between headed UI login and headless CLI automation using the same profile directory, set a daemon exclusive key:
    • Prefer link-level setup (recommended above), or set UXC_DAEMON_EXCLUSIVE=~/.uxc/playwright-profile for ad-hoc runs.
    • If the profile is still busy (another session is actively running), fallback: uxc daemon stop
  • Prefer browser_snapshot over screenshots for model-action loops.

References

  • Invocation patterns:
    • references/usage-patterns.md

© holon-run, 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 3 other files (scripts, references) in skills/playwright-mcp-skill of holon-run/uxc.

  • SKILL.md
  • agents/openai.yaml
  • references/usage-patterns.md
  • scripts/validate.sh

Open the folder on GitHubat commit 562d47c

Compare with similar skills

Playwright MCP Skill 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 MCP Skill compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Playwright MCP Skill this skillholon-run/uxc116—~1.1kAutomated safety check: PassMIT
Playwright MCP Browser ControlHainrixz/editor-pro-max264—~2kAutomated safety check: PassCustom licence
Playwright E2E Testingactivepieces/activepieces25k—~6.8kAutomated safety check: PassCustom licence
Playwright MCPCraftOS-dev/CraftBot3921 repos~1kAutomated safety check: PassMIT
Lightpandalightpanda-io/agent-skill101—~6kAutomated safety check: PassApache-2.0
Browser UseQwenLM/qwen-code-examples143—~451Automated safety check: PassNone

Similar skills

  • Playwright MCP Browser Control

    Hainrixz/editor-pro-max

    Drives a live browser through the Playwright MCP server to navigate, inspect, fill forms and screenshot pages, with snapshot-first habits and output-size care.

    264 GitHub stars~2k tokensUpdated 6 mo ago
    Testing & QAAuto-check passed
  • Playwright E2E Testing

    activepieces/activepieces

    Playwright modern end-to-end testing framework with cross-browser automation, auto-wait, and built-in test runner

    25k GitHub stars~6.8k tokensUpdated today
    Testing & QAAuto-check passed
  • Playwright MCP

    CraftOS-dev/CraftBot

    Browser automation via Playwright MCP server. An agent skill from CraftOS-dev/CraftBot.

    392 GitHub starsUsed in 1 repo~1k tokens
    Testing & QAAuto-check passed
  • Lightpanda

    lightpanda-io/agent-skill

    Lightpanda browser, drop-in replacement for Chrome-based browsing in any AI agent - faster and lighter for tasks without graphical rendering like data retrieval.

    101 GitHub stars~6k tokensUpdated 3 days ago
    Agent WorkflowsAuto-check passed
  • Browser Use

    QwenLM/qwen-code-examples

    Control browser pages using the Playwright MCP server. An agent skill from QwenLM/qwen-code-examples.

    143 GitHub stars~451 tokensUpdated 4 mo ago
    Productivity & AutomationAuto-check passed
  • Project Docs Maintainer

    swimmwatch/cloakbrowser-mcp

    Maintain, organize, consolidate, or audit the cloakbrowser-mcp documentation set only when the user explicitly requests project documentation maintenance or an authorized public change requires it.

    164 GitHub stars~569 tokensUpdated yesterday
    DevelopmentAuto-check passed

More from holon-run/uxc

All 62 skills in this repo
  • Context7 MCP Skill

    holon-run/uxc

    Query up-to-date library documentation and code examples using Context7 MCP.

    116 GitHub stars~564 tokensUpdated 24 days ago
    Auto-check passed
  • Deepwiki MCP Skill

    holon-run/uxc

    Ask questions and read documentation about any GitHub repository using DeepWiki MCP.

    116 GitHub stars~700 tokensUpdated 24 days ago
    Auto-check passed
  • Operate Linear workspace issues, projects, and teams through Linear GraphQL API using UXC.

    116 GitHub stars~1.8k tokensUpdated 24 days ago
    Auto-check passed
  • Operate Notion Public API through UXC with a curated OpenAPI schema for search, block traversal, page reads, content writes, and data source/database inspection.

    116 GitHub stars~2.3k tokensUpdated 24 days ago
    Auto-check passed
  • Operate Alchemy Prices API reads through UXC with a curated OpenAPI schema, path-templated API-key auth, and read-first guardrails.

    116 GitHub starsUsed in 1 repo~1k tokens
    Auto-check passed
  • Uxc

    holon-run/uxc

    Discover and call remote schema-exposed interfaces with UXC.

    116 GitHub stars~1.8k tokensUpdated 24 days ago
    Auto-check passed

Categories

Questions about Playwright MCP Skill

What does Playwright MCP Skill do?

Run browser automation through @playwright/mcp over UXC stdio MCP, with daemon-friendly session reuse and safe action guardrails. Playwright MCP Skill is an agent skill from holon-run/uxc. Run browser automation through @playwright/mcp over UXC stdio MCP, with daemon-friendly session reuse and safe action guardrails.

When should I use Playwright MCP Skill?

Playwright MCP Skill fits situations like: tasks need deterministic page navigation; scripted browser interaction from CLI.

How do I install Playwright MCP Skill in Claude Code?

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

How do I install Playwright MCP Skill in Codex?

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

Can I use Playwright MCP Skill 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 holon-run/uxc --skill playwright-mcp-skill -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-mcp-skill, .gemini/skills/playwright-mcp-skill, .github/skills/playwright-mcp-skill and .opencode/skills/playwright-mcp-skill in your project.

What does Playwright MCP Skill need to run?

Going by SKILL.md and its folder, Playwright MCP Skill needs a shell for the scripts in its folder and the command-line tools its instructions call (npx). Our summary lists: Node.js; A Bash shell.

Does Playwright MCP Skill access the network?

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

Is Playwright MCP Skill 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Playwright MCP Skill use?

Playwright MCP Skill 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 MCP Skill use?

About 1.1k tokens (SKILL.md is roughly 4.3k 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 502 tokens, read only when the agent opens those files.

What are the alternatives to Playwright MCP Skill?

Skills that share tags, products or a category with Playwright MCP Skill: Playwright MCP Browser Control (Hainrixz/editor-pro-max, 264 stars), Playwright E2E Testing (activepieces/activepieces, 25k stars), Playwright MCP (CraftOS-dev/CraftBot, 392 stars) and Lightpanda (lightpanda-io/agent-skill, 101 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Playwright MCP Skill?

holon-run (a GitHub organization) maintains it in holon-run/uxc, which has 116 GitHub stars. The repository holds 62 skills in this directory. The repository was last updated on September 15, 2026.

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