Agent Skills › mercurjs/mercur › playwright-ci

playwright-ci

GitHub

提供 Playwright 在 CI/CD 环境中的最佳实践，涵盖 GitHub Actions、GitLab CI 等主流平台的配置，支持并行分片、Docker 容器化运行、测试报告生成及失败调试，旨在提升自动化测试的稳定性与执行效率。

.agents/skills/playwright-skill/ci/SKILL.md mercurjs/mercur

Trigger Scenarios

需要配置 Playwright 到 CI/CD 流水线优化 E2E 测试的执行速度与稳定性解决 CI 环境中浏览器依赖或缓存问题

Install

npx skills add mercurjs/mercur --skill playwright-ci -g -y

More Options

Non-standard path

npx skills add https://github.com/mercurjs/mercur/tree/main/.agents/skills/playwright-skill/ci -g -y

Use without installing

npx skills use mercurjs/mercur@playwright-ci

指定 Agent (Claude Code)

npx skills add mercurjs/mercur --skill playwright-ci -a claude-code -g -y

安装 repo 全部 skill

npx skills add mercurjs/mercur --all -g -y

预览 repo 内 skill

npx skills add mercurjs/mercur --list

SKILL.md

Frontmatter

{
    "name": "playwright-ci",
    "description": "Production-ready CI\/CD configurations for Playwright — GitHub Actions, GitLab CI, CircleCI, Azure DevOps, Jenkins, Docker, parallel sharding, reporting, code coverage, and global setup\/teardown."
}

Playwright CI/CD

Ship reliable tests in every pipeline — CI-specific patterns for speed, stability, and actionable reports.

9 guides covering CI/CD setup, parallel execution, containerized runs, reporting, and infrastructure patterns for all major CI providers.

Golden Rules

retries: 2 in CI only — surface flakiness in pipelines, not locally
traces: 'on-first-retry' — capture rich debugging artifacts without slowing every run
Shard across runners — --shard=N/M splits tests evenly; scale horizontally, not vertically
Cache browser binaries — ~/.cache/ms-playwright keyed on Playwright version
Upload artifacts on failure — traces, screenshots, and HTML reports as CI artifacts
Use the official Docker image — mcr.microsoft.com/playwright:v* has all OS deps pre-installed
Global setup for auth — run login once in globalSetup, reuse storageState across workers
Fail fast, debug later — keep CI runs short; use trace viewer and HTML reports to investigate