安裝
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 會跳出瀏覽器。未寫到的錄製目標、選擇器與截圖路徑不能當成安全結論。