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 install

Interactive wizard: picks your coding agent and installs the skills.

Update

npx modern-web-guidance@latest update

Bring 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 directory

Ask 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.