Skip to main content
skill CX Codex

test-framework-migration-skill — Claude Code skill guide

test-framework-migration-skill converts E2E test scripts between Selenium, Playwright, Puppeteer, and Cypress. It rewrites selectors, assertions, and lifecycle methods automatically.

MIT 229 installs ★ 393 updated 2026-10-13

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add LambdaTest/agent-skills --skill test-framework-migration-skill -a claude-code
Open on GitHub

What test-framework-migration-skill does

This skill translates test automation scripts across Selenium, Playwright, Puppeteer, and Cypress. It handles five programming languages: Java, Python, C#, JavaScript, and TypeScript. The agent uses mapping guides to replace locators, assertion styles, and browser setup logic.

Each migration adapts to the engine design. Target Playwright code uses web-first assertions instead of arbitrary timeouts like waitForTimeout. Cypress outputs omit async/await syntax, while Selenium targets get explicit WebDriverWait calls rather than Thread.sleep. Switching from Selenium in Java to Playwright requires migrating the codebase to JavaScript or TypeScript.

What it helps with

  • migrate test suites from Selenium to Playwright
  • rewrite Cypress specs into Playwright tests
  • replace Thread.sleep calls with explicit waits for Selenium
  • port Puppeteer automation scripts to Cypress

Example prompts for the agent

  • Migrate this Java Selenium test file to Playwright TypeScript.
  • Convert my Cypress test suite to Playwright.
  • Port these Puppeteer scripts to Python Selenium.

How to install test-framework-migration-skill

1Skills CLI (Vercel)

npx skills add LambdaTest/agent-skills --skill test-framework-migration-skill -a claude-code

2Manually: put the files in place

~/.claude/skills/test-framework-migration-skill/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/test-framework-migration-skill/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about test-framework-migration-skill

How to install test-framework-migration-skill in Claude Code?

Run npx skills add LambdaTest/agent-skills --skill test-framework-migration-skill -a claude-code in your terminal. The file will be placed at ~/.claude/skills/test-framework-migration-skill/SKILL.md.

Which test frameworks can it convert between?

It translates test scripts across Selenium, Playwright, Puppeteer, and Cypress in any combination.

How does it handle wait logic during conversion?

It replaces manual sleep calls with framework-native mechanics. Playwright targets receive auto-waiting locators, while Selenium targets get explicit WebDriverWait instances.

Source text

SKILL.md · MIT
---
name: test-framework-migration-skill
description: >
  Migrates and converts test automation scripts between Selenium, Playwright,
  Puppeteer, and Cypress. Use when the user asks to migrate, convert, or port
  tests from one framework to another; rewrite tests in a different framework;
  or switch from Selenium to Playwright, Playwright to Selenium, Puppeteer to
  Playwright, Cypress to Playwright, or vice versa. Triggers on: "migrate",
  "convert", "port", "selenium to playwright", "playwright to selenium",
  "puppeteer to playwright", "cypress to playwright", "rewrite tests in",
  "switch from [framework] to [framework]".
languages:
  - Java
  - Python
  - JavaScript
  - TypeScript
  - C#
category: e2e-testing
license: MIT
metadata:
  author: TestMu AI
  version: "1.0"
---

# Test Framework Migration Skill

You are a senior QA automation architect. You migrate test automation scripts from one framework (Selenium, Playwright, Puppeteer, Cypress) to another by applying API mappings, lifecycle changes, and pattern conversions from the skill reference docs.

## Step 1 — Detect Source Framework

Determine the **source** framework from the user message or from open files:

| Signal in message or code | Source framework |
|---------------------------|------------------|
| "Selenium", "WebDriver", "driver.findElement", "By.id", "ChromeDriver" | Selenium |
| "Playwright", "page.getByRole", "expect(locator).toBeVisible", "@playwright/test" | Playwright |
| "Puppeteer", "page.$", "page.goto", "puppeteer.launch" | Puppeteer |
| "Cypress", "cy.get", "cy.visit", "cy.contains", "cy.should" | Cypress |

If ambiguous (e.g. user says "convert my tests" with no file open), ask: "Which framework are your current tests in (Selenium, Playwright, Puppeteer, or Cypress)?"

## Step 2 — Detect Target Framework

Determine the **target** framework from the user message:

| User says... | Target |
|--------------|--------|
| "to Playwright", "to playwright" | Playwright |
| "to Selenium", "to WebDriver" | Selenium |
| "to Puppeteer" | Puppeteer |
| "to Cypress" | Cypress |

If the user only names the source (e.g. "convert my Selenium tests"), ask: "Which framework do you want to migrate to (Playwright, Puppeteer, Cypress, or keep Selenium with another language)?"

## Step 3 — Detect Language

| Source → Target | Language note |
|----------------|---------------|
| Selenium (Java/Python/C#) → Playwright | Playwright is typically JS/TS; migration usually implies rewriting to TypeScript or JavaScript. Mention this if source is Java/C#/Python. |
| Selenium (JS) → Playwright | Same language (JS/TS) possible. |
| Playwright/Puppeteer/Cypress → Selenium | Target can be Java, Python, JS, C#. Prefer same as project or ask. |
| Playwright ↔ Puppeteer ↔ Cypress | Typically stay in JS/TS. |

For language matrix details (which frameworks support which languages), see [reference/overview.md](reference/overview.md).

## Step 4 — Route to Reference

**Always read** the matching reference file before generating migrated code:

| Source → Target | Reference file |
|----------------|----------------|
| Selenium → Playwright | [reference/selenium-to-playwright.md](reference/selenium-to-playwright.md) |
| Playwright → Selenium | [reference/playwright-to-selenium.md](reference/playwright-to-selenium.md) |
| Selenium → Puppeteer | [reference/selenium-to-puppeteer.md](reference/selenium-to-puppeteer.md) |
| Puppeteer → Selenium | [reference/puppeteer-to-selenium.md](reference/puppeteer-to-selenium.md) |
| Puppeteer → Playwright | [reference/puppeteer-to-playwright.md](reference/puppeteer-to-playwright.md) |
| Playwright → Puppeteer | [reference/playwright-to-puppeteer.md](reference/playwright-to-puppeteer.md) |
| Cypress → Playwright | [reference/cypress-to-playwright.md](reference/cypress-to-playwright.md) |
| Playwright → Cypress | [reference/playwright-to-cypress.md](reference/playwright-to-cypress.md) |
| Selenium → Cypress | [reference/selenium-to-cypress.md](reference/selenium-to-cypress.md) |
| Cypress → Selenium | [reference/cypress-to-selenium.md](reference/cypress-to-selenium.md) |

If the pair is not in the table, say so and suggest the closest supported migration (e.g. add WebDriverIO later as a new reference file).

## Step 5 — Apply Mappings

Using the reference doc:

1. **Locators** — Convert using the API mapping table (e.g. `By.id("x")` → `page.getByRole(...)` or `page.locator('#x')`).
2. **Waits** — Convert wait strategy (explicit wait / auto-wait / cy.should).
3. **Actions** — Map click, type, select, etc.
4. **Assertions** — Map to target's assertion style.
5. **Lifecycle** — Adjust setup/teardown (driver vs page, launch vs connect).
6. **Cloud (TestMu)** — If user runs on cloud, point to target framework's cloud docs after migration.

After generating migrated code, validate against the "Gotchas" section of the reference to avoid common pitfalls.

## Cross-References for Deep Patterns

| Need | Where to look |
|------|----------------|
| Full Playwright patterns, POM, cloud | `playwright-skill` and [playwright-skill/reference/cloud-integration.md](../playwright-skill/reference/cloud-integration.md) |
| Full Selenium patterns, POM, cloud | `selenium-skill` and [selenium-skill/reference/cloud-integration.md](../selenium-skill/reference/cloud-integration.md) |
| Full Puppeteer patterns, cloud | `puppeteer-skill` and [puppeteer-skill/reference/cloud-integration.md](../puppeteer-skill/reference/cloud-integration.md) |
| Full Cypress patterns, cloud | `cypress-skill` and [cypress-skill/reference/cloud-integration.md](../cypress-skill/reference/cloud-integration.md) |
| TestMu capabilities (all frameworks) | [shared/testmu-cloud-reference.md](../shared/testmu-cloud-reference.md) |

## Validation Workflow

After generating migrated code:

1. Ensure every locator/action/assertion was converted using the reference mapping (no leftover source API).
2. Ensure lifecycle (setup/teardown) matches target framework.
3. If target is Playwright: use auto-wait assertions (`expect(locator).toBeVisible()`), not raw `waitForTimeout`.
4. If target is Cypress: no async/await with `cy` commands; use chain style.
5. If target is Selenium: use explicit `WebDriverWait`, never `Thread.sleep`.

## Reference Files Summary

| File | When to read |
|------|--------------|
| [reference/overview.md](reference/overview.md) | Framework comparison, language matrix, when to migrate |
| [reference/playbook.md](reference/playbook.md) | Full migration workflow, debugging table, CI/CD checklist, best practices |
| `reference/<source>-to-<target>.md` | Before converting any script for that pair |

© TestMu AI · MIT · LambdaTest/agent-skills

Similar skills

All skills for Testing and QA →

From the same set47

The whole set →

Project sponsors

Companies that keep this analytics open