安装
npm install -g @playwright/cli@latest适合谁
这份指南面向需要 Playwright CLI，并希望给编程 Agent 装上配套 SKILLS 的开发者。官方把它写成 Playwright CLI with SKILLS。
动手前请确认本机是 Node.js 18 or newer。页面还写需要 Claude Code、GitHub Copilot，或任何其他 coding agent；这是运行面说明，不是排他名单，也不要把全局 npm 安装推广成未出现的市场插件。
CLI 默认 headless。只有在你明确要把浏览器打开时，才给 open 加 --headed。第一次不要对未确认的网址执行打开或录制。
3 分钟完成第一次尝试
只采用页面给出的推荐安装命令：
npm install -g @playwright/cli@latest
前置条件：Node.js 18 或更新，并且当前环境有可用的 coding agent。安装位置是全局 npm 包 @playwright/cli，不要改写成未出现的另一安装器。
副作用确认点：这条命令会向全局环境写入 CLI。若你不打算改这台机器的全局包，先停下来。确认后再执行。安装成功后，若还需要本地技能文件，再运行页面给出的 playwright-cli install --skills；这是安装之后的技能落盘，不是第二套主安装器。它会写入技能文件，执行前同样先确认当前项目/Agent 目录。
成功信号：全局命令可用，并且（若你执行了）--skills 正常结束。接着只做核对：在 Agent 里确认它识别到 Playwright CLI 技能，或在终端确认 CLI 已安装。不要急着 open 网站、录制脚本或截图。若准备使用 open，先记住默认无头；只有要看见浏览器时才加 --headed，并先确认目标地址。
使用案例
案例一：全局安装官方 CLI。确认 Node.js 18+ 后运行 npm install -g @playwright/cli@latest。证据覆盖的是这句安装命令，以及“Playwright CLI with SKILLS”。完成标准止于全局包安装成功。不要补写卸载或指定镜像源等未出现步骤。
案例二：把技能装到本地，并理解无头默认。在 CLI 已安装后运行 playwright-cli install --skills。证据写明本地技能用这条命令安装；另写明 CLI 默认 headless，若想看见浏览器，给 open 传 --headed。第一次的成功信号是 --skills 完成、Agent 能看到技能。摘录没有给出 open 的网址，因此不要编造 URL，也不要把 --headed 当成默认行为。
使用边界
主安装路径只有 npm install -g @playwright/cli@latest。playwright-cli install --skills 是技能落盘，不是并列市场安装。需要 Node.js 18+。列出的 Agent 不是唯一支持范围。默认无头；open 加 --headed 会弹出浏览器。未写到的录制目标、选择器与截图路径不能当成安全结论。