How to Use Playwright Skill With Cursor AI [2026]

What Is a Playwright Skill

A Playwright Skill is a structured markdown guide that gives an AI coding agent the project-specific context it needs to write tests that hold up in production.

The format is a SKILL.md file - a convention from the open Agent Skills Standard that tools like Cursor AI, Claude Code, GitHub Copilot, and Gemini CLI read before generating code.

The agent loads the skill, then applies its patterns automatically without you having to prompt for them every time.

Playwright Skill is not documentation. The official Playwright documentation covers what the API does. A skill covers when to use it, when to avoid it, and which patterns survive a real codebase.

Without a skill, an agent guesses. For example, below is the login test generated using Cursor AI agent without the skill:

page.locator('.login-button').click()

And below is the code with the Playwright Skill loaded:

page.getByRole('button', { name: 'Sign in' }).click()

The second selector keeps working no matter how many times the design changes. The first one breaks the moment a designer renames a CSS class.

The Playwright Skills Repository by TestMu AI (Formerly LambdaTest)

The Playwright Skill is a repository maintained by TestMu AI.

LambdaTest is now called TestMu AI, the same trusted platform with a new name and powerful AI capabilities.

Basically, the TestMu AI agent-skills repository covers 46 test automation frameworks across 15+ languages. Playwright is one skill in a collection that also includes Cypress, Jest, Appium, Selenium, WebdriverIO, and more.

If your project runs Playwright for E2E and Jest for unit tests, you install two skills. Each AI agent on your team draws from the right context for the right task. Here is how the Playwright Skill folder is structured.

Repository Structure

playwright-skill/
├── reference/       # Production patterns and playbooks
├── scripts/         # Executable automation scripts
├── templates/       # Ready-to-use test templates
└── SKILL.md         # Agent entry point

There are four components. Each has a specific job.

• SKILL.md is what Cursor AI reads first - a compact metadata file that tells the agent what the skill covers, when to load it, and where to find the right folder for the task. It stays small by design, so it does not bloat the agent's context window on every prompt.
• reference/ is where the production patterns live - locator strategy, auth setup, assertion patterns, CI configuration, and cloud execution guidance in the order a team actually adopts them.
• scripts/ contains executable automation that the agent can run directly - setup scripts, configuration generators, and diagnostic utilities that would otherwise require manual steps.
• templates/ gives the agent ready-to-use starting points for common test structures: page objects, global setup, GitHub Actions workflows, and fixture files that follow the patterns in the reference folder.

How to Install the TestMu AI Playwright Skill

With the repository structure covered, let's install the skill. Clone the TestMu AI agent-skills repo from GitHub, then copy the playwright-skill folder into your tool's local skills directory.

Option 1: Clone the Full Repository

If your stack uses multiple frameworks, clone the whole collection:

# Cursor AI
git clone https://github.com/LambdaTest/agent-skills.git .cursor/skills/agent-skills

# Claude Code
git clone https://github.com/LambdaTest/agent-skills.git .claude/skills/agent-skills

# GitHub Copilot
git clone https://github.com/LambdaTest/agent-skills.git .github/skills/agent-skills

# Gemini CLI
git clone https://github.com/LambdaTest/agent-skills.git .gemini/skills/agent-skills

Option 2: Install Only the Playwright Skill

Playwright-only projects can copy just the one directory:

git clone https://github.com/LambdaTest/agent-skills.git
cp -r agent-skills/playwright-skill .cursor/skills/

How to Run Tests Using Playwright Skill

I will use the Cursor AI agent mode for demonstration. If you also maintain project conventions in that editor, our guide to cursor rules covers how those files load alongside a skill.

Open Cursor AI and switch to the agent mode. Prompt it to write Playwright tests, let the agent generate specs and config files, then run the generated command (npx playwright test) to execute and verify tests locally.

Step 1: Open Cursor (or any IDE with AI agent support like VS Code with GitHub Copilot).

Step 2: Open the chat panel and type this prompt:

Write Playwright tests for clicking on the Simple Form Demo option in TestMu AI Selenium Playground: https://www.testmuai.com/selenium-playground/

Step 3: The Cursor AI agent reads the installed Playwright Skill and generates the tests. It adds a Playwright spec that navigates to the TestMu AI Selenium Playground page, clicks/uses the "Simple Form Demo" option, and asserts that the Simple Form Demo page/content loads.

Files added:

• playwright.config.js
• tests/simple-form-demo-dropdown.spec.js
• package.json

It runs the simple-form-demo-dropdown.spec.js in headless Chromium to confirm it can actually find the Simple Form Demo option on the TestMu AI Selenium Playground page and navigate to the Simple Form Demo menu.

If it fails, the Cursor AI agent will adjust the selectors accordingly.

Step 4: Once test scripts are generated, the agent will give the test command to run the test.

Here is the command it has generated in my case:

npx playwright test tests/simple-form-demo-dropdown.spec.js --project=chromium

Open your Cursor AI terminal and run the generated test command.

As you can see in the screenshot above, the test passed locally. The next step is to run the same tests on a cloud grid for cross-browser coverage.

How to Run Playwright Tests on Cloud With TestMu AI Skills

Once tests pass locally, you can scale them using the TestMu AI Playwright automation cloud. The Playwright Skill makes this transition seamless.

Note: To run the test, first set your TestMu AI credentials in the environment variables. You can get these credentials at the bottom of the TestMu AI dashboard under Credentials.

You can run the command below in the terminal to set these variables:

# macOS/Linux
export LT_USERNAME="YOUR_TESTMUAI_USERNAME"
export LT_ACCESS_KEY="YOUR_TESTMUAI_ACCESS_KEY"

# Windows (PowerShell)
$env:LT_USERNAME="YOUR_TESTMUAI_USERNAME"
$env:LT_ACCESS_KEY="YOUR_TESTMUAI_ACCESS_KEY"

# Windows (Command Prompt)
set LT_USERNAME="YOUR_TESTMUAI_USERNAME"
set LT_ACCESS_KEY="YOUR_TESTMUAI_ACCESS_KEY"

Let's enter the prompt in the Cursor AI agent:

Run the same tests on the TestMu AI Cloud Grid

It will generate the following files. The main ones are:

• package.json