O que é Modern Web Guidance?
Modern Web Guidance é um conjunto de skills para agentes mais uma pequena ferramenta de linha de comando da equipe do Google Chrome. Quando um agente de código pega uma tarefa web, a skill manda ele rodar `modern-web-guidance search`, que compara o pedido com um índice local de guias, e depois `retrieve` para trazer o guia escolhido para o contexto: padrões de código, peculiaridades dos navegadores e alternativas para recursos como a Popover API, anchor positioning, view transitions, container queries e `scheduler.yield()`. O README lista 262 recursos web e 204 guias de casos de uso; a documentação arredonda para mais de 200.
A versão 1.0 saiu em 10 de novembro de 2026, depois de uma prévia no Google I/O em maio, e a 1.0.1 veio em 16 de novembro. Com a 1.0, Firefox e Edge se juntaram ao Chrome no projeto, e o README também cita a equipe do MDN como responsável. As recomendações trazem dados de compatibilidade do Baseline, um comando `legacy-scan` procura padrões ultrapassados em um código existente e um painel de avaliações publica taxas de acerto com e sem a skill. O código é Apache-2.0; o texto dos guias, CC BY 4.0.
Modern Web Guidance vale a pena?
Agentes de código escrevem código web a partir dos dados de treino, e a maior parte desses dados é antiga: um modal em JavaScript onde `<dialog>` bastaria, um listener de rolagem onde uma animação CSS guiada pela rolagem seria mais leve. Esta skill ataca essa lacuna com busca, não com um prompt longo. O arquivo da skill custa cerca de 205 tokens; os guias só entram no contexto quando o agente procura um, e a busca roda offline com um modelo embutido mais BM25, sem chave de API.
As evidências são melhores do que as da maioria das skills. Os autores testam cada guia em tarefas sobre dois apps de exemplo, com avaliadores Playwright calibrados para aprovar toda solução de referência e reprovar o app sem alterações. No retrato de 8 de novembro do README, o Claude Code com Opus 5.5 passou em 57% de 1.801 verificações em 215 tarefas sem a skill e em 88% com ela, um ganho de 31 pontos; o Codex com GPT-6.1 foi de 54% para 82%, e o Antigravity com Gemini 4 de 58% para 94%. São benchmarks do próprio projeto nos próprios apps, então trate o tamanho do ganho como um teto, mas o método é publicado e o painel é público.
Os guias também tentam impedir que os agentes corram atrás de novidade. Cada um traz dados do Baseline, para que o conselho se ajuste aos navegadores que você atende, e os guias de APIs em Origin Trial ou de recursos lançados em um só motor nos últimos 3 meses ficam bloqueados no `retrieve` a menos que você libere em um arquivo `.mwgrc`. Nas alternativas, código próprio pequeno, com menos de 50 linhas, vem antes de polyfills pesados.
O porém: o Google coleta dados de uso a menos que você defina `DISABLE_TELEMETRY=1`. Isso inclui contagens de instalação, o nome do agente que chama, os IDs dos guias buscados e as consultas que o agente escreve, mas não seus prompts brutos. O fluxo de modernização `legacy-scan` é estreito de propósito na 1.0 e identifica, por análise estática, um conjunto limitado de padrões. E se você instalou pelo marketplace claude-plugins-official da Anthropic, sua cópia ficou presa na v0.0.194 de 12 de outubro; o README orienta trocar para o marketplace googlechrome.
Nossa opinião: para quem deixa um agente escrever código front-end, isto está mais perto de um guia de estilo feito pelos fabricantes de navegadores do que de mais um pacote de prompts, e desligar a telemetria é trabalho de uma linha.
Onde ele se destaca
Um desenvolvedor front-end na equipe de uma agência
Impedir que o agente construa tooltips e modais do zero em JavaScript
Instale a skill e peça o componente como de costume; o agente busca nos guias, encontra o da Popover API ou de anchor positioning e escreve código nativo com uma alternativa ajustada aos seus navegadores-alvo.
Um tech lead de um site de marketing de cinco anos
Achar polyfills e gambiarras de que os navegadores não precisam mais
Rode `npx modern-web-guidance@latest legacy-scan .` para um relatório estático e depois peça ao agente para modernizar os arquivos apontados com os guias correspondentes. A cobertura é limitada na 1.0, então espere uma lista parcial.
Uma especialista em acessibilidade em um fornecedor do setor público
Fazer formulários e diálogos escritos pelo agente acertarem foco, movimento reduzido e validação
Os guias voltados ao usuário foram revisados com tecnologias assistivas para a 1.0; combiná-los com uma auditoria humana pega o ARIA ruim que, segundo a equipe do Chrome, os modelos ainda produzem.
Antes de decidir
- Configuração
- `npx modern-web-guidance@latest install` abre um assistente. No Claude Code: `/plugin marketplace add GoogleChrome/modern-web-guidance` e depois `/plugin install modern-web-guidance@googlechrome`. Também instala via `npx skills add`, `gh skill install`, Codex, Copilot CLI e Antigravity.
- Integrações
- Claude Code, Codex, Cursor e outros hosts de Agent Skills, GitHub Copilot CLI, Antigravity, Grok Build CLI e Kimi Code. Um segundo pacote de skills cobre extensões do Chrome; o Chrome DevTools for agents complementa para verificar no navegador ao vivo.
- Dados e privacidade
- Busca e recuperação rodam localmente, sem chamadas de rede para o conteúdo. Telemetria anônima (instalações, nome do agente, IDs de guias, consultas) vai para o Google a menos que `DISABLE_TELEMETRY=1` esteja definido; prompts brutos não são coletados.
- Custo em escala
- Não há plano pago. O custo são os tokens dos guias que o seu agente busca; a skill base tem cerca de 205 tokens e o pacote de extensões do Chrome cerca de 175.
- Limites
- Recursos em Origin Trial e voláteis de um só motor ficam bloqueados até serem liberados em `.mwgrc`. O legacy-scan usa só correspondência estática de padrões. Instalações feitas pelo claude-plugins-official ficaram presas na v0.0.194.
O que é bom
- Mantida pelo Chrome com participação de Edge, Firefox e MDN
- Avaliações publicadas com taxas de acerto com e sem guia
- Busca offline; guias carregam só quando necessários
- Conselhos baseados no Baseline, com APIs experimentais bloqueadas
O que não é
- Telemetria de uso ligada por padrão
- Benchmarks feitos pelos autores nos próprios apps de exemplo
- legacy-scan cobre um conjunto limitado de padrões na 1.0
- Cópias do marketplace oficial do Claude não recebem mais atualizações
Ideal para
Equipes de front-end que deixam agentes de código escrever HTML, CSS e JavaScript e querem que eles usem recursos atuais da plataforma com alternativas sensatas para cada navegador.
Alternativas ao Modern Web Guidance
Modern Web Guidance: perguntas frequentes
- Modern Web Guidance vale a pena?
- Modern Web Guidance é aquela skill de agente rara, apoiada por fabricantes de navegadores e por resultados medidos, e o principal que você precisa saber antes de instalar é que a telemetria vem ligada por padrão. Damos nota 4.4 de 5.
- Quanto custa Modern Web Guidance?
- Gratuito e de código aberto (código Apache-2.0, guias CC BY 4.0). O uso do modelo é cobrado pelo provedor do seu agente de código.
- Quais são as desvantagens de Modern Web Guidance?
- Telemetria de uso ligada por padrão; benchmarks feitos pelos autores nos próprios apps de exemplo; legacy-scan cobre um conjunto limitado de padrões na 1.0; cópias do marketplace oficial do Claude não recebem mais atualizações.
- Para quem Modern Web Guidance é indicado?
- Equipes de front-end que deixam agentes de código escrever HTML, CSS e JavaScript e querem que eles usem recursos atuais da plataforma com alternativas sensatas para cada navegador.
- Quanto custa Modern Web Guidance para uma equipe ou em produção?
- Não há plano pago. O custo são os tokens dos guias que o seu agente busca; a skill base tem cerca de 205 tokens e o pacote de extensões do Chrome cerca de 175.
- Modern Web Guidance é seguro para dados da empresa?
- Busca e recuperação rodam localmente, sem chamadas de rede para o conteúdo. Telemetria anônima (instalações, nome do agente, IDs de guias, consultas) vai para o Google a menos que `DISABLE_TELEMETRY=1` esteja definido; prompts brutos não são coletados.
- Quais são as melhores alternativas ao Modern Web Guidance?
- As alternativas mais próximas que analisamos são Agent Skills (Addy Osmani), Google Agent Skills e Anthropic Skills.
Respostas verificadas em 20 de nov. de 2026.