这个 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?
- Claude 会现场生成并执行浏览器自动化代码,可访问任意 URL;使用前应了解目标站点内容
- Shell / 命令行
- 网络访问
- 本地文件系统
Node.js 20+npmPlaywrightChromium
推荐用 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(首次需要网络)。
tmp="$(mktemp -d)"
git clone --depth 1 https://github.com/lackeyjb/playwright-skill.git "$tmp"
mkdir -p ~/.claude/skills
cp -R "$tmp/skills/playwright-skill" ~/.claude/skills/
rm -rf "$tmp"根据源仓库地址和 Skill 路径自动生成,只复制这个 Skill 的文件夹。如果上文有作者提供的安装方式,请优先按作者说明操作;想只在当前项目中使用,把 ~/.claude/skills 换成项目里的 .claude/skills。
如何使用这个 Skill?
安装后,把下面任意一句发给 Agent 即可触发:
- 测试一下首页
- 在移动端和桌面端给仪表盘截图
- 填写注册表单并提交
- 检查死链
安装后直接用自然语言向代理下达浏览器任务,例如:"测试一下首页"、"在移动端和桌面端给仪表盘截图"、"填写注册表单并提交"、"检查死链"。代理会编写定制 Playwright 代码、通过 run.js 执行、返回控制台输出和截图。需要 Firefox 或 WebKit 时运行 npm run install-all-browsers;通过 PW_BROWSER、PW_HEADLESS、PW_ARTIFACT_DIR 等环境变量调整行为。完整 API(网络拦截、视频录制、设备仿真等)见 API_REFERENCE.md。
这个 Skill 有哪些优点和局限?
- 代理按需编写定制脚本,不局限于预置模板,可处理循环、断言、多上下文等真实程序需求
- 默认可见浏览器,便于实时观察自动化过程
- 自带 dev server 检测、Cookie 弹窗处理、截图等实用辅助函数
- run.js 执行器解决了脚本模块解析问题,支持脚本保存与复用
- 文档详尽,含完整 API 参考与渐进式加载设计
- 需要 Node.js 20+ 并在首次使用时联网下载 Playwright 与 Chromium
- Firefox/WebKit 需额外运行 install-all-browsers
- 源材料未提供测试套件或在 Claude Code 之外平台的验证证据
- 连接已有 Chrome 会话会获得用户的全部访问权限,处理敏感信息需谨慎
- 脚本默认写入临时目录,跨会话保留需手动设置 PW_SCRIPT_DIR
这个 Skill 与同类方案有什么区别?
与相关 Skills 并排比较;分数均按同一 FSRS 标准得出。
| Skill | FS 评分 | Star 数 | 最近更新 | License |
|---|---|---|---|---|
| Playwright 浏览器自动化技能 本页 | 68 · 推荐 | ★ 3.3k | 2 个月前 | MIT |
| playwright-cli 浏览器自动化技能 | 56 · 谨慎使用 | ★ 11k | 1 个月前 | MIT |
| Web 应用测试技能 | 49 · 谨慎使用 | ★ 3.1k | 8 个月前 | MIT |
| Playwright 浏览器自动化技能 ✓ OpenAI · 官方 | 52 · 谨慎使用 | ★ 28k | 4 个月前 | — |
| Playwright 浏览器自动化技能 ✓ Microsoft · 官方 | 46 · 谨慎使用 | ★ 99k | 7 天前 | Apache-2.0 |
README 明确区分了两个替代方案:Microsoft 官方的 @playwright/cli(适合简单的交互式浏览,可用 playwright-cli install --skills 安装其技能)和 playwright-mcp(基于可访问性快照的工具式浏览器控制)。本项目定位是"代码优先"选项——当自动化脚本本身就是要产出的成果时使用。
FollowSkills 如何评估这个 Skill?
让 Claude 现场编写并执行浏览器自动化脚本(默认非无头模式),可以打开任意 URL 并与页面交互;脚本限定写到 /tmp,不写入项目目录,风险面可控但本质是任意代码执行能力。
点击维度查看打分理由
证据充分度:低 — 主要依赖静态检查、作者材料或有限演示;适合发现线索,不适合做高风险决策。
本条评估按 FSRS 1.0 标准完成,维度分不做换算,已进入按 FSRS 2.0 重新评估的复核队列。
查看完整评分方法 →