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,npxchecks 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=1to 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.mwgrcfile 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@googlechromecodex plugin marketplace add GoogleChrome/modern-web-guidancecodex plugin add modern-web-guidance@googlechromeHow 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.
- Add Google Chrome's marketplace:
codex plugin marketplace add GoogleChrome/modern-web-guidance- Install the plugin:
codex plugin add modern-web-guidance@googlechromeYou can also run the wizard, which asks which packs to install. Add --choose to pick them:
npx modern-web-guidance@latest installGemini CLI: the README does not name Gemini CLI and Google documents no install command, so we give none.
Check it works
- Run a search in a terminal, without installing anything:
npx modern-web-guidance@latest search "animate a dialog modal backdrop"- The command must print a list of matching guide IDs.
- 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 everynpxcommand. - 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
retrieverefuses it — Since 1.0.0 these guides need your consent. Runnpx modern-web-guidance@latest set-allow-volatile-featuresin the project folder, or leave the feature out. - The command fails on Windows —
npxdoes not run — The skill says to usenpx.cmdinstead ofnpxon 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, runnpx modern-web-guidance@latest update. modern-web-guidance@claude-plugins-officialis 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. Runclaude plugin marketplace add anthropics/claude-plugins-officialfirst.
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.
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
- github.com/GoogleChrome/modern-web-guidance
- developer.chrome.com/docs/modern-web-guidance
- github.com/GoogleChrome/modern-web-guidance/releases/tag/v0.0.194
- raw.githubusercontent.com/GoogleChrome/modern-web-guidance/main/README.md
- raw.githubusercontent.com/GoogleChrome/modern-web-guidance/main/skills/modern-web-guidance/SKILL.md
- npmjs.com/package/modern-web-guidance
- github.com/GoogleChrome/modern-web-guidance-src/blob/main/src/cli/telemetry/clearcut-logger.ts
- github.com/GoogleChrome/modern-web-guidance/releases/tag/v1.0.0
- github.com/GoogleChrome/modern-web-guidance/blob/v1.0.0/README.md
- github.com/GoogleChrome/modern-web-guidance/blob/v1.0.0/skills/modern-web-guidance/SKILL.md
- learn.chatgpt.com/docs/developer-commands?surface=cli
- code.claude.com/docs/en/discover-plugins