This repository is a collection of resources (prompts, instructions, and chat modes) for using GitHub Copilot to enhance test automation and quality engineering workflows.
It is designed to help testers, developers, and quality engineers leverage AI to improve their testing practices, automate repetitive tasks, and enhance the overall quality of software products.
Tip
This project is heavily inspired by Awesome GitHub Copilot - a curated list of resources for using GitHub Copilot effectively. We have adapted the structure and content to focus specifically on testing and quality engineering, providing tailored resources for this domain.
Table of Contents
Important
Check out our free YouTube video to learn more about GitHub Copilot Chat Modes:
GitHub Copilot provides three main ways to customize AI responses and tailor assistance to your specific workflows, team guidelines, and project requirements:
- Custom Instructions: Define how Copilot should behave, what to prioritize, and how to communicate.
- Chat Modes: Create specialized chat modes for different roles or tasks, each with its own set of tools and instructions. With version 1.106 of VS Code, Chat Modes were renamed to Custom Agents.
- Custom Agents: Advanced chat modes that can utilize multiple instructions and tools to perform complex tasks.
- Prompt Templates: Predefined templates for common tasks or questions, allowing for quick and consistent responses.
Tip
More You can learn about these features in the official documentation and:
- VS Code Copilot Customization Documentation - Official Microsoft documentation
- Custom Instructions - Tailor Copilot's behavior
- Custom Chat Modes - Advanced chat configuration
- Custom Instructions - Customize Copilot's behavior
- Prompt Files - Using prompt templates
- Custom Agents - Advanced agent configuration
- Agent Skills - Extend agent capabilities with skills
- Hooks - Customize agent behavior with hooks
- Using agents in Visual Studio Code - Overview of agents and orchestration
- Subagents in Visual Studio Code - Using subagents for specialized tasks
Tip
Do you want to learn more about effective use of AI and GitHub Copilot for Testers?
Check our AI_Testers Program - a comprehensive Program for mastering AI in test automation!
Tip
Usage:
- copy these instructions to your
.github/copilot-instructions.mdfile or - create task-specific
.github/.instructions.mdfiles in your workspace's.github/instructionsfolder - use
Chat: Attach Instructionscommand from the command palette to apply them in the current chat
| Title | Description | Install |
|---|---|---|
| 🤖 Copilot Instructions – Best Practices Guide | Guide specific coding standards and best practices |   |
| API test rules (Playwright + TypeScript) | This file describes the API test rules for Playwright + TypeScript tests. | |
| Playwright E2E rules | This file describes the Playwright E2E test rules for Playwright + TypeScript tests. | |
| Page Objects / App Actions rules (Playwright + TS) | This file describes the Page Object / App Action rules for Playwright + TypeScript tests. | |
| Playwright TypeScript Test Generation Instructions | Playwright test generation instructions with best practices and patterns. | |
| TypeScript style rules | This file describes the TypeScript code style for the project. | |
Tip
Usage:
- copy these prompts to your
.github/copilot-prompts/folder - use
/prompt-namein VS Code chat, - run
Chat: Run Promptcommand from the command palette
| Title | Description | Install |
|---|---|---|
| A11Y Webpage Audit (Single URL) | Analyze one webpage for accessibility with WCAG 2.1/2.2 mapping and actionable fixes. | |
| API Test Plan & Test Generator | Create a risk-based API test plan and generate example automated tests from API definitions (OpenAPI/Postman/custom docs). | |
| Analyze and explain code | Analysis of the code you provide, select, or open | |
| Fix failing tests | Fix failing tests in the codebase | |
| Performance & Reliability Test Planner | Design a performance and reliability test strategy and propose concrete load/soak tests for critical user flows. | |
| Explore a website and gather network requests using Playwright MCP | Website exploration and network request gathering using Playwright MCP | |
| Explore a website and propose test cases | Website exploration using Playwright MCP | |
| Generate tests based on a scenario using Playwright MCP | Generate a Playwright test based on a scenario using Playwright MCP | |
| QA Strategy — Edge Cases, Security & Attack Scenarios | For any feature, user story, or API spec: instantly generate a structured scenario matrix covering edge cases, boundary values, OWASP Top 10 security attacks, and adversarial sequences. Use the qa-strategist agent mode for best results. | |
| Tech Debt Audit — Test Automation Code Review | Ruthlessly audit automated test code for anti-patterns: fragile selectors, hardcoded waits, missing assertions, test interdependencies, credential leaks, and more. Produces a severity-ranked debt report with line-level citations and concrete fixes. Use the tech-debt-auditor agent mode for best results. | |
| Generate tests based on test plan | Generate tests based on test plan for a website | |
| Generate a Basic Test Plan | Generate a basic Test Plan | |
| Generate a comprehensive Test Plan | Collects environment details and produces a prioritized test plan with web and API scenarios using the Test Planner Chat Mode. |
|
Tip
Usage (in VS Code prior to version 1.106):
- create new chat modes:
- using the command
Chat: Configure Chat Modes...or - from set mode menu
Agent -> Configure Modes,
- using the command
- then switch your chat mode in the Chat input from set mode menu
Agent -> Configure Modes
Warning
With version 1.106 of VS Code, Chat Modes were renamed to Custom Agents.
They contain .agent.md suffix and should be stored in the .github/agents/
| Title | Description | Install |
|---|---|---|
| Accessibility Expert mode | A specialized chat mode focused on ensuring all code adheres to WCAG 2.1 accessibility standards. | |
| Playwright Automation Engineer (TypeScript) mode (detailed) | Provide expert guidance, code, and troubleshooting help for end-to-end and component-level test automation using Playwright with TypeScript. Prioritize maintainability, speed, reliability, and business value of the test suite. Very detailed operating manual. | |
| Playwright Automation Engineer (TypeScript) mode | Provide expert guidance, code, and troubleshooting help for end-to-end and component-level test automation using Playwright with TypeScript. Prioritize maintainability, speed, reliability, and business value of the test suite. | |
| QA Strategist — Edge Cases, Security & Attacks | Kills happy-path thinking. For every feature, spec, or user story the agent immediately surfaces edge cases, boundary values, security attacks (OWASP Top 10), and adversarial scenarios before a single line of test code is written. | |
| Tech Debt Auditor — Test Automation Code Reviewer | A ruthless, opinionated code reviewer for automated test suites. Hunts down anti-patterns, tech debt, and bad practices — from fragile selectors and hardcoded waits to test interdependencies, weak assertions, and credential leaks. | |
| Test Automation Architect | Help engineers craft robust, fast, and maintainable automated tests that deliver actionable feedback and integrate seamlessly into modern SDLC pipelines. | |
| Test plan from expert Senior Quality Assurance Engineer | This chat mode is designed to assist in creating comprehensive test plans tailored for web applications. | |
Tip
Usage:
- create new agents:
- using the command
Chat: Configure Custom Agents...or - from set mode menu
Agent -> Configure Custom Agents,
- using the command
- then switch your agent in the Chat input from set mode menu
Agent -> <Custom Agent Name>
| Title | Description | Install |
|---|---|---|
| Accessibility Expert mode | A specialized Agent focused on ensuring all code adheres to WCAG 2.1 accessibility standards. | |
| API Test Automation (from OpenAPI spec) | description: Generate REST API tests from an OpenAPI spec (language/framework provided by the user). | |
| Agent mission | Generates and maintains automated tests from an OpenAPI schema and supports testers as a test automation expert (best practices, patterns, project tooling). | |
| Playwright Automation Engineer (TypeScript) mode (detailed) | Provide expert guidance, code, and troubleshooting help for end-to-end and component-level test automation using Playwright with TypeScript. Prioritize maintainability, speed, reliability, and business value of the test suite. Very detailed operating manual. | |
| Playwright Automation Engineer (TypeScript) mode | Provide expert guidance, code, and troubleshooting help for end-to-end and component-level test automation using Playwright with TypeScript. Prioritize maintainability, speed, reliability, and business value of the test suite. | |
| QA Strategist — Edge Cases, Security & Attacks | Kills happy-path thinking. For every feature, spec, or user story the agent immediately surfaces edge cases, boundary values, security attacks (OWASP Top 10), and adversarial scenarios before a single line of test code is written. | |
| Tech Debt Auditor | Audits the repo for technical debt, quantifies impact/risk, and produces a prioritized remediation plan with small, safe PR-sized recommendations. | |
| Test Automation Architect | Help engineers craft robust, fast, and maintainable automated tests that deliver actionable feedback and integrate seamlessly into modern SDLC pipelines. | |
| Test plan from expert Senior Quality Assurance Engineer | This chat mode is designed to assist in creating comprehensive test plans tailored for web applications. | |
| Ui Test Automation | This custom agent creates and maintains Playwright tests for UI automation. Used in courses from AI_Testers (courses about test automation for UI and REST API with AI). | |
Tip
Usage: Just pick an agent set and install the agents you want to orchestrate together, then switch to main agent from the set and start chatting. The agents will automatically trigger each other based on the defined orchestration flow.
Docs:
Contains 4 agents.
| Title | Description | Install |
|---|---|---|
| Analyst | Analyst: pattern analysis, risk assessment, and insight generation | |
| Explorer | Explorer: fast read-only codebase mapping and pattern discovery | |
| Orchestrator | Orchestrator: multi-agent conductor with explicit stop gates | |
| Planner | Planner: research-driven phased plan with test strategy and risks | |
Contains 10 agents.
| Title | Description | Install |
|---|---|---|
| Architect Subagent | Architect: ADR-ready trade-offs, NFR impacts, threat models, and test implications | |
| Code Review Subagent | Code review: correctness, risks, security, tests, and regressions (no fixes) | |
| Docs Writer Subagent | Docs: README updates, usage examples, API docs, and release notes – copy-paste ready | |
| Explorer Subagent | Explorer: fast read-only map of files, usages, patterns, and entry points | |
| Implementer Subagent | Implementer: TDD-first phase delivery with minimal diffs and quality gates | |
| Orchestrator Agent | Orchestrator: multi-agent lifecycle with explicit stop gates | |
| Planner Agent | Planner: research-driven phased plan with tests and NFRs | |
| QA Strategy Subagent | QA strategy: test pyramid, coverage goals, quality gates, and flakiness mitigation | |
| Researcher Subagent | Researcher: extract conventions, key files, patterns, and examples at scale | |
| Security Auditor Subagent | Security audit: threat model, risk scan, OWASP mapping, and concrete mitigations | |
Contains 8 agents.
| Title | Description | Install |
|---|---|---|
| OpenAPI Explorer | Analyze OpenAPI/Swagger spec and produce an API inventory + test matrix. | |
| BE Test Implementer | Implement backend/API tests from the OpenAPI-driven matrix. | |
| FE Explorer (Playwright MCP) | Explore the frontend via Playwright MCP, map flows, suggest robust locator strategy and test targets. | |
| FE Test Implementer | Implement Playwright frontend tests following the provided plan and repo conventions. | |
| QA Orchestrator | Orchestrate subagents to design, implement, review and verify FE/BE tests (OpenAPI + Playwright MCP). | |
| Solution Reviewer | Review FE/BE tests for correctness, maintainability, flakiness, and alignment with the plan. | |
| Test Planner | Combine OpenAPI + FE exploration into a prioritized test plan with architecture and tasks. | |
| Test Runner & Verifier | Run test suites, diagnose failures, and verify the final solution end-to-end. | |
Contains 5 agents. Used in courses from AI_Testers (courses about test automation for UI and REST API with AI).
| Title | Description | Install |
|---|---|---|
| Test Coder Agent | A minimal agent that implements tests based on a provided test plan. It focuses on following best practices for test implementation. | |
| Explorer Agent | A minimal agent that explores the application and gathers information for test planning. It focuses on following best practices for exploration and data collection. | |
| Test Planner | Combine exploration into a prioritized test plan with architecture and tasks. | |
| QA Orchestrator | Orchestrate subagents to design, implement, review and verify FE/BE tests (OpenAPI + Playwright MCP). | |
| Test Framework Starter Agent | A minimal agent that sets up a test framework. | |
Once you've installed the agents, here are some example prompts to get started:
Example 1: Analyze a Feature for Tech Debt (Minimal Example)
@Orchestrator Analyze this codebase for technical debt and maintainability issues.
The Orchestrator will:
- Clarify your scope and constraints
- Invoke Explorer and Analyst in parallel to research the codebase
- Present findings and recommendations for your approval
Example 2: Plan an Implementation (Full Example)
@Orchestrator Plan implementing: Add real-time notifications to our API.
Constraints: Must be backward compatible, no database schema changes.
The Orchestrator will:
- Invoke Planner to create a phased implementation strategy
- Planner will invoke Explorer to map the codebase and Architect for trade-offs
- Present a complete plan with test strategy and risk mitigation
Example 3: Security Assessment
@Orchestrator Assess the security posture of our authentication system.
The Orchestrator will:
- Invoke Explorer to find all auth-related files
- Invoke Security-Auditor to analyze patterns and identify vulnerabilities
- Synthesize findings into actionable recommendations
Tip
For more detailed workflows and best practices, see the Minimal Agent Orchestration Example README
Custom sets are combinations of custom instructions, prompt templates, and chat modes (or custom agents) designed for specific use cases.
Tip
Set elements work together to provide a tailored experience for specific testing scenarios. But you can also use them separately as needed.
Warning
Concept of Sets is not natively supported in VS Code Copilot.
Contains 1 prompt, 1 agent
| Title | Type | Description | Install |
|---|---|---|---|
| Edge Case Scenario Generator (BDD) | Prompt | Generates a complete, risk-based set of BDD test scenarios, focusing on edge cases, state validation, and boundary conditions. | |
| AI Test Architect: Beyond Codegen 2.0 Strategy | Agent | Designs and oversees the implementation of the strategic, two-stage Beyond Codegen 2.0 test generation architecture. | |
Agent Skills are folders of instructions, scripts, and resources that GitHub Copilot can load when relevant to perform specialized tasks. Agent Skills is an open standard that works across multiple AI agents, including GitHub Copilot in VS Code, GitHub Copilot CLI, and GitHub Copilot coding agent.
Tip
Usage:
- copy these skills to your
.github/skills/or.claude/skills/folder
Agents will automatically detect and load these skills if the agent finds them relevant to the current chat context (based on the skill's name and description).
Warning
Agent Skills are currently in preview and may require enabling experimental features in VS Code settings.
| Title | Description | Install |
|---|---|---|
| prd-generator | Generate production-ready Product Requirements Documents (PRDs) for software systems and AI-powered features. The skill ensures clear problem framing, measurable outcomes, scoped functionality, testable requirements, technical feasibility, risk awareness, and stakeholder alignment. | not supported |
| requirements-test-coverage-mapper | Map requirements (PRD/user stories/AC) to comprehensive test coverage using a traceability matrix (RTM). Outputs coverage gaps, risks, test levels, prioritization, automation candidates, and change-impact notes. Designed for QA/Test Architect workflows. | not supported |
| tech-debt-analysis | Analyze technical debt in codebases and test suites using evidence-based signals. Produces a structured, prioritized Technical Debt Report with risk assessment, test impact analysis, remediation options, and ROI-aware recommendations. | not supported |
Hooks enable you to execute custom shell commands at key lifecycle points during agent sessions. Use hooks to automate workflows, enforce security policies, validate operations, and integrate with external tools. Hooks run deterministically and can control agent behavior, including blocking tool execution or injecting context into the conversation.
Tip
Usage:
- copy these hooks to your
.github/hooks/folder or.claude/settings.json
Warning
Hooks are currently in preview and may require enabling experimental features in VS Code settings.
| Title | Description | Install |
|---|---|---|
| Print Tool Info Hook | Manual setup required |
- VS Code Copilot Customization Documentation - Official Microsoft documentation
- GitHub Copilot Chat Documentation - Complete chat feature guide
- Custom Chat Modes - Advanced chat configuration
- Custom Instructions - Customize Copilot's behavior
- Prompt Files - Using prompt templates
- Custom Agents - Advanced agent configuration
- Agent Orchestration - Coordinating multiple agents for complex workflows
- Agent Skills - Extend agent capabilities with custom skills
- Hooks - Automate actions based on chat events
- VS Code Settings - General VS Code configuration guide
- Using agents in Visual Studio Code - Overview of agents and orchestration
- Subagents in Visual Studio Code - Using subagents for specialized tasks
Are you interested in contributing to this project?
We welcome your contributions! Whether it's adding new instructions, prompts, or chat modes, your input is valuable.
Just follow the Contributing Guidelines to get started!
Feel free to reach out to us:
- 🌐 Website: jaktestowac.pl
- 💼 LinkedIn: jaktestowac.pl
- 💬 Discord: Polish Playwright Community
- 📧 Support: Check our website for contact details
We have gathered a collection of resources to help you learn and master Playwright, both in Polish and English. Whether you're a beginner or an advanced user, these resources will help you enhance your skills and knowledge.
- 💡 FREE Playwright Resources - Comprehensive and Free Polish learning materials
- JavaScript and TypeScript for Testers - Comprehensive (13h+) course on JavaScript and TypeScript for testers, with practical examples and exercises
- Professional Test Automation with Playwright - Comprehensive (100h+) course on Playwright, test automation, CI/CD and test architecture
- Back-end Test Automation - Comprehensive (45h+) course on Back-end Test Automation with Postman, Mocha, Chai, and Supertest
- Playwright Basics - YouTube series (Polish)
- Playwright Elements - Advanced concepts (Polish)
- Playwright MCP - MCP course (Polish)
- Discord Community - First Polish Playwright community!
- Playwright Info - first and only Polish Playwright blog
Gain an edge by combining AI knowledge with the most popular tools in the IT market.
We'll show you how to accelerate with AI and build a professional test automation framework. 😉
- AI_Testers - Main page about AI_Testers Program
- AI_Testers LinkedIn - Follow us on LinkedIn
- VS Code Extensions - Our free Playwright plugins
- Playwright Documentation - Official documentation
- Playwright GitHub - Source code and issues
PS. For more resources and updates, follow us on our website and GitHub.
Happy testing and automation! 🚀
jaktestowac.pl Team ❤️💚
Built with ❤️💚 for the Playwright and test automation community