
`modern-web-guidance` is an Apache 2.0 skill pack co-built by the Google Chrome and Microsoft Edge teams, released at Google I/O 2026, that injects 102 expert-vetted modern web platform recipes into your coding agent. Google's evals show a +37 percentage-point improvement in best-practice adherence for Claude Code; the article covers installation for all 9 supported agents, concrete before/after code comparisons, three documented community wins, and Adrian Roselli's critical test showing real WCAG and Firefox failures — plus clear guidance on when not to use it.
<dialog> element is. It just doesn't reach for it. Instead, it hands you a <div> with display: none toggled by JavaScript, a z-index: 9999 container, and a custom Escape-key listener. It learned from billions of lines of web code, most of which was written before the modern web platform existed. modern-web-guidance is the fix.
oklch, anchor positioning), Performance (Speculation Rules, scheduler.yield, INP (Interaction to Next Paint) diagnostics), Forms & UI (Popover API, <dialog>, :user-invalid), Accessibility, Built-in AI (Summarizer, Translator, Language Detector APIs), Passkeys, and Privacy. 1modern-web retrieve <id> when it decides a guide is relevant, pulling targeted context rather than loading 102 guides all at once.modern-web-guidance-src repo. The April 30 benchmark: Claude Code (Opus 4-6) scored 44% best-practice adherence on 66 vague developer tasks (e.g. "make my images load faster") without MWG, and 81% with it — a +37 percentage-point gain across 516 browser assertions. 4npx modern-web-guidance@latest install.cursor/rules/, CLAUDE.md, etc.). Pass --choose to select specific skill packs.# Claude Code (plugin marketplace)
/plugin marketplace add GoogleChrome/modern-web-guidance
/plugin install modern-web-guidance@googlechrome
/reload-plugins
# Gemini CLI
gemini extensions install https://github.com/GoogleChrome/modern-web-guidance --auto-update
# GitHub CLI
gh skill install GoogleChrome/modern-web-guidance
# Vercel Skills
npx skills add GoogleChrome/modern-web-guidancenpx modern-web-guidance@latest update. You can also search guides without installing:npx modern-web-guidance@latest search "animate a dialog modal backdrop"
# returns JSON with id, category, tokenCount, similarity
| Without MWG | With MWG | |
|---|---|---|
| Element | <div> with JS toggle | <dialog> |
| Animation | Opacity transition on z-index: 9999 | @starting-style + allow-discrete |
| Accessibility | Custom keydown listener | Browser-native |
| Code volume | More JS | Less — browser handles it |
modern-web search and modern-web retrieve. MWG confirmed features already in use correctly (oklch(), :has(), Subgrid, invoker commands), suggested font-size-adjust for Japanese font layout shifts, and flagged features to skip with reasons attached — not just a list of new APIs to chase. 6moment.js with Popover API and Intl.RelativeTimeFormat, scroll-driven animations that degrade gracefully on unsupported browsers, and components that default to correct ARIA roles and prefers-reduced-motion handling. 9dangerouslySetInnerHTML still needs DOMPurify, Next.js CSP requires nonce-based middleware, and next/image can trigger style-src violations. MWG doesn't cover these. 12modern-web retrieve for specific tasks rather than loading all 128 guides at session start. 12| Field | Value |
|---|---|
| Package | modern-web-guidance v0.0.170 |
| Weekly downloads | 40,702 (week of May 19–25, 2026) |
| GitHub | GoogleChrome/modern-web-guidance — 967 stars |
| Source repo | GoogleChrome/modern-web-guidance-src — 553 stars, 755 commits |
| Maintainers | paulirish, rviscomi, hoten, micahjo7 (Google Chrome + Microsoft Edge teams) |
| License | Apache 2.0 (code), CC-BY 4.0 (documentation) |
| Status | Early preview — launched May 19, 2026 |
| Telemetry | Anonymous usage stats collected by default; opt out via DISABLE_TELEMETRY=1 |
developer.chrome.com
github.com
developers.googleblog.com
developer.chrome.com
scriptwalker.app
adrianroselli.com
This story was produced automatically by a channel. One sentence is all it takes for Neodrop to keep producing for you.