Modern Web Guidance lets your AI coding agent stop writing 2019-style JavaScript
A free toolkit from Google Chrome, Microsoft Edge, Mozilla Firefox and MDN gives AI coding assistants the up-to-date best practices they're missing, so they stop generating bloated legacy code for tasks browsers can now handle natively.
What you could do with it
- A web developer could install the toolkit into their AI coding agent with one CLI command so it receives curated, current browser best practices before generating code 1.
- A coder could search for guidance on a specific task, like animating a dialog modal, by typing a single command so the agent gets targeted recommendations instead of guessing 1.
- A team could run a legacy scan across an entire codebase to flag outdated JavaScript patterns that could be replaced with lighter, built-in browser features 1.
The fix for stale code habits
The problem Modern Web Guidance tackles is well-known among web developers who have watched AI coding tools reach for solutions that are years out of date. Large language models swallow vast amounts of the internet's public code during training, and much of that code is legacy 1. When asked to build something as routine as a tooltip, a dialog box, or a responsive card layout, a coding agent often produces long hand-written JavaScript even though the browser can do the same thing today using lighter, faster, more accessible built-in APIs .
The project closes that gap by feeding curated, up-to-date guidance straight into the agent's thinking space — the part of the conversation where it searches for instructions before generating code 1. Instead of guessing or falling back to familiar old tricks, the agent receives concrete recommendations focused on performance, accessibility, and the kinds of fallbacks that won't slow a page down .
What the skills cover
Modern Web Guidance organizes its advice around several practical areas. On the visual side, it recommends features like View Transitions for smooth page changes, container queries that let components adapt to their own size, scroll-driven animations, and modern color systems like oklch 1. For forms and interfaces, it pushes the native <dialog> element over custom modal libraries, the Popover API instead of hand-coded tooltips, anchor positioning, and the :user-valid / :user-invalid CSS selectors for instant field feedback without extra script . Performance guidance includes scheduling work with scheduler.yield, preloading pages on hover, and fixing Interaction to Next Paint (INP), a metric that measures how snappy a page feels 2. Accessibility advice ensures screen-reader and keyboard users are not left behind . A newer category even covers built-in AI features such as native browser translation and summarization APIs .
In total the project catalogs more than 250 modern web features — roughly 140 CSS and layout techniques and dozens of HTML and DOM capabilities — all chosen because real-world evaluations showed many models still struggle with them 1. The content is kept tight and token-efficient so it does not bloat the agent's memory .
How to install it
npx modern-web-guidance@latest install This command runs a guided setup wizard 1. You can also try commands like npx modern-web-guidance@latest search "animate a dialog modal backdrop" or npx modern-web-guidance@latest legacy-scan . to find relevant guides or scan an existing codebase for outdated patterns without installing anything .
The tools already support several coding-agent environments. Vercel Agent Skills uses npx skills add GoogleChrome/modern-web-guidance; Claude Code accepts claude plugin marketplace add followed by a plugin install command; GitHub Copilot CLI and Antigravity each have their own plugin commands listed on the project page 2.
Who runs it
The project is stewarded jointly by teams behind Google Chrome, Microsoft Edge, Mozilla Firefox and the Mozilla Developer Network (MDN), together with members of the wider web development community 1. That shared ownership means the guidance reflects how multiple major browsers actually implement modern features today, rather than favouring any single vendor .
Key facts
- More than 250 modern web features are covered, including 140 CSS and layout items and dozens of HTML/DOM APIs 1.
- Installed via npx with one command, then used inside coding agents to replace legacy JavaScript patterns 1.
- Supported by Vercel Agent Skills, Claude Code, GitHub Copilot CLI, and Antigravity 2.
- Run by the Chrome, Edge, Firefox and MDN teams alongside the web community 1.
Sources
If this story concerns you or your company, or uses something that belongs to you, ask for a correction or for it to be taken down. How requests work
Keep reading
Apps and productsOpen-source tool Coral lets AI agents save and share their own commandsHerald of AI
Open-source tool Coral lets AI agents save and share their own commands
It cuts the time and cost of AI agent work by letting them remember what they did well instead of starting over every time.
Apps and productsYogurt lets you record and summarize meetings with AI that runs entirely on your own computerHerald of AI
Yogurt lets you record and summarize meetings with AI that runs entirely on your own computer
A free open-source app turns your calls into transcripts and summaries without sending any data to the cloud.
Apps and productsA new painting app lets your AI coding agent draw while you edit every strokeHerald of AI
A new painting app lets your AI coding agent draw while you edit every stroke
Klad gives a coding agent real brushes so it paints directly on your canvas — then you can tweak anything by hand without starting over.