TESTING AND REVIEW / github
Playwright Test Explorer
Explores a working interface through Playwright before generating and running TypeScript tests for its observed user flows.
“Testing mode for Playwright tests”
01 / THE REASONING
Why this made the selection.
- Prohibits writing test code until the agent has navigated the interface and identified its actual flows.
- Uses browser snapshots to inform locators and requires executing and refining the generated tests.
02 / THE REVIEW RECORD
What we actually inspected.
Source review has boundaries.
A clear record is more useful than a “safe” badge.
Material inspected
- agents/playwright-tester.agent.md (complete original frontmatter and body; strict YAML duplicate-key check)
- LICENSE (full applicable licence bytes and redistribution terms)
- Current official host configuration documentation; exact source and licence SHA-256 recorded
Our findings
- Exploration before generation and snapshot-derived locators are explicit gates in the body.
- The original uses legacy tool names and a bare playwright entry, so current host configuration is required before its browser steps can run.
Not established by this review
- This agent has not been executed or benchmarked.
- Host discovery, configured tool availability, model behaviour and task outcomes were not runtime-tested.
The review applies to the material and revision named here. A newer upstream release can change its behavior.
03 / PUT IT TO WORK
Use the role in your project.
- Download the original playwright-tester.agent.md with its full licence and attribution; inspect the complete instructions and tool scope before use.
- In a working copy, replace legacy tool aliases with the current host’s read/search/edit/execute tools and explicitly enable the configured Playwright MCP tools. A bare playwright alias is not a portable MCP server wildcard.
- Place the reviewed working copy at .github/agents/playwright-tester.agent.md. Select the custom agent in VS Code’s agent picker.
- Use the host’s tool configuration to check every declared tool name and any MCP dependency. Confirm a pinned model is available or select a supported one in the working copy; never treat unknown tools as extra permission.
- Check the original model pin against models available in the account. Configure Playwright and the application separately; this definition is not a framework installer.
- Provide a reachable development URL, isolated test data and the intended flows. Require browser exploration before test generation, then review assertions as well as the actual test results.
Before you start
- A configured Playwright MCP server, reachable application and TypeScript test project.
- Host permission to browse the test environment, edit test files and run the selected checks.
THE COMPLETE REVIEWED DEFINITION
Read it before you reuse it.
Original source bytes, with attribution.
Review the host-specific setup notes above.
---
description: "Testing mode for Playwright tests"
name: "Playwright Tester Mode"
tools: ["changes", "codebase", "edit/editFiles", "fetch", "findTestFiles", "problems", "runCommands", "runTasks", "runTests", "search", "searchResults", "terminalLastCommand", "terminalSelection", "testFailure", "playwright"]
model: Claude Sonnet 4
---
## Core Responsibilities
1. **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.
2. **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.
3. **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.
4. **Test Execution & Refinement**: Run the generated tests, diagnose any failures, and iterate on the code until all tests pass reliably.
5. **Documentation**: Provide clear summaries of the functionalities tested and the structure of the generated tests.
The download contains playwright-tester.agent.md. Keep its filename when placing it in the agent directory described above.
By github. Exact upstream source ↗ · Licence · Attribution
SHA-256 67b9e4210df2fff06ed111fbcc67261f90f36cd3d4ff5b09dadaa4c31772b079
Read the applicable licence
MIT License Copyright GitHub, Inc. Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
04 / FOLLOW THE EVIDENCE
The source trail.
Our notes are separate from the original resource.
Check upstream before adopting a new version.
https://github.com/github/awesome-copilot/blob/ad4c196b933c5ca7f82a5ba78969ddcd2603ba80/agents/playwright-tester.agent.md
Supports: summary, upstreamDescription, whySelected, bestFor, limitations, review, access
https://github.com/github/awesome-copilot/blob/ad4c196b933c5ca7f82a5ba78969ddcd2603ba80/LICENSE
Supports: license, artifact
https://code.visualstudio.com/docs/agent-customization/custom-agents
Supports: compatibility, install, access, limitations, review
https://code.visualstudio.com/docs/agents/run/tools
Supports: install, access, limitations, review