Instalar o Playwright CLI em global e depois adicionar SKILLS para o agent de código

Para quem

Este guia é para desenvolvedores que precisam do Playwright CLI e querem instalar as SKILLS correspondentes para um agent de código. Oficialmente está escrito como Playwright CLI with SKILLS.

Antes de começar, confirme que esta máquina é Node.js 18 or newer. A página também indica Claude Code, GitHub Copilot ou any other coding agent; isso é uma nota de execução, não uma lista exclusiva, e não generalize a instalação npm global para um plugin de marketplace que não aparece.

O CLI é headless por padrão. Só adicione --headed a open quando quiser ver o navegador de forma explícita. Na primeira tentativa, não abra nem grave um URL não confirmado.

Concluir a primeira tentativa em 3 minutos

Use apenas o comando de instalação recomendado indicado na página:

npm install -g @playwright/cli@latest

Pré-condição: Node.js 18 ou mais recente, e um coding agent utilizável no ambiente atual. O local de instalação é o pacote npm global @playwright/cli; não reescreva isso como outro instalador que não aparece.

Ponto de confirmação de efeitos colaterais: este comando grava o CLI no ambiente global. Se você não pretende alterar os pacotes globais desta máquina, pare primeiro. Confirme e depois execute. Após a instalação bem-sucedida, se ainda precisar de arquivos de skills locais, execute o playwright-cli install --skills da página; isso é a colocação de skills depois da instalação, não um segundo instalador principal. Ele grava arquivos de skills, portanto confirme também o diretório do projeto/agent atual antes de executar.

Sinal de sucesso: o comando global está disponível e (se você executou) --skills terminou normalmente. Em seguida, faça só uma conferência: no agent, confirme que ele reconhece as skills do Playwright CLI, ou no terminal que o CLI está instalado. Não se apresse a fazer open de um site, gravar um script ou tirar captura. Se for usar open, lembre primeiro que o padrão é headless; adicione --headed só quando quiser ver o navegador e confirme o endereço de destino antes.

Casos de uso

Caso 1: instalar o CLI oficial em global. Após confirmar Node.js 18+, execute npm install -g @playwright/cli@latest. A evidência cobre este comando de instalação e “Playwright CLI with SKILLS”. O critério de conclusão para na instalação bem-sucedida do pacote global. Não acrescente passos de desinstalação nem um registry espelho que não aparecem.

Caso 2: instalar skills localmente e entender o padrão headless. Com o CLI já instalado, execute playwright-cli install --skills. A evidência afirma que as skills locais são instaladas com este comando; também afirma que o CLI é headless por padrão e que, para ver o navegador, deve-se passar --headed a open. O sinal de sucesso da primeira tentativa é --skills ter concluído e o agent ver as skills. O trecho não dá um URL para open, portanto não invente um URL e não trate --headed como o comportamento padrão.

Limites de uso

O caminho principal de instalação é apenas npm install -g @playwright/cli@latest. playwright-cli install --skills é colocação de skills, não uma instalação de marketplace em paralelo. É necessário Node.js 18+. Os agents listados não são o intervalo exclusivo suportado. O padrão é headless; adicionar --headed a open mostra um navegador. Alvos de gravação, seletores e caminhos de captura não escritos não podem ser tratados como conclusão de segurança.