SkillInstalls cleanly

Up-to-date web tips for your assistant

Modern Web Guidance

Google Chrome's official skill feeds your assistant current web best practices, with guides on speed, accessibility and modern browser features.

Works with
Claude Code, Codex CLI
Good for
Web developers, Build an app

What it does

AI assistants learned to build websites from years of old code. For this reason, they often add heavy scripts where a modern browser feature does the job better. Modern Web Guidance is a set of short guides from the Google Chrome team that fixes this. Since version 1.0.0 (10 November 2026) the README says the Google Chrome, Microsoft Edge, Mozilla Firefox and MDN teams look after it together.

The guides cover layout, animations and page transitions, forms, dialogs and pop-ups, page speed and accessibility (pages that work with a keyboard or a screen reader). Each guide also says which fallback to use for older browsers, instead of a big library. A second pack covers Chrome extensions.

It works on demand. When your assistant starts web work, the skill tells it to run npx -y modern-web-guidance@latest search with a short query. A small search model on your computer picks the best guides, with no API key and no network call. The assistant then loads only those guides with retrieve. Google's own tests report that assistants pass more checks with the guides than without, but those are the vendor's numbers.

Things to know before you start:

  • Because of @latest, npx checks npm at each lookup and downloads a new version when one is out. The package is about 16.5 MB unpacked, and it needs Node.js 22 or newer.
  • Google collects anonymous usage data by default: install counts, the agent's name, which guides it retrieved, the search words the agent wrote, and (in the source code) your operating system type. Your own prompts are not collected. To turn it off, add export DISABLE_TELEMETRY=1 to your shell profile.
  • The skill text tells the assistant to use it first for every HTML, CSS and browser JavaScript task. It also tells the assistant to end its reply with a short "Modern Web Guidance" section that names the guides it used.
  • Version 1.0.0 is out of preview. The code you run comes from a separate source repository, GoogleChrome/modern-web-guidance-src.
  • Since 1.0.0 you can ask the assistant to scan an existing site for old patterns. It runs npx -y modern-web-guidance@latest legacy-scan <folder>, which checks about 20% of the guides, and maps each finding to a guide. If you ask it to modernize, it then edits the files. Use git so you can review the changes.
  • Guides for very new features that only one browser has are found by search, but the assistant can load them only after you allow it with npx modern-web-guidance@latest set-allow-volatile-features. This writes a .mwgrc file in your project.

Who it is for

People who build websites with an AI assistant and want it to use today's browser features, with good accessibility and speed, instead of old habits or extra libraries.

Example prompts

  • "Build an accessible pop-up dialog with a dimmed, animated background."
  • "Make this page support dark mode properly, including the scrollbars."
  • "Speed up how the photos on my homepage load."
  • "Add a smooth transition when moving between the pages of my site."
  • "Help me publish this Chrome extension. Follow the Chrome extensions guidance."

How to install

npx modern-web-guidance@latest install
/plugin marketplace add GoogleChrome/modern-web-guidance
/plugin install modern-web-guidance@googlechrome
codex plugin marketplace add GoogleChrome/modern-web-guidance
codex plugin add modern-web-guidance@googlechrome

How to use it

Ask for web work as usual, for example: speed up the photos on my homepage, or add an accessible pop-up dialog. The assistant looks up the matching guide by itself.

Other assistants

Codex CLI: the README gives a plugin route.

  1. Add Google Chrome's marketplace:
codex plugin marketplace add GoogleChrome/modern-web-guidance
  1. Install the plugin:
codex plugin add modern-web-guidance@googlechrome

You can also run the wizard, which asks which packs to install. Add --choose to pick them:

npx modern-web-guidance@latest install

Gemini CLI: the README does not name Gemini CLI and Google documents no install command, so we give none.

Check it works

  1. Run a search in a terminal, without installing anything:
npx modern-web-guidance@latest search "animate a dialog modal backdrop"
  1. The command must print a list of matching guide IDs.
  2. After a Claude Code plugin install, run /reload-plugins. Ask for a small web task and watch the assistant run the search.

The plugin is also in Anthropic's official marketplace as modern-web-guidance@claude-plugins-official.

Common problems

  • The assistant asks to run npx again and again — a permission prompt at each lookup — The skill says to allow exactly npx -y modern-web-guidance@latest *. Do not allow every npx command.
  • Guide lookups fail — the search command errors or does not start — Install Node.js 22 or newer. Since 0.0.197 (2 November 2026) Node.js 20 is too old. Check your version with node --version.
  • A guide for a very new browser feature does not load — search finds it but retrieve refuses it — Since 1.0.0 these guides need your consent. Run npx modern-web-guidance@latest set-allow-volatile-features in the project folder, or leave the feature out.
  • The command fails on Windows — npx does not run — The skill says to use npx.cmd instead of npx on Windows.
  • The search hangs — no output when you are offline — The skill suggests running the same command again with npx --offline.
  • Plugin updates do not arrive in Claude Code — old guides, or a warning that the skill file is out of date — Auto-update is off by default for this marketplace. Open /plugin, select the GoogleChrome marketplace, turn on auto-update, then run /reload-plugins. If you used the wizard, run npx modern-web-guidance@latest update.
  • modern-web-guidance@claude-plugins-official is not found — the install fails on a new computer or in a script — Claude Code adds the official marketplace only on the first interactive session. Run claude plugin marketplace add anthropics/claude-plugins-official first.

What to watch out for

  • Sends anonymous usage data to Google: install counts, the agent's name, guide IDs and the search words the agent writes, which can reflect what you build; your own prompts are not collected; set DISABLE_TELEMETRY=1 to opt out (README)
  • Out of preview since 1.0.0 (10 November 2026); the release says 203 guides, stewarded by the Chrome, Edge, Firefox and MDN teams
  • The install wizard can also add a second pack for Chrome extensions; pick only the one you need
  • npx downloads and runs the latest package from npm each time you use it
  • Telemetry is on by default; the notice prints only in the npx install wizard, so plugin users never see it (source code)
  • The source code also sends your operating system type, the package version and the skill version with each event
  • The skill tells the assistant to use it first on every HTML, CSS and browser JavaScript task and to add a guide summary to its replies
  • Needs Node.js 22 or newer (npm engines, since 0.0.197 of 2 November 2026); before it was Node.js 20. The npm package is about 16.5 MB unpacked, an 8.8 MB download (npm, release 1.0.0)
  • Since 1.0.0 the skill can run legacy-scan over a whole project when you ask for a broad modernization. It reports old patterns and, if you asked it to modernize, the assistant edits many files. Use git so you can review and undo the changes (release 1.0.0, SKILL.md)
  • The code you run is built from a separate repository, GoogleChrome/modern-web-guidance-src (README)

Licence and author

Licence
Apache-2.0
Author
Google Chrome
Source code
github.com/GoogleChrome/modern-web-guidance

How we tested it

We installed it on an empty test computer on 15 Oct 2026. Installed and started in a clean test system. Not yet used in a real AI session.

Test level

Not run: "codex plugin marketplace add GoogleChrome/modern-web-guidance" (not a form the sandbox runs). Not run: "codex plugin add modern-web-guidance@googlechrome" (not a form the sandbox runs). Not yet used on real work.

Technical details of the test
Date
15 Oct 2026
Method
Intake sandbox run on 2026-10-15 in a clean container with no account: cloned the repository and checked its skill, agent and plugin files, ran "npx -y modern-web-guidance@latest --help"; installed modern-web-guidance@googlechrome with the Claude Code command line.

Checked again on 10 Nov 2026

Alternatives

  • chrome-devtools-mcp: Lets the assistant open and measure a live page in Chrome. It does not teach patterns.
  • ui-ux-pro-max: Focuses on visual style, colours and fonts rather than browser features.
  • oil-ui: Explores different visual designs side by side.

FAQ

Does it send my code to Google? No. The README says it collects install counts, the agent name, guide IDs and the agent's search words, not your prompts. The search words can still hint at what you build. Turn it off with DISABLE_TELEMETRY=1.

Is it open source? Yes. It uses the Apache-2.0 licence.

Will my site only work in Chrome? No. The guides favour standard web features and include fallbacks for browsers that lack them.

Sources