In short
AI coding agents write a lot of yesterday's web code. Modern Web Guidance is a free set of skills that teaches them today's: native dialogs instead of modal libraries, passkeys instead of hand-rolled helpers, and a fallback for every browser that needs one.
It is published by the Chrome team and, according to its README, stewarded by Google Chrome, Microsoft Edge, Mozilla Firefox and MDN with the web community. Version 1.0 shipped on 10 November 2026. It works inside Claude Code, Codex, Cursor, GitHub Copilot and other agents.
Why agents get it wrong
Language models learn from the code that already exists, and most of it was written before today's browser features existed. So an agent asked for a modal reaches for a fixed overlay, a click-outside handler and a focus trap, when the browser has had a native <dialog> for years. Chrome's team calls these “AI knowledge gaps” and has catalogued hundreds of them.
How it works
The guidance installs as a skill in your coding agent, plus a command-line tool. Before writing code, the agent searches for the guide that matches the task, loads only that guide into its context and follows it. The guides are short on purpose: Chrome runs evals to cut anything models already know.
What changes
Chrome published the ten mistakes it sees most often. Custom overlays become <dialog> and popover; JavaScript blur validation becomes :user-invalid; touch listeners with custom physics become CSS Scroll Snap; setTimeout() queues become scheduler.yield(); hand-rolled sanitizers become setHTML(). Less code, fewer libraries, and behaviour the browser keeps accessible for you.
Safe for every browser
Modern doesn't mean broken in older browsers. Features that only add polish are simply ignored where they aren't supported; anything critical gets a small fallback (under 50 lines) or a polyfill loaded only when needed. Compatibility comes from the Baseline project's live data, and experimental features stay off until you opt in.
What it covers
262 modern web features and 204 real-world use cases: accessibility, CSS, forms, HTML, JavaScript, performance, privacy, installable web apps, security and passkeys, UI components and behaviours, visual design, WebAssembly, the browser's built-in AI and WebMCP for AI agents.
Modernize old code
Version 1.0 can also look at code you already have. It scans HTML, CSS, JavaScript and package.json for safe upgrades, then the agent applies them. The first release uses static analysis on a limited set of patterns, so treat its suggestions as a review checklist, not an autopilot.
Does it work
Every guide defines expectations that the code should meet. Chrome gives the same prompt to an agent with and without the guidance and checks both results. As of 9 Nov 2026, unguided agents passed about 52% of the checks and guided agents about 91%. These are Chrome's own numbers, published on a public dashboard.
Reported results
Early teams report big gains. WeTV (Tencent) put a coding agent in its release pipeline with Chrome DevTools for agents to find performance regressions and Modern Web Guidance to fix them: it now resolves 90% of failed performance checks on its own, and the time to fix fell from four hours to 30 minutes. Results like these depend on the team and the codebase.
Install
You need Node.js. The installer asks which coding agent you use. It is also listed in the plugin marketplaces of Claude Code, Codex, Cursor, Antigravity, GitHub Copilot, WebStorm, Kimi Code and Grok Build.
Install
npx modern-web-guidance@latest installInteractive wizard: picks your coding agent and installs the skills.
Update
npx modern-web-guidance@latest updateBring an existing installation up to date.
Search
npx modern-web-guidance@latest search "animate a dialog modal backdrop"Find the guide for a task.
Scan a project
npx modern-web-guidance@latest legacy-scan .List legacy patterns worth modernizing.
In your agent
/modern-web-guidance Modernize the code in this directoryAsk the agent to modernize the current directory.
What it means for your website
Modern platform code is lighter, faster and more accessible: less JavaScript to download, native components that keyboards and screen readers already understand, and security features such as passkeys and safe HTML handling built in. If your site or app was built a few years ago, a modernization pass is often the cheapest speed and accessibility win available.
We build with modern web APIs by default. See how we build websites or ask us to review yours.
FAQ
What is Modern Web Guidance?
A set of skills and a command-line tool for AI coding agents, published by the Chrome team and stewarded with Microsoft Edge, Mozilla Firefox and MDN. It gives agents expert-reviewed guides on modern web features and browser compatibility, so they use the platform's own APIs instead of the legacy patterns that dominate their training data.
Which coding agents does it work with?
It installs through its CLI (npx modern-web-guidance@latest install) and through the plugin marketplaces of Claude Code, Codex, Cursor, Antigravity, GitHub Copilot, WebStorm, Kimi Code and Grok Build.
Does it actually improve the code?
In Chrome's own eval suite, agents passed about 52% of the checks without it and about 91% with it (as of 9 Nov 2026), a gain of 39 points. Each guide defines expectations, and the same prompt is run with and without the guidance. These are Chrome's figures; test it on your own codebase too.
What does it cover?
262 modern web features and 204 real-world use cases across accessibility, CSS, forms, HTML, JavaScript, performance, privacy, PWAs, security, UI components and behaviours, visual design, WebAssembly, built-in AI and WebMCP.
Is it safe to use new APIs if some visitors have older browsers?
The guides favour progressive enhancement: purely additive features are simply ignored by older browsers, and critical behaviour gets a small fallback (under 50 lines) or a polyfill loaded only when needed. Compatibility comes from the Baseline project's live data, and experimental features stay off until you opt in.
Can it update an existing website?
Yes. Version 1.0 adds a modernization workflow that scans HTML, CSS, JavaScript and package.json for safe upgrades. The first release uses static analysis on a limited set of patterns, so review its suggestions like any other change.
Is it free?
Yes. It is open source under the Apache 2.0 licence.
Sources
Figures and examples on this page come from these sources, checked on 19 November 2026.
- Modern Web Guidance on GitHub (README)GoogleChrome ↗
- Modern Web Guidance 1.0: the web platform expertise your coding agent is missingChrome for Developers ↗
- Top 10 things AI gets wrong in web developmentChrome for Developers ↗
- Beyond code generation: using Modern Web Guidance for continuous developer learningChrome for Developers ↗
- ICYMI: Modern Web Guidance is now stableChrome for Developers ↗
- Modern Web Guidance documentationChrome for Developers ↗
- Eval dashboardGoogleChrome ↗
- Source repository and issuesGoogleChrome ↗