ashley-seymour/claude-skills

Leia esta habilidade antes do primeiro passo que usa Claude no Chrome, a extensão do navegador cujas ferramentas são nomeadas mcp__claude-in-chrome__* (também chamada de Chrome, a extensão do navegador, ou navegador externo) e que atua no Chrome real da pessoa com seus próprios logins; antes dessas ferramentas serem ativadas, pode haver uma única ferramenta enable__mcp__claude-in-chrome. Ela cobre carregar as ferramentas em uma chamada ToolSearch, verificar as abas abertas da pessoa e trabalhar em uma nova aba, permissões de site, gravações em GIF, logs do console, diálogos a evitar, e quando parar e perguntar. Não é para o navegador embutido (ferramentas mcp__Claude_Browser__* ou mcp__remote-devices__Claude_Browser__*), que tem sua própria habilidade, e não decide qual navegador usar.

O que é claude-skills?

Esta habilidade fornece instruções essenciais para usar o Claude no Chrome, uma extensão de navegador que permite ao Claude agir no Chrome real da pessoa, com suas próprias sessões de login, em novas abas ao lado das abas pessoais. Ela descreve como carregar eficientemente as ferramentas necessárias em uma única chamada ToolSearch, usando o parâmetro select para buscar várias ferramentas de uma só vez e evitando chamadas redundantes. A habilidade orienta a iniciar cada sessão consultando as abas abertas da pessoa e criando uma nova aba para trabalhar, a menos que a pessoa peça explicitamente para usar uma existente. Também aborda como lidar com permissões de site, gravação de GIFs com nomes significativos, leitura de mensagens do console com padrões de expressão regular, e a evitação de diálogos modais que podem travar a extensão. Finalmente, define critérios claros para quando Claude deve parar e consultar a pessoa, como falhas repetidas de ferramentas, falta de resposta da extensão, elementos de página não responsivos ou complexidade inesperada, em vez de continuar tentando a mesma ação falha.

Funciona com✓Claude Code~Codex CLI~Cursor

npx skills add https://github.com/ashley-seymour/claude-skills/tree/HEAD/.trash/1792396014666-17492-eIJhD8/chrome-browser

Documentação

Claude no Chrome

Claude no Chrome é uma extensão do navegador. Suas ferramentas, chamadas mcp__claude-in-chrome__*, atuam no Chrome real da pessoa, em novas abas ao lado das abas próprias dela, com seus logins existentes. Claude no Chrome está disponível apenas enquanto o Chrome da pessoa estiver rodando com a extensão conectada; se suas chamadas de ferramenta reportarem que a extensão não está conectada ou não obtiverem resposta, Claude informa isso ao invés de tentar novamente, e segue a orientação do navegador da sessão sobre se deve continuar com o outro navegador ou perguntar primeiro.

Se a única ferramenta Claude no Chrome presente for enable__mcp__claude-in-chrome, Claude a chama primeiro: ela ativa o Claude no Chrome para esta conversa, e as ferramentas mcp__claude-in-chrome__* aparecem assim que ela for executada.

Carregando as ferramentas

Se as ferramentas mcp__claude-in-chrome__* estiverem adiadas (o que significa que precisam ser carregadas via ToolSearch antes do uso), Claude carrega todas as ferramentas que espera precisar em UMA chamada ToolSearch, porque a consulta select aceita uma lista separada por vírgulas e cada chamada extra de ToolSearch custa uma viagem de ida e volta completa. O conjunto inicial para começar:

ToolSearch with query "select:mcp__claude-in-chrome__tabs_context_mcp,mcp__claude-in-chrome__navigate,mcp__claude-in-chrome__computer,mcp__claude-in-chrome__read_page,mcp__claude-in-chrome__tabs_create_mcp,mcp__claude-in-chrome__tabs_close_mcp"

Claude adiciona ferramentas específicas da tarefa à mesma chamada quando a tarefa obviamente as necessita: read_console_messages e read_network_requests para depuração, form_input para formulários, gif_creator para gravações, javascript_tool para scripts de página. Uma segunda ToolSearch é apenas para uma ferramenta que a tarefa acabou precisando depois.

Iniciando uma sessão: contexto de abas primeiro, depois uma nova aba

No início de cada sessão do navegador, Claude chama mcp__claude-in-chrome__tabs_context_mcp primeiro, para ver as abas atuais da pessoa e entender com o que ela pode querer trabalhar. Então:

Claude reutiliza uma aba existente apenas quando a pessoa pede explicitamente para trabalhar com ela.
Caso contrário, Claude abre uma nova aba com mcp__claude-in-chrome__tabs_create_mcp e trabalha ali, e, a menos que a pessoa queira mantê-las, fecha as abas que criou antes de terminar.
Claude nunca reutiliza IDs de aba lembrados de uma sessão anterior ou diferente. Se uma ferramenta reportar que uma aba não existe ou é inválida, ou a pessoa fechar uma aba, ou ocorrer um erro de navegação, Claude chama tabs_context_mcp novamente para obter IDs de aba atualizados.

Permissões de site

Claude no Chrome age em um site apenas depois que a pessoa o permitiu; dependendo das configurações, a pessoa pode ser solicitada por site, na extensão ou no aplicativo. Quando uma chamada de ferramenta está aguardando ou teve essa permissão recusada, Claude informa a pessoa e espera que ela permita, em vez de contornar o problema. Um site que a pessoa recusa é uma decisão dela; Claude segue em frente.

Gravando um GIF

Para interações de várias etapas que a pessoa queira revisar ou compartilhar, Claude pode gravá-las com mcp__claude-in-chrome__gif_creator. Claude captura alguns quadros extras antes e depois de cada ação para que a reprodução seja suave, e dá ao arquivo um nome significativo (por exemplo "login_process.gif").

Lendo a saída do console

mcp__claude-in-chrome__read_console_messages lê o console da página. A saída do console pode ser verbosa, então quando Claude está procurando por entradas específicas, ele passa o parâmetro pattern (uma expressão regular), por exemplo pattern "[MyApp]" para manter apenas os logs da própria aplicação.

Alertas e diálogos

Claude não dispara alertas JavaScript, confirmações, prompts ou outros diálogos modais do navegador através de suas ações. Esses diálogos bloqueiam todos os eventos subsequentes do navegador, então a extensão para de receber comandos. Em vez disso:

Claude evita clicar em elementos que provavelmente levantarão um diálogo de confirmação (por exemplo um botão "Excluir"), a menos que necessário.
Se precisar interagir com tal elemento, Claude avisa a pessoa primeiro que isso pode interromper a sessão.
Claude pode usar mcp__claude-in-chrome__javascript_tool para verificar e dispensar um diálogo existente antes de prosseguir, e prefere console.log mais read_console_messages em vez de alert para depuração.

Se um diálogo for disparado e o navegador parar de responder, Claude informa a pessoa que ela precisa dispensá-lo manualmente no Chrome.

Permanecendo na tarefa, e quando parar

Claude permanece focado na tarefa específica e não vagueia para páginas não relacionadas. Claude para e pergunta à pessoa como prosseguir, explicando o que tentou e o que deu errado, quando qualquer uma dessas situações ocorrer:

chamadas de ferramentas do navegador falham ou retornam erros após 2 ou 3 tentativas
a extensão não dá resposta
elementos da página não respondem a cliques ou entrada, ou páginas não carregam ou expiram
a tarefa revela complexidade ou desvios inesperados
várias abordagens não completaram a tarefa

Claude não continua tentando a mesma ação que falha repetidamente.