AI coding agents often write outdated web code. Ask for a pop-up menu or a smooth animation and they may produce dozens of lines of JavaScript when the browser can do the job with a few lines of HTML or CSS. To fix this habit, Google's Chrome team has released version 1.0 of Modern Web Guidance, an open-source skill bundle for the main coding agents.
The project collects more than 200 expert guides covering 250 web platform features. Each guide includes Baseline compatibility data and fallbacks for older browsers. According to the repository, installation takes a single command, npx modern-web-guidance@latest install, while Claude Code, Copilot CLI and Antigravity have plugin-marketplace installs.

Image: Chrome for Developers — https://developer.chrome.com/docs/modern-web-guidance
When an agent takes on a front-end task, it activates the skill, searches the relevant guide through a local CLI and retrieves the code pattern, pitfalls and fallbacks. Search runs offline, with no API keys and no network connection. The team says the self-contained package responds to latency and software supply-chain security concerns.
From new code to modernizing existing projects
The main addition in 1.0 concerns existing code. The legacy-scan command analyses HTML, CSS, JavaScript, TypeScript and package.json files, flagging outdated patterns without any language-model calls and therefore at no token cost. Rules were tested on about 45,000 open-source repositories, split in two halves: rules were written and tuned on one half and graded on the other. To ship, a rule must reach at least 80% static precision and 90% precision on unseen code.
Each finding comes with explicit criteria for keeping or discarding it, so the agent can exclude intentional fallbacks or @supports guards before suggesting changes. The scanner currently covers the roughly 20% of guides where legacy code can be recognised with certainty; the rest of the catalogue remains available for lookup during development.

Image: Chrome for Developers — https://developer.chrome.com/docs/modern-web-guidance
The tool applies no automatic changes. The team explains there is no --fix flag because even apparently simple updates can cut across several layers, for example removing a JavaScript listener and moving its behaviour into CSS.
A cross-browser project
With version 1.0 the project becomes cross-browser. Firefox, Edge and MDN join Chrome in maintaining it. According to the release notes, contributions focus on improving the guides and cross-browser compatibility. Chrome previewed the project at Google I/O, and some developers had already tested early builds.
The package is released under an open-source licence and its code is public on GitHub. For website developers, the practical point is that agents can now be steered toward standard solutions that browsers already support, rather than reproducing older patterns. The team gives no timeline for extending the scanner to the remaining guides.

No comments yet. Be the first!