本技能只负责 agent-browser 的安装与配置，浏览器可用性属于 $wsl2-browser-setup 技能的范围。若 WSL2 内的原生 Linux Chrome 尚不能正常浏览和登录，或 WSL2 无法通过 /json/version 访问 Windows 宿主浏览器桥接，应先使用 $wsl2-browser-setup。
新机器上先由 AI 直接执行两条非交互命令：npm install -g agent-browser 与 agent-browser install。随后由人工运行交互式命令 npx skills add vercel-labs/agent-browser，完成后继续执行运行时安装脚本：bash "${CODEX_HOME:-$HOME/.codex}/skills/agent-browser-wsl2-setup/scripts/setup-agent-browser-runtime.sh"，该脚本会按需安装 agent-browser、运行 agent-browser install，并在缺失时克隆 vercel-labs/agent-browser 仓库。
模式 A（原生 WSL 浏览器）：用 agent-browser doctor --offline --quick、agent-browser open https://example.com 和 agent-browser snapshot -i -c 直接测试。若手动浏览正常但 agent-browser 仍卡住，应停止在此处调试并改用模式 B。
模式 B（Windows 宿主浏览器桥接）：将 agent-browser 连接到已有 CDP 端点，运行 bash "${CODEX_HOME:-$HOME/.codex}/skills/agent-browser-wsl2-setup/scripts/connect-windows-browser.sh" --session windows-host --bridge-port 9333，然后使用 agent-browser --session windows-host get title 与 agent-browser --session windows-host snapshot -i -c 验证。
此外，scripts/setup-agent-browser-wsl2.sh 作为旧版一体化包装脚本保留兼容，但推荐使用拆分后的两个技能。捆绑资源还包括 references/architecture.md（浏览器设置与 agent-browser 设置的边界）、references/troubleshooting.md（agent-browser 自身故障）和 references/dead-ends.md（应避免的耦合错误）。具体平台限制与效果资料未提供更多细节。