community skill
Playwright CLI
Microsoft playwright-cli 的浏览器自动化 skill，让 agent 通过命令行执行 Playwright 页面交互、测试调试、截图、会话管理、网络 mock、trace 和视频录制。
communityskill packagebrowser-automationplaywrighttestingclidebugging
Playwright CLI
Playwright CLI 是 Microsoft playwright-cli 仓库中的浏览器自动化 skill。它让 agent 通过命令行执行 Playwright 浏览器操作、页面测试、截图、会话管理、网络 mock、trace 和视频录制，比把完整浏览器工具 schema 或大型 accessibility tree 放进上下文更轻量。
来源
- 上游 skill 目录：https://github.com/microsoft/playwright-cli/tree/main/skills/playwright-cli
- 上游 SKILL.md：https://github.com/microsoft/playwright-cli/blob/main/skills/playwright-cli/SKILL.md
- 上游仓库：https://github.com/microsoft/playwright-cli
- 许可证：Apache-2.0
适合什么时候用
- 需要让 coding agent 用 CLI 自动化浏览器，测试页面交互、表单、导航和多标签页流程。
- 需要通过 Playwright snapshot 获取元素 ref，再执行
click、fill、type、press、check等操作。 - 需要调试 Playwright 测试、生成测试代码、录制 trace 或视频，或检查 console / network 请求。
- 需要管理浏览器会话、cookies、localStorage、storage state，或为测试 mock 网络请求。
核心能力
| 场景 | 代表命令 | 用途 |
|---|---|---|
| 页面操作 | open、goto、snapshot、click、fill、press | 打开页面、获取元素 ref、执行交互 |
| 状态管理 | state-save、state-load、cookie-*、localstorage-* | 复用登录态和浏览器存储 |
| 调试观测 | console、requests、tracing-start、tracing-stop | 诊断前端错误、网络请求和执行轨迹 |
| 输出产物 | screenshot、pdf、video-start、video-stop | 保存截图、PDF 和操作视频 |
| 测试辅助 | generate-locator、run-code、route、unroute | 生成 locator、运行 Playwright 代码、mock 请求 |
安装提示
这是社区上游的完整 skill 目录，包含 SKILL.md 和多份 references/ 资料。本站只收录索引和中文说明，不镜像上游 skill 文件。站点详情页生成的安装命令会指向上游 skill 目录：
npx skills add https://github.com/microsoft/playwright-cli/tree/main/skills/playwright-cli
实际执行浏览器自动化还需要安装 Playwright CLI。上游 README 给出的安装方式为：
npm install -g @playwright/cli@latest
playwright-cli --help
如果希望把上游 skills 安装到本地 agent 环境，可运行：
playwright-cli install --skills
使用注意
playwright-cli默认 headless；需要可视化浏览器时在open中使用--headed。- 交互优先使用
snapshot返回的元素 ref，例如e15；必要时也可使用 CSS selector 或 Playwright locator。 - 多项目或并行任务应使用 session，例如
playwright-cli -s=todo-app open ...，避免互相污染浏览器状态。 - 持久化登录态或用户数据时注意 cookies、localStorage 和 profile 目录里的敏感信息。
- 命令参数、引用资料和可用能力以 Microsoft 上游仓库为准。