screenwright

Convert Playwright end-to-end tests into cinematic demo videos.

13|2|Updated Feb 13, 2026
One-click install
npx skills add https://github.com/guidupuy/screenwright --skill screenwright
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: screenwright
Source: https://github.com/guidupuy/screenwright/tree/main/skill
Command: npx skills add https://github.com/guidupuy/screenwright --skill screenwright

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Screenwright converts developer-oriented Playwright end-to-end tests into polished, narrated product demo videos so teams can create marketing, onboarding, and release highlight videos without manual screen recording and editing.

Core Features & Use Cases

  • Scenario generation from tests: Reads relevant Playwright tests and generates human-paced TypeScript demo scenarios using sw.* helpers.
  • Narration and pacing: Adds AI-driven voiceover and timing guidance with optional Piper or OpenAI TTS integration.
  • Deterministic composition: Records and composes video with cursor animation and voiceover into a final MP4 using the screenwright CLI, producing reproducible artifacts for CI.
  • Validation and error guidance: Validates generated scenarios for required imports, disallowed raw page calls, and provides clear retry guidance and specific error codes.
  • Use cases: Create product showcase videos from test flows, produce onboarding walkthroughs, and generate demo assets for release notes or sales collateral.

Quick Start

Run npx screenwright generate on a Playwright test to produce a scenario, review the generated file, then run npx screenwright compose on the scenario to render the final MP4.

Frequently Asked Questions about screenwright

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

FAQPage Schema
How do I turn Playwright tests into demo videos automatically?

To turn Playwright tests into demo videos, you run the screenwright CLI to generate a TypeScript scenario file from your test, then compose the scenario into a final MP4 with cursor animation and AI voiceover.

Can I add AI voiceover to Playwright screen recordings?

Yes, you can add AI voiceover to Playwright screen recordings using the screenwright CLI, which supports optional Piper or OpenAI TTS integration to generate narrated pacing for your demo videos.

What is the best way to create onboarding videos from existing end-to-end tests?

The best way to create onboarding videos from end-to-end tests is converting them into human-paced TypeScript demo scenarios, which are then deterministically recorded and composed into reproducible MP4 artifacts for release highlights.

Do I need the screenwright CLI installed to generate video scenarios?

Yes, you need a compatible screenwright CLI and installed Playwright browsers installed to orchestrate the recording and composition process, validate sw.* helper usage, and render the final video output.

Why does my generated screenwright scenario fail validation?

Scenario validation fails when required imports are missing or when disallowed raw page calls are detected, but the screenwright CLI provides clear retry guidance and specific error codes to help you fix the scenario file.