How to roll Playwright dependency

Steps

1. Obtain latest Playwright version npm info playwright@next version

2. Update Playwright packages in package.json:

   • Update playwright and playwright-core (dependencies) and @playwright/test (devDependency) to the target version.
   • Run npm install to update package-lock.json.
   • Verify with npm ls playwright-core that the root playwright-core actually rolled — it is pinned directly in package.json and is what playwright-cli.js runs; forgetting it leaves the CLI on the old version while tests pass against the new @playwright/test.

3. Run the update script to sync skills and README:

   bash

   node scripts/update.js

   This script:

   • Runs node playwright-cli.js install --skills to regenerate skills from the new Playwright version.
   • Copies the generated skills from .claude/skills/playwright-cli/ into skills/playwright-cli/.
   • Cleans up the generated .claude/skills/ directory.
4. Update README.md with relevant changes from the updated skill at skills/playwright-cli/SKILL.md. Compare the skill file with the README and update any sections that are out of date (commands, flags, default behaviors, examples).

5. Verify the CLI works:

   bash

   node playwright-cli.js --help

6. Test the CLI:

   bash

   npm run test

7. Create a branch and commit:

   • Branch name: roll_<version> (e.g. roll_214)
   • Commit message: chore: roll Playwright to <version>
   • do not add Co-Authored-By

Key files