Skip to content
Agents tracked: 492 Releases (7d): 545 Agent status: 1 with issuesSince last limit reset: Claude 9d · Codex 7d For AI agents: Markdown Updated Nov 20, 2026

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

GitHub

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

Knowledge and rules for your assistantNothing to run: text files only

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.
RepositoryGoogleChrome/modern-web-guidance · website
GitHub stars16,112
Skills2
CategoryDesign and frontend
LicenseApache-2.0
Last updatedNov 10, 2026 · card checked Nov 14, 2026 at commit 4dd9683
Install countsGoogleChrome/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

Most starred skill packs

GoogleChrome/modern-web-guidance: GitHub starstotal over time 16,112
GoogleChrome/modern-web-guidance: new stars per weekGitHub 13,360

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
Say: “Add a settings dialog that closes when I click outside it”

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
Say: “Build a Chrome extension that highlights search terms on any page, and prepare it for the Chrome Web Store”

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>").

From skills/modern-web-guidance/SKILL.md.

When to reach for it

You wantUse
New web UI, CSS or browser code written the current wayAsk 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 tooAsk it to modernise the codebase (scan, verify, report, then fix)
To allow experimental Origin Trial featuresnpx modern-web-guidance@latest set-allow-origin-trials (writes .mwgrc)
A Chrome extension ready for the storeAsk to prepare the extension for the Chrome Web Store
Try it. Install it, then ask your assistant for a pop-up dialog that closes when you click outside it. Before writing code it runs a modern-web-guidance search, and its answer ends with a "Modern Web Guidance" section naming the guide it used. That section is how you know the skill is on.

Skills in GoogleChrome/modern-web-guidance

SkillIn plain wordsChanges files?What it does (author)
chrome-extensions Builds Chrome extensions the current way and prepares them for the storeYes 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 itYes 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

  1. 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
  2. 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
  3. 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 target
  • Treat 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 rules
  • Allowlist 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 general
  • Search 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 searches
  • Expect 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 needPick
You want current browser APIs, layout, forms, security and accessibility guidance looked up per task, plus Chrome extension helpThis pack
You want skills focused on Lighthouse scores and Core Web Vitalsaddyosmani/web-quality-skills
You want ready JavaScript snippets your agent runs to measure and debug page speednucliweb/webperf-snippets
You want a design review of UI code for accessibility and visual issuesrams-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?

UseAnswerCondition
In a commercial app YesApache 2.0 for code; guide content CC BY 4.0. Code you write with its help is yours
Passing the files on With conditionsKeep 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 YesApache 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.

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

WhenWhat happens
InstallTwo skill folders of markdown (SKILL.md, guides and references) and plugin manifests. No hooks and no scripts ship in this repository.
Every web UIThe 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.
TelemetryThe npm tool sends anonymous usage data to Google (install counts, agent name, guide IDs, search queries) unless DISABLE_TELEMETRY=1 is set.
Broad modernisation requestlegacy-scan reads your project folder; the assistant edits files only when you asked to modernise.
Chrome extension workThe assistant creates or updates CHROMEWEBSTORE.md in your project root.
Gemini CLI plan modeA 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 features
  • NPM_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

All design and frontend skills

# 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