playwright-dotnet-refactor

name	playwright-dotnet-refactor
description	Refactor generated Playwright .NET test drafts into readable xUnit tests with role-based locators, intent-based assertions, and minimal helper extraction. Use when a generated Playwright test is noisy, brittle, or hard to maintain and needs cleanup without changing user intent.
metadata	{"author":"nimblepros","version":"1.0","spec":"agentskills.io"}

Playwright .NET Refactor Skill

Purpose

Turn generated Playwright .NET test code into maintainable xUnit tests while preserving the original user journey and intent.

Use This Skill When

• You have generated Playwright C# code from codegen and want production-quality tests.
• Selectors are brittle (CSS-heavy, position-dependent, implementation-coupled).
• Assertions are missing, weak, or coupled to internals instead of user-visible outcomes.
• Test flow is hard to read and would benefit from light structure.

Inputs To Gather Before Refactor

1. Raw generated Playwright C# test draft.
2. Intended user scenario in one sentence.
3. Target location for test (file/class name).
4. Existing fixture and conventions in the repo (for this repo, prefer xUnit and BrowserFixture patterns).
5. Any known app constraints (auth state, seed data, environment, flaky selectors).

Refactor Rules

1. Preserve user intent.

• Keep the same user-visible workflow and expected behavior.
• Do not silently add or remove meaningful scenario steps.

2. Prefer role-based locators.

• Prioritize GetByRole, then GetByLabel/GetByPlaceholder, then GetByText, then GetByTestId.