Skip to content
ML2

Modern Web Guidance: stop agents writing legacy web code

Added NewCopyable prompt below

Published Last verified Released

Our verdict

Worth installing in any web project where an agent writes your UI. Coding agents learned from years of older code, so they often reach for a JavaScript workaround or a heavy library where the browser now has a native feature (dialog, Popover API, anchor positioning, container queries, view transitions). This skill makes the agent search a local database of 203 guides covering 250 web features before it codes, then tell you which guides it applied. Version 1.0 (10 Nov 2026) added legacy-scan, a static scanner that maps old patterns to the guide with the modern fix. One builder on X (@Vinceuksu) planted old patterns in a small page and reported legacy-scan flagged 9 findings in 3 files in about a second with no API key; it was also a top Show HN and on GitHub Trending this week. Limits: the scanner only has deterministic rules for about 20% of guides, so treat it as a list of candidates and test behaviour and accessibility in the running app; the improvement figures on its eval dashboard are the project's own; it covers the web platform only, not your framework's conventions. We have not run it ourselves.

Who it's for
Front-end and full-stack builders who use Claude Code, Codex, Copilot CLI, Gemini CLI, Antigravity or Cursor to write web UI, and teams modernizing an older codebase with an agent
Leverage
Agent-written UI that uses native browser features with sensible fallbacks instead of extra JavaScript, plus a one-command scan that finds legacy code to modernize
Effort
Low
Date added

What it does

Modern Web Guidance (GoogleChrome/modern-web-guidance, Apache-2.0, npm package modern-web-guidance) is a set of agent skills plus a CLI. The skill tells your agent to search the guide database for the task at hand (for example "animate a dialog modal backdrop"), retrieve the matching guide, and follow it, checking browser support against your Baseline target. Guides cover user experience and animation, CSS layout, performance (preloading, INP, scheduler.yield), forms and UI components, accessibility, security (passkeys, Content Security Policy) and the browser's built-in A.I. APIs. Search runs fully offline with a small embedding model plus keyword search. Version 1.0 adds legacy-scan (scan, verify, report, modernize workflow), an opt-in for very new single-engine features through a .mwgrc file, and a section at the end of each agent reply listing the guides and APIs it used. It first appeared as an early preview at Google I/O on 19 May 2026; 1.0 shipped on 10 Nov 2026.

How builders use it

  • Run npx modern-web-guidance@latest install in the project and pick your agents in the wizard, or install it as a Claude Code plugin, a Copilot CLI or Antigravity plugin, or with npx skills add.
  • Ask for UI work as usual (an accordion, a tab bar, a modal, a tooltip) and check the guide section at the end of the reply to see which native APIs and fallbacks were chosen.
  • Run npx modern-web-guidance@latest legacy-scan . on an older codebase, then ask the agent to verify and fix the findings one guide at a time.
  • Pair it with Chrome DevTools for agents so the agent can test the result in a real browser (performance, accessibility tree, console).

What to expect

Fewer review rounds spent replacing agent-written JavaScript with native HTML and CSS, and a concrete, prioritised list of legacy code to modernize instead of a vague refactor.

Copy this: Install, scan, modernize

# Official source: github.com/GoogleChrome/modern-web-guidance (Apache-2.0)
# Docs: developer.chrome.com/docs/modern-web-guidance

# Install into the project (interactive wizard)
npx modern-web-guidance@latest install
# Or: claude plugin install modern-web-guidance@claude-plugins-official
# Or: npx skills add GoogleChrome/modern-web-guidance

# Try without installing
npx modern-web-guidance@latest search "animate a dialog modal backdrop"
npx modern-web-guidance@latest legacy-scan .

# Ask your agent (Chrome's own sample prompts):
Update legacy modal window implementations to use the <dialog> element and animate them using modern CSS features.
Migrate legacy tooltips to use the Popover API and CSS Anchor Positioning.
My app has lots of long tasks, and its INP is affected. Help me fix it.

Related discoveries

See the newest picks →
  • ToolCoding & Shipping Agents

    claude-mem: memory across sessions for coding agents

    An Apache-2.0 plugin that watches your coding agent's sessions, compresses what it did into searchable notes, and injects the relevant ones into the next session.

    Effort: LowPrompt#Plugin / extension#MCP

  • ToolVibe-Coding & Prompt-to-App

    Continue

    Open-source coding agent for VS Code and JetBrains, any model.

    Effort: Medium#Plugin / extension#Local / BYO model

  • ToolVibe-Coding & Prompt-to-App

    Floorplan: a plain-English map of your A.I.-built app

    MIT plugin for Claude Code and Codex that reads your codebase and draws an interactive map: every part, file and web request named in plain English, connections traced across repos, plus a health check and a "recent work" view.

    NewEffort: LowPrompt#Plugin / extension#Local / BYO model

Get the best new A.I. picks in your inbox

The best new agent workflows and tools we’ve vetted, with a clear verdict on each. Short, occasional, useful.

More in Vibe-Coding & Prompt-to-App →

Free. No spam. Unsubscribe anytime.