Modern Web Guidance, a skill backed by browser teams, steers coding agents toward current web APIs
Modern Web Guidance is an agent skill and CLI, stewarded by the Chrome, Edge, Firefox and MDN teams, that feeds coding agents curated guides to 262 modern web platform features instead of legacy patterns. How it works, setup, evals and telemetry.
Updated November 20, 2026: Expanded with how the CLI works, Claude Code setup, eval results, telemetry and limits.
Modern Web Guidance is an agent skill that tries to stop coding agents from writing web code the way it was written years ago. It lives in the GoogleChrome GitHub organisation and is stewarded by the Google Chrome, Microsoft Edge, Mozilla Firefox and MDN teams together with outside contributors. Version 1.0.0 was released on November 10 and 1.0.1 followed on November 16. The 1.0.1 release adds a new general JavaScript guide and tightens several existing ones: the translator guide now requires a lang attribute on translated content, the CSS layout guide suggests a default for anchor-positioning fallbacks, and an autofill example typo is fixed.
The problem it targets
The README is direct about it: models fall back on older patterns because their training data holds a lot of legacy code, so they write heavy JavaScript for jobs the browser now does natively. Even when a model knows an API exists, it may not have seen enough real, current examples to use it correctly. The skill supplies those examples at the moment the agent needs them.
How it works
When a task touches the web platform, the agent activates the skill and calls its CLI. A search command matches the query to the best guide using an offline embedding model and BM25 ranking, with no network calls or API keys. A retrieve command then puts that guide, with code patterns, gotchas and fallbacks, into the agent's context. The main skill pack is listed at about 205 tokens.
Coverage, per the current README, is 262 features: 140 in CSS and layout, 37 in HTML and DOM, and 85 in JavaScript and APIs. They are grouped into user experience, CSS layout, performance, forms and UI, accessibility and built-in browser AI such as local translation and summarisation. The guides are pruned with evals so they skip what models already know.
Two safeguards stand out. Guides use Baseline compatibility data so agents adjust to real browser support, and the README prefers small, case-specific fallbacks (under 50 lines of code) or conditionally loaded polyfills over heavy third-party bundles. Guides for Origin Trial APIs and volatile features (single-engine features shipped in the last three months or still stabilising) show up in search but are blocked on retrieve unless you opt in. Run npx modern-web-guidance@latest set-allow-origin-trials or set-allow-volatile-features, or set "allowOriginTrials": true or "allowVolatileFeatures": true in a .mwgrc file in the project root (or ~/.mwgrc as a fallback).
Try it without installing
npx modern-web-guidance@latest search "animate a dialog modal backdrop"
npx modern-web-guidance@latest retrieve "animate-to-from-top-layer"
npx modern-web-guidance@latest legacy-scan .The last command scans an existing codebase for legacy patterns worth modernising. Running it on one repo is a reasonable way to see what the guides would change before handing a cleanup task to an agent (our suggestion, not the README's).
Install it in Claude Code
The Quickstart route is npx modern-web-guidance@latest install, an interactive wizard; add --choose to pick skill packs: the main modern-web-guidance pack (about 205 tokens) and a chrome-extensions pack (about 175 tokens) covering Manifest V3, background workers, extension APIs and Chrome Web Store publishing. If you used the wizard, update later with npx modern-web-guidance@latest update. As a Claude Code plugin:
/plugin marketplace add GoogleChrome/modern-web-guidance
/plugin install modern-web-guidance@googlechrome
/plugin # select the GoogleChrome marketplace, press enter, enable AutoUpdate
/reload-pluginsOne catch: if you installed it earlier from Anthropic's claude-plugins-official marketplace, the README says that copy stopped updating on October 12 and is stuck at v0.0.194. Run /plugin uninstall modern-web-guidance@claude-plugins-official, then the four steps above. The same skill also installs through npx skills, the GitHub CLI, Codex, Copilot CLI and several other agents.
Does it help? The project's own evals
The maintainers run agents on realistic tasks against two sample web apps (daily-grind and devtools-times), with prompts that avoid naming the API, and grade the results with Playwright checks. Graders are calibrated to pass hand-built golden solutions 100% of the time and fail the unmodified app. In the November 8 snapshot, Claude Code with Opus 5.5 passed 57% of 1,801 checks unguided and 88% with the skill, a 31-point gain across 215 tasks. Codex (gpt-6.1-sol) gained 28 points and Antigravity (gemini-4-argon) 36. Earlier snapshots on November 2, 4 and 6 show gains in the same 27 to 36 point range. These are the project's own benchmarks on its own apps, so treat them as a direction rather than a promise for your codebase.
Telemetry and limits
- Google collects usage data it describes as anonymous: install counts, the calling agent's name, guide IDs retrieved and the search queries the agent generates. Raw user prompts are not collected. The source file modern-web.ts shows what is sent, and the data falls under the Google Privacy Policy. Set DISABLE_TELEMETRY=1 in your shell profile to opt out.
- The scope is the web platform itself: CSS, HTML and browser APIs, plus the separate Chrome extensions pack.
- The README says it uses npx so the content doesn't go stale, and that the CLI works offline and locally. Because @latest fetches the newest published version, pin a version if you need reproducible runs (our advice).
- Code is Apache 2.0. Guide content is CC BY 4.0, so reusing guide text requires attribution.
Related on claudefox
- Claude Code product lead Cat Wu is joining OpenAI
- stack-diagram: an unofficial agent skill that turns one sentence into an architecture diagram with official logo files
- teardown: a Claude Code skill that builds take-apart 3D machine simulators as one offline HTML page
- huashu-motion lets Claude Code or Codex make a product launch film with music that you edit by clicking a frame
Our take
In our view, this is one of the more useful skills to install if Claude Code writes front-end code for you. Having the browser vendors and MDN curate it matters, because the hard part of modern web APIs is knowing support status and safe fallbacks, which is what the guides carry. The evals are encouraging but self-run. Run legacy-scan on one project first; if its findings look sensible, install the plugin and let the agent pull guides on its own.
Source: GoogleChrome/modern-web-guidance (GitHub), Modern Web Guidance v1.0.1 release notes
This story first appeared in the claudefox daily briefing for November 12, 2026.