Modern Web Guidance: current web platform patterns for coding agents
GoogleChrome/modern-web-guidance
Your AI coding assistant looks up a short, current guide before it writes web pages, styles or browser code. It then uses what browsers can do today (built-in dialogs, modern layout, passkeys, faster loading) instead of old tricks and extra libraries. A second skill helps it build Chrome extensions and get them ready for the Chrome Web Store.
Pack description by its author: “Your AI coding assistant looks up a short, current guide before it writes web pages, styles or browser code. It then uses what browsers can do today (built-in dialogs, modern layout, passkeys, faster loading) instead of old tricks and extra libraries. A second skill helps it build Chrome extensions and get them ready for the Chrome Web Store.”
Design and frontendKnowledge and rules for your assistant
1. Changes your files
Skills that write or edit files: modern-web-guidance, chrome-extensions.
github.com/GoogleChrome/modern-web-guidance/blob/4dd9683/2. Runs code on your machine
Install: Two skill folders of markdown (SKILL.md, guides and references) and plugin manifests. No hooks and no scripts ship in this repository. Every web UI: The assistant runs npx -y modern-web-guidance@latest search and retrieve. npx fetches the latest package from npm; large results are saved to a temporary file. The README says search is local and the package has no extra dependencies.
github.com/GoogleChrome/modern-web-guidance/blob/4dd9683/3. Sends data
The skill runs the latest npm release of modern-web-guidance on every lookup, so the code that runs can change without a change in this repository. The tool's source lives in GoogleChrome/modern-web-guidance-src.
github.com/GoogleChrome/modern-web-guidance/blob/4dd9683/4. Commercial use
Apache 2.0 for code; guide content CC BY 4.0. Code you write with its help is yours
github.com/GoogleChrome/modern-web-guidance/blob/4dd9683/Checked against the pack's files at commit 4dd9683, on Nov 14, 2026. Tap a verdict to see its source.How we checkedReport an error
Good for you if
- You build websites or web apps with an AI coding assistant and want up-to-date front-end code
- You ask for things like pop-ups, forms, dark mode, animations, accessibility or faster pages
- You want to check an older site for outdated patterns and modernise it
- You are building a Chrome extension and plan to publish it
Probably not for you if
- Your work is server code, databases, build setup or scripts: the skill says not to trigger for those
- You want nothing downloaded from the internet while your assistant works
What its answer looks like
The closing Modern Web Guidance section
### Modern Web Guidance
- `<guide id>`: <non-obvious APIs, overrides or fallbacks applied and the pitfall prevented> ("<short quote of the rule>").
The skill's own example, from skills/modern-web-guidance/SKILL.md. More examples
What you'll notice
- Before web work, your assistant runs a small lookup tool (fetched from npm each time) to search and read guides
- Answers end with a short Modern Web Guidance section naming each guide it used and why
- For Chrome extensions: Manifest V3 code only, and a CHROMEWEBSTORE.md file in your project with store texts and permission reasons
What you need
- Claude Code, Codex, GitHub Copilot CLI, Cursor, Gemini CLI, Google Antigravity and 3 more
- Free, Apache-2.0 license
- One wizard command (npx modern-web-guidance@latest install), or the plugin command of your assistant
- Node.js 22 or newer and internet access to npm, because the guides are read through a command-line tool
Words on this page
- Skill
- A set of written instructions your AI assistant follows. Installing one is like giving it a playbook.
- Skill pack
- Several skills in one GitHub repository, installed together.
- Plugin
- A package your assistant installs that can bring skills, commands and hooks together.
- CLI
- A program you run by typing commands in a terminal.
| Repository | GoogleChrome/modern-web-guidance · website |
|---|---|
| GitHub stars | 16,112 |
| Skills | 2 |
| Category | Design and frontend |
| License | Apache-2.0 |
| Last updated | Nov 10, 2026 · card checked Nov 14, 2026 at commit 4dd9683 |
| Install counts | GoogleChrome/modern-web-guidance on skills.sh, Vercel's skills directory, which shows installs and security audits per skill |
GoogleChrome/modern-web-guidance popularity over time
What Modern Web Guidance does
- Search: the assistant turns your request into a 2 to 5 word query (for example "light dismiss dialog") and searches the guide index
- Retrieve: it reads the matching guide plus the broader topic guide (CSS, forms, accessibility, performance, security)
- Verify: it checks its code against the guide, including the fallbacks the guide asks for
- Disclose: it ends the answer with a short section naming each guide that shaped the code
- Modernise (only when asked for a broad scan): legacy-scan finds old patterns, the assistant drops false positives, reports, and fixes only if you asked it to
- Browser support: features that are Baseline widely available are used without fallbacks; newer ones get the guide's fallback unless you set your own policy
Never cut, per the skill: fallbacks the guide requires for features that are not yet Baseline widely available, unless you set a different browser support policy.
From the pack's SKILL.md files, summarised by AgentGid.
The 2 skills, explained
modern-web-guidance
Looks up a current guide before writing web code and follows it
You give
- The web feature or fix you want (a dialog, a form, dark mode, faster images)
- Optional: your browser support policy (for example Safari 17.4+, or no polyfills)
- For a modernisation: the folder to scan, and whether to fix or only report
You get
- Code that follows the retrieved guide, with its fallbacks
- A closing Modern Web Guidance section: one bullet per guide used, with a short quote of the rule
- For a scan: a report of verified old patterns and a modernisation plan
chrome-extensions
Builds Chrome extensions the current way and prepares them for the store
You give
- What the extension should do
- For publishing: your manifest.json and project, and any review rejection you received
You get
- Manifest V3 extension code checked against the skill's output checklist
- CHROMEWEBSTORE.md in the project root: store listing, graphics notes, permission reasons, privacy and data use, privacy policy, version history, review notes
- A pre-publish checklist run before you submit
See it in action
The skill defines what its answer looks like. Its own example:
### Modern Web Guidance
- `<guide id>`: <non-obvious APIs, overrides or fallbacks applied and the pitfall prevented> ("<short quote of the rule>").
The skill defines what its answer looks like. Its own example:
The guide builds the drawer as a modal dialog in the top layer, uses CSS scroll snapping for the swipe, ties the backdrop dimming to scroll position, and closes the drawer when it has fully left the screen. Full guide: skills/modern-web-guidance/guides/ui-components/navigation-drawer.md
From skills/modern-web-guidance/guides/ui-components/navigation-drawer.md.
When to reach for it
| You want | Use |
|---|---|
| New web UI, CSS or browser code written the current way | Ask as usual; the skill starts by itself |
| A report of outdated patterns in an existing site | "Audit this project for modern web best practices" (legacy-scan, report only) |
| The old patterns replaced too | Ask it to modernise the codebase (scan, verify, report, then fix) |
| To allow experimental Origin Trial features | npx modern-web-guidance@latest set-allow-origin-trials (writes .mwgrc) |
| A Chrome extension ready for the store | Ask to prepare the extension for the Chrome Web Store |
Skills in GoogleChrome/modern-web-guidance
| Skill | In plain words | Changes files? | What it does (author) |
|---|---|---|---|
| chrome-extensions | Builds Chrome extensions the current way and prepares them for the store | Yes | Build and publish Chrome Extensions using Manifest V3 best practices. Use this skill whenever the user asks to create, modify, debug, or understand Chrome browser extensions, add-ons, or anything involving the Chrome Extensions API. Trigger on mentions of: 'Chrome extension', 'browser extension',…npx skills add GoogleChrome/modern-web-guidance --skill chrome-extensions |
| modern-web-guidance | Looks up a current guide before writing web code and follows it | Yes | Search tool for modern web development best practices. MANDATORY: Execute FIRST for all HTML/CSS and clientside JS tasks. Do NOT skip — web APIs evolve rapidly and training weights contain obsolete patterns. Trigger immediately for: modals/dialogs/popovers, tables, dark mode, anchor positioning,…npx skills add GoogleChrome/modern-web-guidance --skill modern-web-guidance |
The author's descriptions come from each skill's SKILL.md; the plain-words column is AgentGid's.
Good to know before you install
- The guides are read through a separate npm tool that your assistant downloads with npx at its latest version on each call; the code of that tool is not in this repository.
- Google collects anonymous usage data by default: install counts, the calling agent name, guide IDs and the search queries your assistant writes. Raw prompts are not collected. Set DISABLE_TELEMETRY=1 to opt out.
- It switches on by itself for nearly all HTML, CSS and browser JavaScript tasks; its description calls the lookup mandatory.
- Experimental Origin Trial and volatile features are held back until you opt in with a .mwgrc file in your project or home folder.
- The guide texts themselves are plain markdown in skills/modern-web-guidance/guides/, so you can read them in the repository.
- This repository is a publish target; changes and issues go to GoogleChrome/modern-web-guidance-src.
Before you start
Works in
- Claude Code: plugin
- Codex: plugin
- GitHub Copilot CLI: plugin
- Cursor: plugin
- Gemini CLI: extension with a shell policy
- Google Antigravity: plugin
- Grok Build CLI: plugin
- Kimi Code: plugin
- VS Code: extension (chat skills)
- Any agent with a skills folder: skills CLI
You will need
- Node.js 22+ with npx (or pnpx): Every search and retrieve runs the modern-web-guidance npm package
- Network access to npm: npx fetches the package; sandboxes need network allowlisting
Steps only you can do
- Approve network access for npx modern-web-guidance in sandboxed agents (for example Codex or Claude Code) (skills/modern-web-guidance/SKILL.md (Using npx / pnpx))
Then: The assistant can run search and retrieve without timeouts - Decide on telemetry: set DISABLE_TELEMETRY=1 in your shell profile to opt out (README.md (Telemetry & Privacy))
Then: The npm tool stops sending usage data - Publish the extension yourself in the Chrome Developer Dashboard, using CHROMEWEBSTORE.md (skills/chrome-extensions/SKILL.md (Part 2))
Then: The assistant keeps CHROMEWEBSTORE.md updated after later changes
Mistakes to avoid
Run legacy-scan for a request about one feature or component
Use search and retrieve for a named feature; keep legacy-scan for broad, open-ended modernisation
The skill limits legacy-scan to broad scans with no named targetTreat a clean legacy-scan as proof the code is modern
Also search the guides for the features the site uses
legacy-scan checks only the guides that have fixed rulesAllowlist bare npx in a sandbox so the lookups stop asking
Allowlist only the modern-web-guidance command
The skill itself says to allow the specific command, never npx in generalSearch with framework or app names ("close React settings modal on outside click")
Search the platform capability in 2 to 5 words ("light dismiss dialog")
The skill says to omit framework and app nouns and split compound searchesExpect experimental browser APIs in the answers by default
Opt in with .mwgrc (allowOriginTrials or allowVolatileFeatures) if you want them
Retrieve holds those guides back without explicit consent
Which one to pick
| If you need | Pick |
|---|---|
| You want current browser APIs, layout, forms, security and accessibility guidance looked up per task, plus Chrome extension help | This pack |
| You want skills focused on Lighthouse scores and Core Web Vitals | addyosmani/web-quality-skills |
| You want ready JavaScript snippets your agent runs to measure and debug page speed | nucliweb/webperf-snippets |
| You want a design review of UI code for accessibility and visual issues | rams-design/rams-plugin |
Works well with
- lighthouse: Measures the page speed, accessibility and best-practice results the guides aim to improve
- baseline-browser-mapping: Maps browser versions to Baseline, the support level the skill uses to decide on fallbacks
- claude-code: Installs as a Claude Code plugin from the repository's marketplace
- openai-codex: Installs as a Codex plugin with the same skills
May I use it like this?
| Use | Answer | Condition |
|---|---|---|
| In a commercial app | Yes | Apache 2.0 for code; guide content CC BY 4.0. Code you write with its help is yours |
| Passing the files on | With conditions | Keep the Apache 2.0 license; credit the guides (CC BY 4.0); parts derive from MDN and W3C, WHATWG and IETF specs |
| Work for clients | Yes | Apache 2.0 and CC BY 4.0 allow it |
What leaves your machine
- Install counts, the calling agent name, guide IDs and the search queries the assistant writes (not your raw prompts) → Google, When the npm tool runs, by default. Opt out: Set DISABLE_TELEMETRY=1
- A package download request for modern-web-guidance@latest → The npm registry, Each npx call that is not served from the npm cache. Opt out: Use npx --offline (works only with a cached copy)
Install Modern Web Guidance
Official commands from the repository
npx modern-web-guidance@latest install
Interactive wizard. Add --choose to pick the skill packs. Update with npx modern-web-guidance@latest update.
/plugin marketplace add GoogleChrome/modern-web-guidance /plugin install modern-web-guidance@googlechrome /reload-plugins
The README also suggests enabling auto-update for the marketplace in /plugin.
codex plugin marketplace add GoogleChrome/modern-web-guidance codex plugin add modern-web-guidance@googlechrome
/plugin marketplace add GoogleChrome/modern-web-guidance /plugin install modern-web-guidance@googlechrome
npx skills add GoogleChrome/modern-web-guidance
gh skill install GoogleChrome/modern-web-guidance
agy plugin install https://github.com/GoogleChrome/modern-web-guidance
grok plugin install https://github.com/GoogleChrome/modern-web-guidance --trust
The --trust flag is part of the documented command.
/plugins install https://github.com/GoogleChrome/modern-web-guidance
Or with the open-source skills CLI: npx skills add GoogleChrome/modern-web-guidance. Skills are instructions your agent follows: read them before installing.
What it installs and runs on your machine
Read in the code at commit 4dd9683, Nov 14, 2026
| When | What happens |
|---|---|
| Install | Two skill folders of markdown (SKILL.md, guides and references) and plugin manifests. No hooks and no scripts ship in this repository. |
| Every web UI | The assistant runs npx -y modern-web-guidance@latest search and retrieve. npx fetches the latest package from npm; large results are saved to a temporary file. The README says search is local and the package has no extra dependencies. |
| Telemetry | The npm tool sends anonymous usage data to Google (install counts, agent name, guide IDs, search queries) unless DISABLE_TELEMETRY=1 is set. |
| Broad modernisation request | legacy-scan reads your project folder; the assistant edits files only when you asked to modernise. |
| Chrome extension work | The assistant creates or updates CHROMEWEBSTORE.md in your project root. |
| Gemini CLI plan mode | A policy file makes shell commands that match modern-web ask you first. |
The author's numbers, as reported
AgentGid did not run these tests
- 250 modern web features covered. Source
- claude_code (opus-5-5), Nov 8: 57% of checks passed without guidance, 88% with it (+31pp), 215 tasks (Google's eval harness: developer tasks on sample web apps, Playwright graders, guided vs unguided runs). Source
- codex_cli (gpt-6.1-sol), Nov 8: 54% without guidance, 82% with it (+28pp). Source
- legacy-scan covers about 20% of the guides. Source
Settings
DISABLE_TELEMETRY: 1 turns off the usage data the npm tool sends to Google.mwgrc allowOriginTrials: true unlocks guides for Origin Trial APIs (project root or ~/.mwgrc).mwgrc allowVolatileFeatures: true unlocks guides for volatile single-engine featuresNPM_CONFIG_CACHE: The skill suggests /tmp/npm-cache when ~/.npm is read-only
Quick answers
- Is it free?
- Yes. Code is Apache 2.0 and the guide texts are CC BY 4.0.
- Does it send anything to Google?
- The npm tool sends anonymous usage data, including the search queries your assistant writes, unless you set DISABLE_TELEMETRY=1. Raw prompts are not collected.
- Does it work offline?
- Search runs locally, but npx needs npm the first time; the skill says to retry with npx --offline when offline.
- Will it rewrite my whole site?
- No. legacy-scan runs only for a broad modernisation request, and files change only if you asked to modernise, not just audit.
- Does it work with React or Vue?
- Yes. The guides are plain HTML, CSS and JS, and the skill tells the assistant to adapt them to your framework.
Checked by AgentGid on Nov 14, 2026 against commit 4dd9683 of the pack's own files. Related: GoogleChrome/modern-web-guidance-src. agent.md for AI agents · Report a mistake
More design and frontend skill packs
| # | Skill pack | Skills | GitHub stars | Updated |
|---|---|---|---|---|
| 1 |
nextlevelbuilder/ui-ux-pro-max-skill Your AI assistant gets a local design library: UI styles, colour palettes, font pairings and UX rules for many product types. Bef…
|
7 | 150K | 2026-11-14 |
| 2 |
Leonxlnx/taste-skill Your AI coding assistant stops building the average landing page. It picks one of 20 researched design directions, finds real, cr…
|
1 | 116K | 2026-11-08 |
| 3 |
tt-a1i/archify Your AI assistant turns a description, a Mermaid sketch or your project's code into an interactive diagram saved as one HTML file…
|
5 | 96.5K | 2026-11-15 |
| 4 |
cathrynlavery/diagram-design Your AI assistant draws clean, editorial diagrams in your brand colours and fonts. You describe the diagram in plain words and ge…
|
1 | 67.2K | 2026-11-12 |
| 5 |
Nutlope/hallmark Your AI assistant builds web pages that look designed, not machine-made. It asks once for your real material and picks one of fif…
|
1 | 55.2K | 2026-11-11 |
| 6 |
alchaincyf/huashu-design One large design playbook for your AI assistant, written in Chinese. It makes clickable app prototypes, web pages, slide decks, i…
|
1 | 29.5K | 2026-11-10 |