Playwright Tester — Agent Skill by GitHub

From the author

Testing mode for Playwright tests

— the description by aaronpowell

AutoGineer summary

Written by AutoGineer from the skill’s own files, not by the author

Playwright Tester Mode provides a structured approach to end-to-end testing. It guides the agent through a systematic process of website exploration, locator identification via snapshots, test generation in TypeScript, and iterative debugging to ensure test reliability.

What it does

Explores websites to identify key user flows before writing tests.
Captures page snapshots to determine accurate locators.
Generates maintainable Playwright tests using TypeScript.
Executes tests and diagnoses failures automatically.
Iterates on test code until all scenarios pass reliably.
Documents tested functionalities and test suite structure.

When to use it

When you need to create new end-to-end tests for a web application.
When existing Playwright tests are failing and require debugging.
When you need to update test locators based on UI changes.
When you want to ensure your test suite covers critical user flows.

Advantages

Ensures tests are based on actual site exploration rather than assumptions.
Reduces manual effort in identifying correct UI locators.
Promotes the creation of well-structured and maintainable test code.
Streamlines the cycle of test execution and failure resolution.

Usage examples

“Create a new test suite for the user login flow on my website.”: The agent will navigate to the login page, analyze the DOM, identify the username and password fields, and generate a robust TypeScript test file.
“Fix the failing tests in the checkout module.”: The agent will run the tests, analyze the failure logs, inspect the current page state via snapshots, and update the locators or logic to resolve the issues.

Install

Download the custom agent as a ZIP:
https://autogineer.com/agent-skills/github/playwright-tester/download

Extract the agent file into .github/agents, then commit it:

mkdir -p .github/agents && unzip -j playwright-tester.zip 'playwright-tester/playwright-tester.agent.md' -d .github/agents

Keep the LICENSE and ATTRIBUTION.md files from the ZIP with your copy.

Documentation by aaronpowell

Core Responsibilities

Website Exploration: Use the Playwright MCP to navigate to the website, take a page snapshot and analyze the key functionalities. Do not generate any code until you have explored the website and identified the key user flows by navigating to the site like a user would.
Test Improvements: When asked to improve tests use the Playwright MCP to navigate to the URL and view the page snapshot. Use the snapshot to identify the correct locators for the tests. You may need to run the development server first.
Test Generation: Once you have finished exploring the site, start writing well-structured and maintainable Playwright tests using TypeScript based on what you have explored.
Test Execution & Refinement: Run the generated tests, diagnose any failures, and iterate on the code until all tests pass reliably.
Documentation: Provide clear summaries of the functionalities tested and the structure of the generated tests.

Files

ATTRIBUTION.mdAdded by AutoGineer882 B
LICENSELicence file added by AutoGineer1.0 KiB
playwright-tester.agent.md1.3 KiB

Requirements and compatibility

Written for: GitHub Copilot

Works with: GitHub Copilot

“Works with” means the tool reads the open Agent Skills format; a skill written for one tool may use features others lack.

Security

No issues found by our static scan· No issues found

A static scan is not a guarantee. Skills are third-party content: review a skill before you let an agent use it.

Migrate To Shoehorn
Matt Pocock· Community
Automate the migration of TypeScript test assertions from unsafe as-casting to the type-safe shoehorn library.
Software developmentClaude CodeClaude appsOpenAI Codex+14 more
MITGitHub stars of the source repository317.5k
Tdd
Matt Pocock· Community
A reference guide for implementing the red-green-refactor loop in test-driven development.
Software developmentClaude CodeClaude appsOpenAI Codex+14 more
MITGitHub stars of the source repository317.5k
Test Driven Development
Jesse Vincent (obra)· Community
A rigorous framework for Test-Driven Development, mandating that failing tests precede all production code.
Software developmentClaude CodeClaude appsOpenAI Codex+14 more
MITGitHub stars of the source repository314k
Webapp Testing
AnthropicOfficial
A toolkit for automating local web application testing using Playwright and server management helpers.
Software developmentClaude CodeClaude appsOpenAI Codex+14 more
Apache-2.0Low riskHas scriptsGitHub stars of the source repository188.6k
Test Driven Development
Addy Osmani· Community
A systematic approach to software development using the red-green-refactor cycle to ensure code reliability and maintainability.
Software developmentClaude CodeClaude appsOpenAI Codex+14 more
MITGitHub stars of the source repository113.9k
Browser Testing With Devtools
Addy Osmani· Community
Integrate Chrome DevTools to enable live browser inspection, debugging, and automated UI verification for your AI agent.
Software developmentClaude CodeClaude appsOpenAI Codex+14 more
MITGitHub stars of the source repository113.9k