← Back to library

Keep your coding agent on current web platform features

The Chrome team released version 1.0 of modern-web-guidance on November 10, 2026, built with Firefox, MDN and Edge. It pairs an agent skill with a small search tool over more than 200 hand-written guides, plus a scan that flags outdated patterns in an existing codebase. We explain how to put it to work.

  • OutcomeAdd Google Chrome's modern-web-guidance skill to Claude Code, Codex, Cursor or another coding agent so that before it writes front-end code it looks up a vetted guide for the pattern at hand, uses built-in browser features such as native dialogs instead of old JavaScript workarounds, applies fallbacks only where browser support requires them, and tells you which guides shaped the change.
  • SetupMinutes
  • LevelIntermediate
  • CreditGoogleChrome
View original
Works with
Claude CodeMicrosoft CopilotCustom agent

Published Nov 11, 2026Updated Nov 11, 2026AI dry run on sample input: passed Nov 11, 2026Source verified Nov 11, 2026

When should you use it?

  • Your agent keeps adding a JavaScript library for things the browser can now do on its own, such as modals, popovers or auto-growing text boxes
  • An agency or in-house team ships client websites with coding agents and wants consistent, accessible front-end code
  • You inherited an older site and want a list of patterns worth modernizing before a redesign

Not for: Back-end, database or infrastructure work; the skill is meant to stay quiet for those tasks; Environments without network access, unless you can allow the package download once; Teams that must support very old browsers and cannot ship any fallback code

What do you need, and what do you get?

You need

  • A coding agent that reads SKILL.md files (or installs plugins from the repository)
  • Node.js with npx or pnpx, and permission for the agent to run the modern-web-guidance package
  • Optionally, a written browser support policy in your AGENTS.md or CLAUDE.md file

You get

  • Front-end changes built on native HTML, CSS and browser APIs where they fit
  • Fallbacks added only for features that are not yet widely supported
  • A short note at the end of each change naming the guides the agent relied on
  • On request, a scan report of legacy patterns in an existing project

How does it work, step by step?

  1. Install the skillAdd the plugin or copy the skills folder from the GoogleChrome repository into your agent's skills directory.
  2. Allow the lookup toolApprove the agent to run the modern-web-guidance package through npx, scoped to that package only rather than to any npx command.
  3. Write a support policyAdd a line to AGENTS.md or CLAUDE.md saying which browsers you support and how much fallback code you accept.
  4. Build as usualAsk for front-end work in plain words. The agent searches the guides first, then writes the code and lists the guides it used.
  5. Audit older code on purposeWhen you want modernization, ask explicitly for a legacy scan of a folder, review the findings, then let the agent fix the ones you approve.

The prompt

Our adapted version, written to work in Claude Code, Microsoft Copilot and Custom agent. Values in lime are placeholders.

Fill in the blanks (optional; the copied prompt uses your values)

Prompt2 variables
Before you write any HTML, CSS or browser JavaScript for this task, check the modern-web-guidance skill for the pattern involved: {feature}.
Our browser support policy: {support_policy}.
Prefer built-in browser features over new libraries, add fallbacks only where the policy requires them, and do not touch back-end files.
When you finish, list each guide you used and the specific choice it changed in one sentence each. If no guide applied, say which ones you checked.

The original skill is published by GoogleChrome on GitHub (GoogleChrome/modern-web-guidance). Open it there to install or import it; the prompt above is our own adaptation.

What can go wrong?

  • The skill depends on downloading a package at run time. In locked-down sandboxes, approve network access for it before the first task or it will stall.
  • Native features still need testing in the browsers your customers use. Treat the guides as strong defaults, not a replacement for QA.
  • Asking for a full legacy scan on a large repository can produce many findings at once. Work through them in small batches.
  • Granting broad npx permission to make setup easier is risky. Allow only this one package.

Our take

Anyone who has reviewed front-end code from a coding agent has seen the pattern: it reaches for the approach that was popular years ago because that is what most of its training examples show. This project attacks the problem at the source, by giving the agent a current reference and making it look things up before it writes. We like three design choices. The guides are written by people, not generated. The lookup happens locally and returns only what is relevant, so it does not crowd out your own instructions. And each change ends with a short note on which guides were used, which makes review easier. For agencies building small business websites, this is a cheap way to get more accessible pages and fewer dependencies without retraining anyone. Our cautions are practical. It needs a package download at run time, which some sandboxes block, and you should scope the permission to this one tool. In our dry run, an agent asked for a delete confirmation box chose the native dialog element over a modal library and named the guide it followed.

Where the time goes back: Code that uses what the browser already provides needs fewer libraries, less custom JavaScript and fewer accessibility fixes later, so reviews and maintenance get shorter.

FAQ

Who maintains it?
It lives in the GoogleChrome organization on GitHub under the Apache 2.0 license. The launch post says the 1.0 release was made in collaboration with Firefox, MDN and Edge.
Does it fill up my agent's context?
It is designed not to. The agent searches a local index and pulls only the guides that match the task, instead of loading the whole library.
Does it work with React or other frameworks?
Yes. The guides are written in plain HTML, CSS and JavaScript, and the skill tells the agent how to keep the native feature when adapting it to a framework.

Source and credit

This playbook is based on work by GoogleChrome. We summarize it and link to it and write our own adapted prompt.

Original
modern-web-guidance skill (GoogleChrome/modern-web-guidance)
Creator
GoogleChrome
Published on
GitHub (GoogleChrome/modern-web-guidance)
Original date
Nov 10, 2026
License
Apache-2.0
Originally for
Custom agent
AI dry run
Nov 11, 2026: passed. Dry-run tested by our AI test agent on sample input. Native dialog chosen over a library, policy respected, guide named in the closing note.
AI dry run on sample data; not run with live connected accounts. The playbooks.bot test agent filled the prompt with synthetic inputs, produced the output and checked it against the page's stated outputs and guardrails.
Verified
Nov 11, 2026: source link resolves to the original, the credited creator published it, our excerpt or prompt matches it, and the license allows our use.

The original is licensed under Apache-2.0 by GoogleChrome. Modified: our adapted prompt and summary are our own wording; the original skill {"was unchanged at the source when we snapshotted it (live source later removed)" if src_removed(s) else "is unchanged at the source link"}.

Are you the creator? Claim or correct this page.

More in Operations & Admin

All 203 Operations & Admin playbooks →

Related playbooks

Operations & AdminPrompt✓ AI dry run

Rewrite a task prompt to go deeper, not bigger

Before handing an AI an important piece of work, have it explain how a leading practitioner would approach the job, which raw inputs and methods they would use, and what independent check would prove the answer right, then rewrite your request around those answers before any work starts.

Credit: Felix Rieseberg

Minutes
Operations & AdminSkill✓ AI dry run

Stress-test an idea with an honest devil's advocate

Get an AI to argue against your plan one serious objection at a time, offer real alternatives with tradeoffs, and openly mark each concern as resolved, narrowed or still open, so you end with a stronger plan or a better one.

Credit: u/wtfzambo on r/ChatGPTPromptGenius

Minutes
Operations & AdminPrompt✓ AI dry run

Run each project from one page your agents keep current

Have your lead agent give every active project its own living page (goal, status, owners, deadlines, decisions, blockers and a change log), keep a master list of all projects, require every agent to read the page before working and update it afterward, and run a weekday check that only pings you about blocked, late or decision items.

Credit: Michael Fenech (@Michael_Fenech_)

Under an hour
Operations & AdminWorkflow✓ AI dry run

Track coding-agent work as specs and GitHub issues

Turn a feature idea into a written spec, an epic and small GitHub issues that parallel agents can pick up and trace back.

Credit: aroussi on Hacker News

An afternoon+
Operations & AdminWorkflow✓ AI dry run

Keep the check that decides 'done' out of your agent's reach

Stop a coding agent from grading its own homework: write the acceptance check yourself, lock it with a checksum so any edit fails the run, make it measure the finished result rather than read the agent's code, print a specific miss line for each defect, and still look at the result with human eyes before calling it done.

Credit: u/Stunning-Sherbet1853 on r/AI_Agents

Under an hour