How do I install the Playwright skill?

Run npx skillmds@latest add saffron-health/playwright in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Playwright safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Playwright?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Playwright free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Playwright?

saffron-health (@saffron-health) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Playwright by saffron-health — Agent Skill

Name: Playwright
Author: saffron-health

File contents

Browser Automation with Playwright

Use the playwright-cli.ts script bundled with this skill to automate web interactions and debug browser issues.

Run it with: tsx .agents/skills/playwright/cli.ts

When to Use

Pages require interaction, authentication, or dynamic content loading (instead of read_web_page)
Debugging browser automation errors (clicks not working, selectors failing, elements not found)
Testing interactions before codifying them in source files

Commands

tsx .agents/skills/playwright/cli.ts open <url>          # Launch browser and navigate to URL
tsx .agents/skills/playwright/cli.ts exec <code>         # Execute Playwright TypeScript code
tsx .agents/skills/playwright/cli.ts snapshot            # Save full-page PNG + HTML to tmp/playwright-screenshots/
tsx .agents/skills/playwright/cli.ts list                # List open tabs
tsx .agents/skills/playwright/cli.ts close               # Close the browser

The exec command provides access to: page, context, state, browser, snapshot

Example

tsx .agents/skills/playwright/cli.ts open https://example.com
tsx .agents/skills/playwright/cli.ts exec "await page.locator('button:has-text(\"Sign in\")').click()"
tsx .agents/skills/playwright/cli.ts exec "await page.fill('input[name=\"email\"]', 'user@example.com')"
tsx .agents/skills/playwright/cli.ts snapshot
tsx .agents/skills/playwright/cli.ts close

Sessions & Profiles

Use --session <name> to run multiple isolated browser instances simultaneously.

Use save <domain> after logging in to persist cookies/localStorage for automatic reuse:

tsx .agents/skills/playwright/cli.ts open https://linkedin.com
# ... manually log in ...
tsx .agents/skills/playwright/cli.ts save linkedin.com
# Next time, profile is loaded automatically

Connecting to the Extension Debug Session

Launch the extension in a background tmux session with CDP enabled:

pnpm debug:extension              # starts in tmux "opencode-debug", CDP on :9222
pnpm debug:extension --stop       # stops the session

Then connect Playwright to it:

tsx .agents/skills/playwright/cli.ts connect http://127.0.0.1:9222 --session extension
tsx .agents/skills/playwright/cli.ts exec "return await page.title()" --session extension

Connecting to Other Browsers

Connect to any browser exposing a CDP endpoint:

tsx .agents/skills/playwright/cli.ts connect http://127.0.0.1:9222 --session my-session
tsx .agents/skills/playwright/cli.ts exec "return await page.title()" --session my-session

---name: playwrightdescription: Browser automation CLI using Playwright. Use when automating browser workflows, filling forms, clicking elements, scraping pages, or debugging web issues.---# Browser Automation with PlaywrightUse the `playwright-cli.ts` script bundled with this skill to automate web interactions and debug browser issues.Run it with: `tsx .agents/skills/playwright/cli.ts`## When to Use- Pages require interaction, authentication, or dynamic content loading (instead of read_web_page)- Debugging browser automation errors (clicks not working, selectors failing, elements not found)- Testing interactions before codifying them in source files## Commands```bashtsx .agents/skills/playwright/cli.ts open <url> # Launch browser and navigate to URLtsx .agents/skills/playwright/cli.ts exec <code> # Execute Playwright TypeScript codetsx .agents/skills/playwright/cli.ts snapshot # Save full-page PNG + HTML to tmp/playwright-screenshots/tsx .agents/skills/playwright/cli.ts list # List open tabstsx .agents/skills/playwright/cli.ts close # Close the browser```The exec command provides access to: `page`, `context`, `state`, `browser`, `snapshot`## Example```bashtsx .agents/skills/playwright/cli.ts open https://example.comtsx .agents/skills/playwright/cli.ts exec "await page.locator('button:has-text(\"Sign in\")').click()"tsx .agents/skills/playwright/cli.ts exec "await page.fill('input[name=\"email\"]', 'user@example.com')"tsx .agents/skills/playwright/cli.ts snapshottsx .agents/skills/playwright/cli.ts close```## Sessions & ProfilesUse `--session <name>` to run multiple isolated browser instances simultaneously.Use `save <domain>` after logging in to persist cookies/localStorage for automatic reuse:```bashtsx .agents/skills/playwright/cli.ts open https://linkedin.com# ... manually log in ...tsx .agents/skills/playwright/cli.ts save linkedin.com# Next time, profile is loaded automatically```## Connecting to the Extension Debug SessionLaunch the extension in a background tmux session with CDP enabled:```bashpnpm debug:extension # starts in tmux "opencode-debug", CDP on :9222pnpm debug:extension --stop # stops the session```Then connect Playwright to it:```bashtsx .agents/skills/playwright/cli.ts connect http://127.0.0.1:9222 --session extensiontsx .agents/skills/playwright/cli.ts exec "return await page.title()" --session extension```## Connecting to Other BrowsersConnect to any browser exposing a CDP endpoint:```bashtsx .agents/skills/playwright/cli.ts connect http://127.0.0.1:9222 --session my-sessiontsx .agents/skills/playwright/cli.ts exec "return await page.title()" --session my-session```

Frequently asked questions

Playwright