---
name: modern-web-guidance
description: Google Chrome's modern web platform guides (HTML, CSS, client JS, a11y, forms, performance, security), read locally. Use when writing or changing web frontend UI code; not backend, infra, or tooling. /modern-web-guidance
---
# Modern Web Guidance
Google Chrome's guides, vendored at a pinned release (`VENDORED.json`). Apache-2.0 (`LICENSE`, `NOTICE.md`).
**Offline only.** Never run `npx`/`pnpx modern-web-guidance` (no `@latest`, no `install`, no `legacy-scan`): it fetches unpinned code and sends telemetry. If something insists, set `DISABLE_TELEMETRY=1` and pin `1.0.0`.
## Lookup
1. Search: `grep -i "<2-5 words>" INDEX.md` (ids, files, titles), or `grep -ril` under `guides/`. Name the UI primitive (`dialog`, `popover`, `date input`), not the framework.
2. Read the matching `guides//.md` in full, plus the area's overview guide (`css`, `html`, `forms`, `accessibility`, `performance`, `security`) when it applies.
3. A guide's `retrieve ""` means read `guides/*/.md`.
4. Apply it; check the code against the guide and its fallbacks. Baseline Widely available needs no fallback unless the project sets a browser policy.
5. When a guide shaped the change, name its id and the rule in your summary.
`UPSTREAM_SKILL.md` is Google's original text (framework tips, browser support); its `npx` steps are replaced by this lookup. Resync: `docs/modern-web-guidance.md`.