replay-playwright

Configure Replay Playwright plugin to record test executions for debugging.

41|4|Updated May 6, 2026
One-click install
npx skills add https://github.com/markerikson/opencode-config-example --skill replay-playwright-markerikson
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: replay-playwright
Source: https://github.com/markerikson/opencode-config-example/tree/main/config/skill/replay-playwright
Command: npx skills add https://github.com/markerikson/opencode-config-example --skill replay-playwright-markerikson

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Replay and its Replay Browser help you capture deterministic, shareable recordings of Playwright test executions so you can debug failures and analyze performance without guessing what happened during the run.

Core Features & Use Cases

  • Replay Playwright plugin setup: Install and configure the @replayio/playwright reporter in playwright.config.ts to automatically upload recordings.
  • Replay Browser test execution: Add a dedicated replay-chromium project so you can run the same suite while recording.
  • Authentication and MCP debugging: Use a REPLAY_API_KEY to enable uploads, then run a Replay MCP server to inspect and debug the recorded session.
  • Troubleshooting recording-driver issues: Diagnose missing-driver problems and fix common OpenSSL version issues that prevent recordings from being created.

Quick Start

Set up the Replay reporter and run your suite with the replay-chromium project by executing: npx playwright test --project replay-chromium.

Frequently Asked Questions about replay-playwright

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

FAQPage Schema
How do I record Playwright test executions for debugging?

To record Playwright test executions, configure the @replayio/playwright reporter in playwright.config.ts and run tests using the dedicated replay-chromium project via the Replay Browser. This setup automatically captures deterministic recordings of your test runs for later debugging and performance analysis.

Why does my Replay Playwright recording driver fail to launch?

Replay Playwright recording driver failures often stem from missing system libraries or OpenSSL version incompatibilities. You need to diagnose missing libcrypto or libssl compatibility issues on your machine to allow the Replay Browser to properly create recordings during your test runs.

Do I need a REPLAY_API_KEY to upload Playwright test recordings?

Yes, you need to set the REPLAY_API_KEY environment variable to authenticate and enable automatic uploads of your Playwright test recordings. You must also configure the replayReporter with upload enabled in your playwright.config.ts file to ensure successful recording uploads.

Can I debug Replay recordings using an MCP server?

Yes, after recording Playwright runs with the Replay Browser, you can run a Replay MCP server to inspect and debug the recorded session. This allows you to analyze test failures and performance issues deterministically without guessing what happened during the automated execution.

What is the best way to add a Replay project to my Playwright config?

The best way to add Replay recording support is to define a dedicated replay-chromium project in your playwright.config.ts file alongside your existing projects. This allows you to run the same test suite while recording by targeting it with npx playwright test --project replay-chromium.