Playwright 浏览器自动化技能
让编程代理即时编写并执行 Playwright 脚本，覆盖网页测试、截图、登录流程与任意浏览器自动化任务。
让 Claude 现场编写并执行浏览器自动化脚本（默认非无头模式），可以打开任意 URL 并与页面交互；脚本限定写到 /tmp，不写入项目目录，风险面可控但本质是任意代码执行能力。
- Claude 会现场生成并执行浏览器自动化代码，可访问任意 URL；使用前应了解目标站点内容
这个 Skill 能做什么，适合哪些场景？
playwright-skill 是一个面向编程代理的 Agent Skill，让代理能根据用户需求现场编写并运行真实的 Playwright 代码，而非套用预置脚本。它自带通用执行器 run.js、开发服务器自动检测和一组可选辅助函数，默认使用可见浏览器。安装后需要执行一次 npm run setup 来安装 Playwright 与 Chromium。适合需要留存并复用自动化脚本的场景。
该技能让代理：读取 SKILL.md 中的工作流指令；用内置的 detectDevServers 辅助函数检测本机运行中的开发服务器；将一次性脚本写入系统临时目录（或通过 PW_SCRIPT_DIR 保留到项目目录）；通过 run.js 执行脚本以获得稳定的模块解析；产出页面截图、控制台输出等结果。支持截图、多视口响应式检查、登录流程（凭据来自环境变量）、链接检查、Cookie 弹窗处理、连接已有 Chrome 调试会话，以及通过环境变量配置浏览器类型、无头模式、额外 HTTP 头等。
- 开发者让代理测试本地项目：技能自动检测 localhost 上的开发服务器并验证页面加载、控制台错误等
- 前端工程师需要移动端与桌面端截图对比：代理用多视口脚本生成 full-page 截图
- 测试人员验证登录注册流程：代理用环境变量中的测试凭据走完整登录流并断言跳转后元素
- 维护者排查死链或图片加载问题：代理遍历页面执行链接与资源检查
- 需要在有登录态的浏览器里复用 Cookie 与扩展：代理通过 CDP 连接已有 Chrome 会话
这个 Skill 有哪些优点和局限？
- 代理按需编写定制脚本，不局限于预置模板，可处理循环、断言、多上下文等真实程序需求
- 默认可见浏览器，便于实时观察自动化过程
- 自带 dev server 检测、Cookie 弹窗处理、截图等实用辅助函数
- run.js 执行器解决了脚本模块解析问题，支持脚本保存与复用
- 文档详尽，含完整 API 参考与渐进式加载设计
- 需要 Node.js 20+ 并在首次使用时联网下载 Playwright 与 Chromium
- Firefox/WebKit 需额外运行 install-all-browsers
- 源材料未提供测试套件或在 Claude Code 之外平台的验证证据
- 连接已有 Chrome 会话会获得用户的全部访问权限，处理敏感信息需谨慎
- 脚本默认写入临时目录，跨会话保留需手动设置 PW_SCRIPT_DIR
如何安装这个 Skill？
推荐用 Vercel 的 skills CLI 安装：npx skills add lackeyjb/playwright-skill --skill playwright-skill --global --yes（加 --agent claude-code cursor 可指定目标代理）。也可作为 Claude Code 插件安装：/plugin marketplace add lackeyjb/playwright-skill 然后 /plugin install playwright-skill@playwright-skill。或从 GitHub Releases 下载，将 skills/playwright-skill/ 复制到 ~/.claude/skills/playwright-skill 或项目 .claude/skills/ 目录。无论哪种方式，安装后需在技能目录运行一次 npm run setup 安装 Playwright 和 Chromium（首次需要网络）。
如何使用这个 Skill？
安装后直接用自然语言向代理下达浏览器任务，例如："测试一下首页"、"在移动端和桌面端给仪表盘截图"、"填写注册表单并提交"、"检查死链"。代理会编写定制 Playwright 代码、通过 run.js 执行、返回控制台输出和截图。需要 Firefox 或 WebKit 时运行 npm run install-all-browsers；通过 PW_BROWSER、PW_HEADLESS、PW_ARTIFACT_DIR 等环境变量调整行为。完整 API（网络拦截、视频录制、设备仿真等）见 API_REFERENCE.md。
这个 Skill 与同类方案有什么区别？
README 明确区分了两个替代方案：Microsoft 官方的 @playwright/cli（适合简单的交互式浏览，可用 playwright-cli install --skills 安装其技能）和 playwright-mcp（基于可访问性快照的工具式浏览器控制）。本项目定位是"代码优先"选项——当自动化脚本本身就是要产出的成果时使用。