Modern Web Guidance
Modern Web Guidance is a set of skills that embed web platform expertise, best practices, and browser compatibility data directly into coding agents, helping AI-assisted web development stay aligned with modern web best practices.
Visit GoogleChrome/modern-web-guidanceOverview
Modern Web Guidance is a set of skills that embed web platform expertise, best practices, and browser compatibility data directly into AI coding agents. It is stewarded by the Google Chrome, Microsoft Edge, Mozilla Firefox, and MDN teams alongside the web development community and steers agents away from legacy patterns toward modern web platform solutions.
Key Features
- Embeds web platform expertise, best practices, and browser compatibility data into coding agents.
- Provides 200+ expert-vetted guides across CSS, Web UI, HTML, JavaScript, Core Web Vitals, accessibility, security, and Web AI.
- Works with preferred AI coding agents and offers installation through npx, Vercel Agent Skills, Claude Code, Copilot CLI, and Antigravity CLI.
- Includes CLI commands for searching guides, retrieving guides by ID, and scanning codebases for legacy patterns.
- Uses live web-features Baseline data and project browser targets to generate progressive enhancement, @supports queries, or polyfills.
- Designed to be token-efficient by pruning lowest-common-denominator content that models already know.
Use Cases
- Guide coding agents to build new user experiences with modern web features.
- Modernize legacy code such as modal windows, tooltips, and other older patterns.
- Improve security and performance tasks through targeted agent prompts.
- Pair with Chrome DevTools for agents to close the build-and-verify loop in a live browser.
Getting Started
- Run npx modern-web-guidance@latest install to start the interactive installation wizard.
- Add the skills with npx skills add GoogleChrome/modern-web-guidance.
- Install for Claude Code with claude plugin marketplace add GoogleChrome/modern-web-guidance and claude plugin install modern-web-guidance@googlechrome.
- Try commands without installing: npx modern-web-guidance@latest search "animate a dialog modal backdrop", npx modern-web-guidance@latest retrieve "animate-to-from-top-layer", and npx modern-web-guidance@latest legacy-scan .
Before You Adopt
- License: Apache-2.0. Review its terms before using, modifying, or distributing the project.
- The project is presented as a 1.0 release with expert-vetted skills and a public evaluation benchmark.
- Coding agents may default to legacy patterns because their training data includes large amounts of legacy code, so guidance is needed to steer them toward modern solutions.