🤖 Awesome GitHub Copilot for Testers

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]
💡 Choose your language:

• 🇬🇧 English
• 🇵🇱 Polski

[!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

• 🎯 GitHub Copilot Customization Features
  • 📋 Resources
    • Custom Instructions
    • Custom Prompt Templates
    • Custom Chat Modes (Deprecated)
    • Custom Agents
    • Agent Orchestration
    • Custom Sets
    • Agent Skills
    • Hooks
  • 📚 Additional Resources
  • 🌱 Contributing
  • 📞 Contact & Support
• 📚 Learning Resources
  • 🇵🇱 Polish Resources
  • 🇬🇧 English Resources

[!IMPORTANT]
Check out our free YouTube video to learn more about GitHub Copilot Chat Modes:

🎯 GitHub Copilot Customization Features

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!

📋 Resources

Custom Instructions

[!TIP]
Usage:

• copy these instructions to your .github/copilot-instructions.md file or
• create task-specific .github/.instructions.md files in your workspace's .github/instructions folder
• use Chat: Attach Instructions command 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.

Custom Prompt Templates

[!TIP]
Usage:

• copy these prompts to your .github/copilot-prompts/ folder
• use /prompt-name in VS Code chat,
• run Chat: Run Prompt command 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.

Custom Chat Modes (Deprecated)

[!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,
• 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.

Custom Agents

[!TIP]
Usage:

• create new agents:
  • using the command Chat: Configure Custom Agents... or
  • from set mode menu Agent -> Configure Custom Agents,
• 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.
🦆 Rubber Duck 2.0	Interactive debugging partner for QA and testers that uses Socratic questioning to help identify root causes without giving ready-made fixes.
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).

Agent Orchestration

[!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:

• https://code.visualstudio.com/docs/copilot/agents/subagents
• https://code.visualstudio.com/updates/v1_109#_control-how-custom-agents-are-invoked

Minimal Agent Orchestration Example

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

VS Code Copilot Agents Pack (Architect + Test Architect)

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

Ui Api Automation

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.

Ui Api Automation Minimal

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.

🎯 Quick Start: Using Orchestrator with Subagents

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:

1. Clarify your scope and constraints
2. Invoke Explorer and Analyst in parallel to research the codebase
3. 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:

1. Invoke Planner to create a phased implementation strategy
2. Planner will invoke Explorer to map the codebase and Architect for trade-offs
3. 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:

1. Invoke Explorer to find all auth-related files
2. Invoke Security-Auditor to analyze patterns and identify vulnerabilities
3. Synthesize findings into actionable recommendations

[!TIP]
For more detailed workflows and best practices, see the Minimal Agent Orchestration Example README

Custom Sets

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.

Beyond Codegen 2.0 Strategy

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

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.

Hooks

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.

📚 Additional Resources

• 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

🌱 Contributing

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!

📞 Contact & Support

Feel free to reach out to us:

• 🌐 Website: jaktestowac.pl
• 💼 LinkedIn: jaktestowac.pl
• 💬 Discord: Polish Playwright Community
• 📧 Support: Check our website for contact details

📚 Learning Resources

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.

🇵🇱 Polish Resources

• 💡 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

AI_Testers

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

🇬🇧 English Resources

• 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