Con Modern Web Guidance, Claude Code con Opus 5.5 pasa del 57 % al 88 % de aserciones superadas en las 215 tareas web que usa Google para evaluarla. La skill, mantenida por el equipo de Chrome con Edge, Firefox y MDN, publicó la versión 1.0.0 de su CLI en npm el 10 de noviembre de 2026 y ese mismo día llegó a la portada de Hacker News con un Show HN de 278 puntos. Suma 3.342 estrellas en GitHub y 40.300 instalaciones en skills.sh.
Qué hace
El problema que ataca es conocido: los modelos se entrenan con años de JavaScript y CSS antiguos y, cuando les pides un modal o una tabla responsive, tiran de librerías y trucos de 2019 en lugar de <dialog>, la Popover API, anchor positioning o container queries. La skill mete en el contexto del agente guías escritas por expertos sobre 250 funciones de la plataforma web (140 de CSS y maquetación, 36 de HTML y DOM, 74 de JavaScript y APIs), con su soporte en navegadores según Baseline y la alternativa recomendada cuando la función aún no está en todos.
Su SKILL.md se declara obligatoria para cualquier tarea de HTML, CSS o JavaScript de cliente, y excluye a propósito el backend, la infraestructura y el tooling. El flujo tiene cuatro pasos:
- Buscar: el agente ejecuta
searchcon una consulta de 2 a 5 palabras sobre una sola capacidad ("light dismiss dialog", no "close React settings modal"). - Recuperar la guía con
retrieve, junto con la guía general de la disciplina (accesibilidad, rendimiento, formularios…). - Verificar el código generado contra la guía.
- Declarar al final de la respuesta una sección
### Modern Web Guidancecon cada guía aplicada y la regla concreta que evitó un error.
La búsqueda es local: un modelo de embeddings y BM25 incluidos en el paquete, sin llamadas a ninguna API ni claves. Hay además un modo legacy-scan para auditar un código existente, que solo cubre en torno al 20 % del catálogo (las guías con reglas deterministas). Las APIs en Origin Trial y las funciones "volátiles" (de un solo motor y con menos de tres meses) aparecen en la búsqueda, pero el agente no las recupera salvo que lo actives en un .mwgrc del proyecto.
Cómo instalarla y probarla
Sin instalar nada, puedes ver qué devuelve:
npx modern-web-guidance@latest search "animate a dialog modal backdrop"
npx modern-web-guidance@latest retrieve "animate-to-from-top-layer"
npx modern-web-guidance@latest legacy-scan .Para instalarla en Claude Code como plugin:
/plugin marketplace add GoogleChrome/modern-web-guidance
/plugin install modern-web-guidance@googlechromeTambién se instala con npx skills add GoogleChrome/modern-web-guidance, gh skill install o los comandos de plugins de Codex, Copilot CLI y Antigravity que lista el README.
Lo que pide y lo que arriesga
- Ejecuta código de npm en cada consulta. Cada búsqueda es un
npx -y modern-web-guidance@latest: tu agente descarga y ejecuta la última versión publicada sin preguntarte. El paquete no tiene dependencias (lo que reduce la superficie de cadena de suministro) y ocupa unos 16,5 MB desempaquetado, pero@latestsignifica confiar en cada publicación futura. La propia skill pide que en la lista de permisos autorices solonpx -y modern-web-guidance@latest *, nuncanpx *sin más. - Necesita red la primera vez para descargar el paquete; las búsquedas en sí son locales.
- No toca credenciales ni envía tu código a ningún servicio.
- Es insistente. La descripción de la skill dice "MANDATORY: Execute FIRST" para cualquier tarea de front. En un proyecto con mucha UI eso son varias llamadas y guías en el contexto por tarea, y un bloque extra al final de cada respuesta.
- No garantiza accesibilidad. Adrian Roselli, especialista en accesibilidad, probó el primer ejemplo de la documentación (un acordeón animado) y obtuvo código cuya animación no funcionaba en Firefox y que no cumplía WCAG. Su crítica de fondo: Baseline mide qué soporta cada navegador, no si las tecnologías de asistencia lo soportan. Esa revisión es de mayo de 2026 y el proyecto ha cambiado desde entonces, pero el argumento sigue en pie.
Frente a lo que ya había
| Modern Web Guidance | Biblioteca de patrones revisada | Sin guía | |
|---|---|---|---|
| Cómo llega al agente | Skill + CLI local | Documentación o componentes que copias | Lo que el modelo recuerde |
| Determinista | No: el agente elige qué guía usar | Sí | No |
| Al día con la plataforma | Se actualiza con cada versión del paquete | Depende de quien la mantenga | Fecha de corte del modelo |
| Evidencia de mejora | Evals públicas: +28 a +36 puntos | — | Línea base: 52–60 % |
Las evals del README son el mejor argumento: el 8 de noviembre de 2026, Antigravity con Gemini 4 Argon sube del 58 % al 94 %, Codex con GPT-6.1 Sol del 54 % al 82 % y Claude Code con Opus 5.5 del 57 % al 88 %. Son pruebas del propio equipo, con evaluadores de Playwright sobre aplicaciones de ejemplo, pero el panel es público.
Mi lectura: si tu agente escribe front, instálala, porque la diferencia frente a no tener nada es grande. Lo que no hace es sustituir a una biblioteca de componentes accesibles revisada: para un modal, un menú o un acordeón de producción, sigue siendo mejor partir de algo probado y usar la skill para que el resto del código no vuelva a 2019.
Fuentes
- GoogleChrome/modern-web-guidance (README y SKILL.md), GitHub.
- Show HN: Get your coding agent off ~2019 JavaScript, onto modern web primitives, Hacker News, 10 de noviembre de 2026.
- modern-web-guidance en skills.sh.
- modern-web-guidance en npm.
- Maybe Don't Rely on Google's "Modern Web Guidance", Adrian Roselli, 25 de mayo de 2026.