Skip to content

Playwright is a framework for Web Testing and Automation. It allows testing Chromium, Firefox and WebKit with a single API.

chore(cli): iterate over skills (#39276)

Pavel Feldmanf717fe5abc63
diff --git a/packages/playwright/src/skill/SKILL.md b/packages/playwright/src/skill/SKILL.md
index 29182e7630..11bad2b874 100644
--- a/packages/playwright/src/skill/SKILL.md
+++ b/packages/playwright/src/skill/SKILL.md
@@ -17,7 +17,7 @@ playwright-cli goto https://playwright.dev
playwright-cli click e15
playwright-cli type "page.click"
playwright-cli press Enter
-# take a screenshot
+# take a screenshot (rarely used, as snapshot is more common)
playwright-cli screenshot
# close the browser
playwright-cli close
@@ -155,14 +155,7 @@ playwright-cli video-start
playwright-cli video-stop video.webm
```
-### Install
-
-```bash
-playwright-cli install --skills
-playwright-cli install-browser
-```
-
-### Configuration
+## Open parameters
```bash
# Use specific browser when creating session
playwright-cli open --browser=chrome
@@ -186,7 +179,24 @@ playwright-cli close
playwright-cli delete-data
```
-### Browser Sessions
+## Snapshots
+
+After each command, playwright-cli provides a snapshot of the current browser state.
+
+```bash
+> playwright-cli goto https://example.com
+### Page
+- Page URL: https://example.com/
+- Page Title: Example Domain
+### Snapshot
+[Snapshot](.playwright-cli/page-2026-02-14T19-22-42-679Z.yml)
+```
+
+You can also take a snapshot on demand using `playwright-cli snapshot` command.
+
+If `--filename` is not provided, a new snapshot file is created with a timestamp. Default to automatic file naming, use `--filename=` when artifact is a part of the workflow result.
+
+## Browser Sessions
```bash
# create new browser session named "mysession" with persistent profile
@@ -204,6 +214,15 @@ playwright-cli close-all
playwright-cli kill-all
```
+## Local installation
+
+In some cases user might want to install playwright-cli locally. If running globally available `playwright-cli` binary fails, use `npx playwright-cli` to run the commands. For example:
+
+```bash
+npx playwright-cli open https://example.com
+npx playwright-cli click e1
+```
+
## Example: Form submission
```bash