playwright-serenity-sdet-agent

Create and maintain Playwright and Serenity/JS test suites in TypeScript.

Updated Mar 19, 2026
One-click install
npx skills add https://github.com/LukeSP/SerenityPlaywrightExample --skill playwright-serenity-sdet-agent
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: playwright-serenity-sdet-agent
Source: https://github.com/LukeSP/SerenityPlaywrightExample/tree/main/.gemini/skills
Command: npx skills add https://github.com/LukeSP/SerenityPlaywrightExample --skill playwright-serenity-sdet-agent

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps automate, refactor, and diagnose end-to-end web tests in a Serenity/JS and Playwright TypeScript codebase while keeping tests maintainable and stable.

Core Features & Use Cases

  • Test creation: Design new Screenplay Pattern scenarios with actors, tasks, questions, and custom interactions.
  • Test maintenance: Update locators, fix flaky tests, and keep existing specs aligned with project conventions.
  • Code quality enforcement: Preserve Serenity/JS expectations, avoid direct Playwright calls in specs, and keep locator strategies robust.
  • Failure diagnosis: Use report-driven debugging to identify selector, timing, or assertion issues and guide the next fix.
  • Use case: A test suite for the SerenityPlaywrightExample project needs a new todo-flow scenario and a locator update after a UI change.

Quick Start

Ask the skill to create, refactor, or troubleshoot a Playwright Serenity/JS test for the SerenityPlaywrightExample project.

Frequently Asked Questions about playwright-serenity-sdet-agent

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I write Playwright tests using the Screenplay Pattern in Serenity/JS?

To write Playwright tests using the Screenplay Pattern in Serenity/JS, you design scenarios with actors, tasks, questions, and custom interactions. You must use Serenity/JS expectations and avoid direct Playwright calls in spec files to maintain code quality.

How do I refactor existing Playwright tests to follow the Serenity/JS Screenplay Pattern?

Refactoring Playwright tests to the Serenity/JS Screenplay Pattern involves restructuring code into actors, tasks, and questions while removing direct Playwright calls from spec files. This enforces stable user-facing selectors and maintains robust test automation architecture.

Why are my Playwright tests failing after a UI update, and how do I fix the locators?

Failing Playwright tests after a UI update often stem from broken locators. You can diagnose these failures using report-driven debugging to identify selector issues, and then update locators to use stable user-facing selectors aligned with project conventions.

Can I use direct Playwright API calls in my Serenity/JS spec files?

No, you should not use direct Playwright API calls in Serenity/JS spec files. The framework enforces code quality by requiring Serenity/JS expectations and custom interactions, ensuring tests remain maintainable and stable across end-to-end UI scenarios.

What is the best way to diagnose flaky end-to-end UI tests in a Serenity/JS Playwright project?

The best way to diagnose flaky end-to-end UI tests in a Serenity/JS Playwright project is report-driven debugging. This approach helps identify selector, timing, or assertion issues to guide your next fix while keeping test suites maintainable.

Do I need TypeScript to build automated test suites with Serenity/JS and Playwright?

Yes, TypeScript is required to build automated test suites with Serenity/JS and Playwright. The test automation process relies on TypeScript to apply the Screenplay Pattern, maintain stable locators, and enforce project conventions for end-to-end scenarios.