ERA OF MINDS

Modern Web Guidance in Claude Code: how to install Chrome's free skill and run legacy-scan

Short answer

Modern Web Guidance is a free agent skill from the Chrome team (with Firefox, Edge and MDN) that stops coding agents from writing old-style web code. To use it in Claude Code, run claude plugin marketplace add GoogleChrome/modern-web-guidance, then claude plugin install modern-web-guidance@googlechrome. Or run npx modern-web-guidance@latest install in your project, which also keeps it updated. Version 1.0 shipped on November 10, 2026 with 208 guides and a new legacy-scan command that finds outdated patterns in an existing codebase. We ran it on this site: 2 seconds, 3 findings.

Era of Minds cover: Your agent codes like 2019? Fix it. Free Chrome skill. Modern Web Guidance 1.0: 2 commands to install, 208 vetted guides, scans for old code. Terminal panel with our legacy-scan run on eraofminds.com: checked 33 guides, 35 rules, about 20% of the corpus, 3 findings for custom-text-decorations in about 2 seconds. Table: version 1.0.0 Nov 10, 208 guides, note inc. pass rate 61% to 94% over 180 runs, MetaMask PR bot 43 fixes in 5 weeks, @ChromiumDev posts 415K views.
Figure: our own legacy-scan run on the eraofminds.com repo (November 15, 2026), next to numbers from the Chrome for Developers launch post and the @ChromiumDev posts on X.

The Chrome team's launch post on X opened with a line every frontend developer has felt: "Left to their own devices, AI coding agents will happily write 100 lines of custom JavaScript for something modern HTML and CSS can do natively in a few lines." Two days later @ChromiumDev said the project was the number one trending repo on GitHub. As of 10:30 Dubai time on November 15, the four main @ChromiumDev posts about it had 703,236 views, 9,251 likes and 9,652 bookmarks between them (X API). More bookmarks than likes usually means people plan to install it later.

This guide is the "later": what it is, how to set it up in Claude Code (and Codex, Copilot, Gemini CLI), what legacy-scan found when we pointed it at our own site, and where it falls short.

What is Modern Web Guidance?

It is an open source agent skill (Apache-2.0) plus a small command-line tool. The skill tells your agent: before you write UI code, CSS layout or client-side JavaScript, search the guide library first. The CLI does the searching. It matches your task to the best guide with an offline embedding model and BM25 search, so the README says there are no network calls and no API keys involved in the lookup. The agent then pulls the guide into its context and follows it.

The guides cover the stuff models get wrong most often. From the get-started docs:

  • UX: view transitions, entry and exit animations, scrollbar-color
  • CSS: container queries, oklch colors, subgrid, text-wrap
  • Performance: INP diagnostics, scheduler.yield, image loading priority
  • Forms: field-sizing: content, :user-invalid
  • Built-in UI: <dialog>, popover, CSS anchor positioning for tooltips
  • Accessibility, passkeys and built-in AI (on-device translation, summarization, language detection)

We counted the catalog with npx modern-web-guidance@1.0.0 list on November 15: 208 guides. Chrome's posts round that to "200+".

What changed in version 1.0?

An early preview came out at Google I/O in May. The 1.0 announcement by Philip Walton, dated November 10, 2026, lists four changes:

  • a modernization workflow that scans existing code for legacy patterns
  • a bigger guide database aimed at "hundreds of verified AI knowledge gaps"
  • human expert review for every guide, plus an accessibility review for user-facing ones
  • eval coverage for all guides, with a public eval dashboard

Firefox and Edge also joined Chrome on the project. The GitHub release v1.0.0 and npm package modern-web-guidance@1.0.0 both went out on November 10 (03:24 and 03:32 UTC). On November 15 the skill repo had 15,830 stars and the source repo another 6,280 (GitHub API).

How do you install Modern Web Guidance in Claude Code?

Two commands in your terminal:

claude plugin marketplace add GoogleChrome/modern-web-guidance
claude plugin install modern-web-guidance@googlechrome

Restart the session or reload plugins and the skill is there. Anthropic's own plugin marketplace also lists it (pinned to a GitHub commit), so you may see it in the /plugin browser without adding anything.

The Chrome team recommends a third route that works for any agent and updates itself. Run it from your project folder:

npx modern-web-guidance@latest install

It opens a short wizard. Add --choose if you build Chrome extensions, since there is a second skill for Manifest V3 work. Already on a preview build? Run npx modern-web-guidance@latest update.

How do you install it in Codex, Copilot, Gemini CLI and others?

Commands from the Chrome docs, checked November 15:

AgentCommand
Codexcodex plugin marketplace add GoogleChrome/modern-web-guidance then codex plugin add modern-web-guidance@googlechrome
Copilot CLI/plugin marketplace add GoogleChrome/modern-web-guidance then /plugin install modern-web-guidance@googlechrome
Gemini CLIgemini extensions install https://github.com/GoogleChrome/modern-web-guidance --auto-update
Antigravity CLIagy plugin install https://github.com/GoogleChrome/modern-web-guidance
Grokgrok plugin install https://github.com/GoogleChrome/modern-web-guidance --trust
GitHub CLIgh skill install GoogleChrome/modern-web-guidance
Any skills-compatible agentnpx skills add GoogleChrome/modern-web-guidance
Cursor, WebStorm, Antigravity appInstall from the app's plugin or skill manager (WebStorm: Settings > AI Assistant > Skills)

Most of these routes do not auto-update. The npx installer does.

How do you use it once it is installed?

Mostly, you don't do anything. Ask for a modal, a tooltip, a dark mode toggle, and the skill kicks in before Claude writes code. You can also try the library by hand before installing. We ran:

npx modern-web-guidance@latest search "animate a dialog modal backdrop"

It came back instantly with ten matches, led by animate-to-from-top-layer, light-dismiss-a-dialog and prevent-page-scroll-under-modal-dialog. Then retrieve <id> prints the full guide. A search for "dark mode toggle" returned dark-mode-toggle, dark-mode and component-specific-light-dark-theme.

One setting worth adding: your browser support target. Put a line like This project's Baseline target is Baseline 2024. in CLAUDE.md or AGENTS.md. Without it, the docs say the guides assume Baseline Widely available (features that have worked across major browsers for 30 months or more).

What is legacy-scan, and what did it find on our site?

legacy-scan is the headline 1.0 feature. It parses your HTML, CSS, JS/TS and package.json locally (no model calls, no tokens) and flags old patterns that have a modern replacement. Chrome says the rules were tuned on about 45,000 open source repos, and a rule only ships if it hits at least 80% precision on code it hasn't seen (modernization workflow docs). There is no --fix flag on purpose: your agent checks each finding, reports, and edits only if you ask.

In Claude Code, the trigger is plain English. The Chrome blog's example is /modern-web-guidance Modernize the code in this directory. You can run the scan yourself too. We pointed it at the eraofminds.com repo (55 HTML files plus its CSS and JS):

npx modern-web-guidance@1.0.0 legacy-scan /workspace/eraofminds-deploy --json

It finished in about 2 seconds. Result: 3 findings, all from one guide, custom-text-decorations. Our link underlines are faked with border-bottom: 2px solid plus text-decoration: none, and the scanner suggests real text-decoration with text-underline-offset and text-decoration-thickness, which wrap properly across lines. Fair catch. Each finding came with "keepWhen" and "dropWhen" rules so the agent can throw out false positives, such as tab indicators or block-level borders.

The JSON also told us something the launch posts don't lead with: "Checked 33 guides (35 deterministic rules; ~20% of the guidance corpus)." So a clean scan does not mean modern code. It means none of those 35 patterns showed up. The other 80% of the catalog only helps while the agent is writing new code.

Does Modern Web Guidance actually improve AI code?

The evidence so far comes from Chrome and its partners, so read it as vendor data:

  • Chrome's own evals: "On average, early results show a 37 percentage point improvement in adherence to modern best practices" with the skill installed, per the docs, which add that results vary by model, prompt and tool.
  • note inc. (Japanese creator platform): across a 180-run evaluation on its Next.js codebase, pass rates on modern web checks went from 61% to 94%.
  • MetaMask runs it as a review bot on every pull request to its browser extension, set up with a three-line prompt. In five weeks it reviewed about 480 PRs, commented on 64, and engineers fixed 43 findings, mostly accessibility, HTML semantics and forms.
  • WeTV (Tencent) pairs it with Chrome DevTools for agents in CI and says 90% of failed performance checks now get diagnosed and fixed automatically.

All four come from the 1.0 announcement. We have not seen an independent benchmark yet.

What are the limits?

  • Web frontend only. It does nothing for backend code, Python or mobile apps.
  • legacy-scan covers about 20% of the guides, as above.
  • It costs context. The skill file itself is small (the README lists about 205 tokens), but full guides are not: the docs' sample results run from about 1,000 to 7,000 tokens per guide.
  • Experimental features are off by default. Guidance for single-engine ("volatile") features and origin trials needs set-allow-volatile-features or set-allow-origin-trials.
  • Your agent can still skip it. A skill is an instruction, not a hard rule. Check that it fired on the first few tasks.

What we'd do first

Install it with the npx command so it stays updated, add a Baseline line to CLAUDE.md, then run legacy-scan on your oldest frontend repo. It takes seconds and costs nothing, and the findings are a ready-made, low-risk refactor list. After that, just keep building and watch whether Claude starts reaching for <dialog> and popover instead of a 200-line modal component. If it does, the skill is earning its place.

Want more on shaping how Claude Code builds UI? Taste-Skill fixes the generic look, Anatomy draws 3D diagrams, and our Claude Code desktop themes guide covers the same plugin install flow. For a bigger picture of the tools, see the best AI tools for coding.

FAQ: Modern Web Guidance, Claude Code and legacy-scan

What is Modern Web Guidance?

A free, open source (Apache-2.0) agent skill and CLI from the Chrome team, built with Firefox, Edge and MDN. It makes coding agents look up expert-reviewed guides before writing web UI, CSS or client-side JavaScript, so they use modern HTML and CSS features instead of old workarounds. Version 1.0 shipped on November 10, 2026.

How do I install Modern Web Guidance in Claude Code?

Run claude plugin marketplace add GoogleChrome/modern-web-guidance, then claude plugin install modern-web-guidance@googlechrome. Or run npx modern-web-guidance@latest install in your project folder, which Chrome recommends because it updates automatically.

Is Modern Web Guidance free?

Yes. The skill and CLI are free and open source under Apache-2.0. Guide search runs locally with an offline embedding model and BM25, with no API key. You only pay for the tokens your own agent uses when it reads a guide.

What does legacy-scan do?

npx modern-web-guidance@latest legacy-scan <path> --json parses your HTML, CSS, JS/TS and package.json locally and flags old patterns that have a modern replacement, with keepWhen and dropWhen rules for the agent to filter false positives. In 1.0 it checks 35 rules from 33 guides, about 20% of the catalog. It never edits files itself.

Does Modern Web Guidance work with Codex, Cursor and Copilot?

Yes. Chrome lists install routes for Claude Code, Codex, Copilot CLI, Gemini CLI, Antigravity, Grok, Goose, Kimi Code, WebStorm and the GitHub CLI, and says it is in the plugin marketplaces of Cursor and other popular agents. Any agent that supports skills can use npx skills add GoogleChrome/modern-web-guidance.

How many guides does Modern Web Guidance have?

208 guides when we ran npx modern-web-guidance@1.0.0 list on November 15, 2026. They cover UX, CSS, performance, forms, built-in UI like dialog and popover, accessibility, passkeys and on-device built-in AI APIs.

Does Modern Web Guidance make AI code better?

Chrome's docs report a 37 percentage point average improvement in adherence to modern best practices in its own evals. note inc. saw pass rates rise from 61% to 94% over 180 runs, and MetaMask's review bot led to 43 fixes in five weeks. These are vendor and partner numbers; no independent benchmark yet.

How do I set a browser support target for Modern Web Guidance?

Add a line such as: This project's Baseline target is Baseline 2024. to your CLAUDE.md or AGENTS.md file. Without one, the guides assume Baseline Widely available, meaning features supported across major browsers for at least 30 months.

Sources

FREE WEEKLY AI BRIEF

Free. Unsubscribe anytime. Free gift: 50 AI prompts that actually work, sent the moment you join. More about Decoded