Modern Web Guidance 1.0: tu agente de IA escribe la web de 2019 y esto lo arregla
(actualizado )
Tabla de contenidos
Pide a tu agente de IA un tooltip y es muy probable que te devuelva 80 líneas de JavaScript que calculan coordenadas con getBoundingClientRect(), escuchan scroll y resize y se pelean con el z-index. El navegador lo hace hoy con un atributo popover y tres propiedades de CSS. Modern Web Guidance existe para eso: es el paquete de skills que le enseña a tu agente lo que la plataforma web ya sabe hacer sola.
Desde el 10 de noviembre de 2026 está en su versión 1.0 estable. Y ha dejado de ser «una cosa de Chrome». La mantienen juntos los equipos de Chrome, Firefox, Edge y MDN, trae más de 200 guías y cada recomendación sale filtrada por Baseline, así que tu agente sabe qué puede usar según los navegadores que soportas.
Cuando lo contamos en mayo era una preview del Google I/O. Ahora es otra cosa, y creo que es de lo más útil que puedes instalarle a un agente si haces frontend.
Lo que vas a encontrar:
- Por qué tu agente escribe código web antiguo aunque sea un modelo de último año
- Qué cambia en la 1.0 respecto a la preview
- Un antes y después con un caso real (tooltip, modal y acordeón)
- Cómo instalarlo en Claude Code, Codex, Copilot CLI, Gemini CLI, Antigravity y el resto
- Cómo fijar el Baseline de tu proyecto en
CLAUDE.mdoAGENTS.md - El flujo de modernización para código que ya tienes escrito
- Los números que publica Google sobre cuánto mejora el resultado
El problema: tu agente programa con la web que vio entrenando ¶
Los modelos aprenden de millones de páginas escritas antes de que existieran popover, <dialog> con closedby, anchor positioning o @starting-style, así que repiten los patrones que más vieron: JavaScript a mano para todo. El modelo no es tonto. Está desactualizado por diseño.
Piensa en cuántos tutoriales de modales con div + position: fixed + listener de Escape hay en internet. Miles. ¿Y cuántos que usen <dialog> con showModal()? Muchos menos, y casi todos recientes. El modelo elige lo que más ha visto.
La documentación oficial de Chrome resume tres fallos de los agentes cuando escriben web:
- Tiran de soluciones antiguas: JavaScript donde ya hay una API de HTML o CSS que lo resuelve.
- No conocen las features nuevas: lo que salió después de su fecha de corte no existe para ellos.
- Ignoran tu soporte de navegadores: te meten algo que solo funciona en Chrome Canary o, al revés, te evitan algo que lleva dos años en todos los navegadores.
El tercero es el más traicionero. Puedes pedirle «usa CSS moderno» y te soltará una feature que en Safari no existe. O puedes no pedirle nada y vivirás con polyfills de 2018 para siempre.
🔑 Más código no es más trabajo hecho. Cada línea de JavaScript que sustituye a una feature nativa es una línea que mantener, que pesa en el bundle y que suele romper la accesibilidad que el navegador te daba gratis.
Qué es Modern Web Guidance 1.0 ¶
Modern Web Guidance es un conjunto de skills que mete conocimiento de plataforma web, buenas prácticas y datos de compatibilidad entre navegadores dentro de tu agente de código. Lo instalas una vez y el agente consulta las guías antes de escribir HTML, CSS o JavaScript de cliente.
Lo que cambia con la 1.0:
- Es un proyecto entre navegadores. El repositorio lo administran los equipos de Google Chrome, Microsoft Edge, Mozilla Firefox y MDN. Ya no es «lo que Chrome opina», es lo que opinan los que fabrican los motores y los que escriben la documentación de referencia.
- Más de 200 guías de casos de uso reales, frente a las «más de 100» de la preview.
- Baseline como regla, no como sugerencia: declaras tu target y el agente adapta lo que propone y cuándo añade fallback.
- Un buscador local con el que el agente encuentra la guía exacta sin cargar todas en el contexto.
- Flujo de modernización: le pides que revise un directorio y detecta patrones viejos en tu código existente.
- Instalación en casi cualquier agente: Claude Code (ya en el marketplace oficial de plugins), Codex, Copilot CLI, Gemini CLI, Antigravity, Goose, Grok, Kimi Code, WebStorm y cualquiera compatible con Agent Skills.
- Evals públicas: cada guía tiene tests con Playwright y hay un panel con resultados por agente y modelo.
Licencia abierta: el código es Apache-2.0 y el contenido de las guías CC-BY 4.0, con partes derivadas de MDN, W3C, WHATWG e IETF.
Antes y después: lo que cambia en el código ¶
La forma más rápida de entender la herramienta es ver lo que deja de escribir tu agente. Tres casos que verás en cualquier proyecto.
Un tooltip ¶
Lo que te suele dar un agente sin guía:
// Sin Modern Web Guidance: posicionamiento a mano
const btn = document.querySelector('.help-btn');
const tip = document.querySelector('.tooltip');
function place() {
const r = btn.getBoundingClientRect();
tip.style.top = `${r.top + window.scrollY - tip.offsetHeight - 8}px`;
tip.style.left = `${r.left + r.width / 2 - tip.offsetWidth / 2}px`;
}
btn.addEventListener('click', () => {
tip.classList.toggle('is-open');
place();
});
window.addEventListener('scroll', place);
window.addEventListener('resize', place);
document.addEventListener('click', (e) => {
if (!btn.contains(e.target) && !tip.contains(e.target)) {
tip.classList.remove('is-open');
}
});
// …y faltan Escape, el foco y que no se salga de la pantalla
Lo que propone con la guía cargada:
<button popovertarget="ayuda" class="help-btn">?</button>
<div id="ayuda" popover>Tu contraseña necesita 12 caracteres.</div>
.help-btn { anchor-name: --ayuda; }
#ayuda {
position-anchor: --ayuda;
position-area: block-start;
position-try-fallbacks: flip-block;
margin: 0.5rem;
}
popover te da la capa superior, el cierre con Escape y con clic fuera. Anchor positioning lo coloca junto al botón y le da la vuelta si no cabe. Cero JavaScript. Y si tu Baseline no cubre anchor positioning, la guía le dice al agente que añada el fallback en lugar de dejarlo roto.
Un modal ¶
<!-- Sin guía: div con role, trampa de foco casera y listener de Escape -->
<div class="modal" role="dialog" aria-modal="true" hidden>…</div>
<!-- Con guía -->
<dialog id="confirmar" closedby="any">
<form method="dialog">
<p>¿Borrar el proyecto?</p>
<button value="cancel">Cancelar</button>
<button value="ok">Borrar</button>
</form>
</dialog>
showModal() hace el fondo inerte, gestiona el foco y cierra con Escape. closedby="any" añade el cierre al pulsar fuera. Comprueba en tu Baseline este último atributo: precisamente para eso está la integración.
Un acordeón exclusivo ¶
<!-- Solo uno abierto a la vez, sin una línea de JavaScript -->
<details name="faq"><summary>¿Es gratis?</summary>Sí.</details>
<details name="faq"><summary>¿Funciona offline?</summary>Sí.</details>
El atributo name en <details> hace que abrir uno cierre los demás. Es el tipo de detalle que un modelo no conoce si no se lo cuentas.
💡 Si lo que más te preocupa es el CSS que escribe tu agente, mira también good-css y sus 47 técnicas de CSS moderno. Se complementan bien: una pone la plataforma y la otra el estilo.
Cada domingo contamos qué herramientas de IA estamos metiendo en proyectos reales y cuáles se quedan en la demo. Gratis, +7.500 developers y desde 2018.
Quiero esa dinamita 🧨Cómo instalarlo en tu agente ¶
La vía recomendada es la CLI oficial, que detecta tus agentes, instala las skills y las mantiene al día. Si prefieres el sistema de plugins de tu agente, también hay comando para cada uno.
# Instalación universal con wizard
npx modern-web-guidance@latest install
Si quieres elegir qué paquetes instalar:
npx modern-web-guidance@latest install --choose
Y para actualizar:
npx modern-web-guidance@latest update
El repositorio trae dos paquetes: modern-web-guidance, con las guías de plataforma web, y chrome-extensions, para quien construye extensiones con Manifest V3. El segundo solo tiene sentido si haces extensiones. Lo probé construyendo un cuentagotas para Chrome de principio a fin.
Claude Code ¶
Ya está en el marketplace oficial de plugins de Claude Code:
claude plugin install modern-web-guidance@claude-plugins-official
También puedes añadir el marketplace de Google desde una sesión:
/plugin marketplace add GoogleChrome/modern-web-guidance
/plugin install modern-web-guidance@googlechrome
/reload-plugins
Codex ¶
codex plugin marketplace add GoogleChrome/modern-web-guidance
codex plugin add modern-web-guidance@googlechrome
GitHub Copilot CLI ¶
/plugin marketplace add GoogleChrome/modern-web-guidance
/plugin install modern-web-guidance@googlechrome
Gemini CLI ¶
gemini extensions install https://github.com/GoogleChrome/modern-web-guidance --auto-update
Antigravity ¶
Desde la interfaz, actívalo durante la instalación o en Settings → Customizations → Build with Google Plugins. Desde la CLI:
agy plugin install https://github.com/GoogleChrome/modern-web-guidance
Si usas Antigravity, el análisis de Antigravity 2.0 cuenta cómo encajan plugins, subagentes y hooks.
El resto de agentes ¶
Cualquier agente compatible con el estándar Agent Skills (OpenCode, Cursor, Windsurf, Cline…) lo acepta con:
npx skills add GoogleChrome/modern-web-guidance
Y hay instalación propia para Goose, Grok, Kimi Code y el Skill Manager de WebStorm. Si el estándar de skills te pilla de nuevas, empieza por la guía completa de skills para programadores.
De usuario a autor
Las skills que aún no existen para tu stack las puedes escribir tú
Modern Web Guidance es una skill que busca y carga solo la guía que necesita. Con esta guía aprendes a escribir las tuyas con el mismo patrón y a cargarlas en Claude Code, Codex, Copilot, OpenCode o Gemini CLI.
Abrir la guía →Guía premium · Plantillas SKILL.md descargables
Fija tu Baseline: la línea que más impacto tiene ¶
Sin target, el agente asume Baseline Widely available; si declaras otro en tu CLAUDE.md o AGENTS.md, todas las propuestas se ajustan a él. Es una línea y es lo primero que yo haría después de instalarlo.
Baseline clasifica las features web en tres niveles:
| Nivel | Qué significa |
|---|---|
| Widely available | Funciona en los navegadores principales desde hace 30 meses o más |
| Newly available | Interoperable en todos los navegadores principales, pero desde hace menos de 30 meses |
| Limited availability | Todavía no está en todos los navegadores principales |
Para declarar tu target basta con escribirlo en el fichero de instrucciones del proyecto:
## Navegadores
This project's Baseline target is Baseline 2024.
Con eso, si una feature cae fuera de tu target, el agente te propone el fallback o carga el polyfill de forma condicional. Si te sirve Widely available (lo razonable para la mayoría de webs de clientes), no tienes que escribir nada.
Hay dos interruptores más, apagados por defecto, que se activan por proyecto y quedan guardados en un fichero .mwgrc:
# Permite guías sobre features que todavía están cambiando
npx modern-web-guidance@latest set-allow-volatile-features
# Permite features en origin trial (WebMCP, por ejemplo)
npx modern-web-guidance@latest set-allow-origin-trials
🛡️ Activa los origin trials solo en proyectos donde tengas controlado el navegador del usuario o sea un experimento. En producción, el target de Baseline es lo que te protege.
Cómo trabaja el agente por dentro ¶
La skill no mete 200 guías en el contexto: le enseña al agente a llamar a la CLI para buscar la guía adecuada y recuperar solo esa. Es lo que hace que funcione sin llenarte la ventana de contexto.
El ciclo es búsqueda y recuperación. El agente lanza algo así:
npx modern-web-guidance@latest search "animate a dialog modal backdrop"
La búsqueda corre en local (embeddings más BM25, sin llamadas de red) y devuelve un JSON con el id de cada guía, su descripción, categoría, las features que usa, cuántos tokens ocupa y la similitud con la consulta. Luego recupera la que encaja:
npx modern-web-guidance@latest retrieve <id-de-la-guia>
Y con esa guía en contexto, escribe el código.
Tú también puedes usar estos comandos sin agente. Te sirven para saber si tu caso está cubierto antes de pedírselo, o simplemente para aprender cómo se hace hoy algo que llevas años haciendo con JavaScript.
💡 La CLI envía telemetría anónima de uso. Si no la quieres:
export DISABLE_TELEMETRY=1.
El flujo de modernización: para el código que ya tienes ¶
La 1.0 trae un modo que revisa un directorio y detecta patrones antiguos en HTML, CSS, JavaScript y package.json. Hoy cubre un conjunto limitado de patrones con análisis estático; Google dice que irá sumando auditorías hechas por el agente.
Se lanza desde el agente:
/modern-web-guidance Modernize the code in this directory
¿Para qué sirve en la práctica? Para el proyecto heredado donde nadie se atreve a tocar los modales, para quitar dependencias que ya hace el navegador (librerías de tooltips, de scroll suave, de fechas con Temporal) o para preparar una auditoría de rendimiento.
También puedes pedirlo en tu idioma y con foco:
Usa Modern Web Guidance para revisar src/components.
Busca componentes que reimplementen con JavaScript algo que
HTML o CSS ya hacen (modales, tooltips, acordeones, selects).
Respeta el Baseline de CLAUDE.md. Dame la lista ordenada por
líneas de código que eliminaríamos y no toques nada todavía.
Google recomienda combinarlo con Chrome DevTools para agentes, que permite al agente abrir la página, medir y comprobar que el cambio funciona. Una cosa es que el código parezca moderno y otra que el LCP haya bajado.
Qué cubren las guías ¶
Las guías se agrupan por áreas: diseño visual, componentes y comportamientos de UI, experiencia de usuario, formularios, HTML, CSS, JavaScript, WebAssembly, rendimiento, accesibilidad, seguridad, privacidad, PWA, IA integrada y WebMCP. Las tres que más vas a notar si haces frontend son UI, formularios y rendimiento.
Un repaso rápido de lo que hay en cada bloque:
- UI (átomos, componentes y comportamientos): popovers, diálogos, selects personalizables, acordeones, carruseles con CSS, scroll-driven animations, view transitions entre páginas.
- Formularios: autofill de direcciones, pagos y login, validación accesible, estilizado del
<select>. - HTML y CSS: semántica, grid, subgrid, container queries, anchor positioning,
@layer,light-dark(), tamaño intrínseco. - JavaScript: lo moderno de la plataforma, como Temporal para fechas.
- Rendimiento: es el bloque más grande. LCP, INP y CLS, prioridad de imágenes,
scheduler.yield()para partir tareas largas, Speculation Rules para precargar páginas. - Seguridad: XSS, Content Security Policy, cookies, aislamiento cross-origin y los flujos completos de passkeys (registro, autenticación, gestión, creación condicional y reautenticación).
- Accesibilidad y privacidad: auditoría, foco y anuncios, minimización de datos y control de terceros.
- IA integrada en el navegador: Language Detector, Prompt API, Summarizer y Translator.
- WebMCP: formularios agénticos, herramientas en JavaScript y el estándar en sí.
Sobre WebMCP, un apunte: si quieres que los agentes del navegador usen tu web con herramientas estructuradas en lugar de adivinar el DOM, tienes una guía con código de WebMCP y el mapa de protocolos que conectan la IA con la web. Recuerda que WebMCP sigue en origin trial, así que la guía solo entra si activas set-allow-origin-trials.
Cada semana seleccionamos 12 recursos sobre IA aplicada al desarrollo y los suscriptores aportan los suyos. Una forma cómoda de seguir este cambio sin rastrear cinco newsletters.
Suscríbete gratis →¿Funciona de verdad? Los números que publican ¶
Según la documentación oficial, los primeros resultados muestran una mejora media de 37 puntos porcentuales en el cumplimiento de buenas prácticas modernas. Cada guía se evalúa con tests de Playwright calibrados contra una implementación de referencia que pasa el 100 % y otra con fallos que no pasa ninguno.
Hay un panel público de evals con resultados por agente y modelo, con y sin las skills. Merece la pena mirar el de tu combinación antes de fiarte de la media.
En el anuncio de la 1.0 también hay casos de empresas que lo han usado en producción:
- note inc.: la tasa de acierto pasó del 61 % al 94 % en 180 ejecuciones, y la prioridad del LCP mejoró un 28 % en 431 pull requests.
- Policybazaar: más de un 90 % menos de tiempo de respuesta y de bugs de UI, combinado con DevTools para agentes.
- WeTV: resuelve el 90 % de las comprobaciones de rendimiento fallidas y redujo un 87 % el tiempo de depuración.
- MetaMask: lo puso en un bot de revisión sobre unas 480 PR; comentó en 64 y se corrigieron 43 hallazgos.
Son números de los propios autores y sus partners, así que tómalos como lo que son. Lo que sí puedes hacer es medirlo tú en diez minutos.
Pruébalo en diez minutos ¶
Pide la misma tarea con y sin la skill en un proyecto de prueba y compara el diff. Es la forma más honesta de decidir si se queda.
- Crea una carpeta vacía y pídele al agente: «Haz una página con un botón de ayuda que muestre un tooltip, un modal de confirmación y un FAQ donde solo se abra una pregunta a la vez».
- Guarda el resultado y cuenta las líneas de JavaScript.
- Instala Modern Web Guidance, añade tu Baseline a
CLAUDE.mdoAGENTS.mdy repite la petición en otra carpeta. - Compara. Fíjate en tres cosas: líneas de JavaScript, si el teclado funciona sin que lo pidas y si hay fallback donde tu Baseline lo exige.
Si haces frontend, apuesto a que se queda instalado.
FAQ sobre Modern Web Guidance ¶
¿Qué es Modern Web Guidance?
Un conjunto de skills para agentes de código que les da conocimiento actualizado de la plataforma web, buenas prácticas y datos de compatibilidad de Baseline. Lo mantienen los equipos de Chrome, Firefox, Edge y MDN.
¿Qué cambia en la versión 1.0?
Es la versión estable, publicada el 10 de noviembre de 2026. Pasa a ser un proyecto entre navegadores, sube a más de 200 guías, añade el flujo de modernización, el buscador local y amplía la instalación a Codex, Gemini CLI, Goose, Grok, Kimi Code y WebStorm, además del marketplace oficial de Claude Code.
¿Es gratis?
Sí. El código es Apache-2.0 y las guías CC-BY 4.0. Está en GitHub.
¿Cómo le digo al agente qué navegadores soporto?
Escribe tu target de Baseline en CLAUDE.md o AGENTS.md, por ejemplo «This project’s Baseline target is Baseline 2024». Si no pones nada, usa Baseline Widely available.
¿Es un servidor MCP?
No. Se distribuye como skill y como plugin. El agente llama a la CLI modern-web-guidance para buscar y recuperar guías. WebMCP aparece como categoría de guías, no como forma de instalación.
¿Me llena el contexto?
No. El agente busca con search, que corre en local, y recupera solo la guía que necesita con retrieve.
¿Sirve para código que ya tengo?
Sí, con el flujo de modernización: /modern-web-guidance Modernize the code in this directory. Por ahora detecta un conjunto limitado de patrones con análisis estático.
¿Funciona con React, Vue o Svelte?
Sí, porque las guías son de plataforma web: un <dialog> o un popover funcionan igual dentro de un componente. Para convenciones de tu framework, combínalo con una skill específica.
¿Sustituye a MDN?
No. MDN participa en el proyecto y parte de las guías salen de su contenido. MDN es la referencia para ti; Modern Web Guidance es la forma de que tu agente la aplique sin que se lo recuerdes en cada prompt.
¿Cómo contribuyo?
El código fuente de las guías está en GoogleChrome/modern-web-guidance-src, con su CONTRIBUTING.md.
Fuentes ¶
- Modern Web Guidance (Chrome for Developers)
- Modern Web Guidance 1.0, anuncio de la versión estable
- Get started (Chrome for Developers)
- Explore skills (Chrome for Developers)
- Repositorio GoogleChrome/modern-web-guidance
- Panel de evals
- Baseline (web.dev)
🧨 Última oportunidad para recibir la dinamita que mereces sobre programación con IA el próximo domingo: suscríbete gratis a Web Reactiva en https://webreactiva.com/newsletter
12 recursos para developers cada domingo en tu bandeja de entrada
Además de una skill práctica bien explicada, trucos para mejorar tu futuro profesional y una pizquita de humor útil para el resto de la semana. Gratis.