agentleFS
Alice39sAlice39s/agent-stash/skills/modern-web-guidance/SKILL.md

modern-web-guidance

Skill20 starsChanged 21 days agoApache-2.0View on GitHub

Offline copy of GoogleChrome/modern-web-guidance: 208 guides on modern HTML, CSS, and client-side JavaScript (dialogs, popovers, anchor positioning, container queries, view transitions, scroll-driven animations, forms, autofill, validation, accessibility, dark mode, Core Web Vitals, image loading, security, passkeys, sanitization, web components, built-in AI, WebMCP). Use before writing or changing web UI, CSS layout or animation, or browser-side JS, including HTML/CSS/DOM inside React, Vue, or other frameworks. Not for backend code, build tooling, CI, or tests.

20 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use chrome-extensions, code-review-and-quality and 1 more.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • thistleknotSkill

    chrome-extensions

    Build, install and verify a personal Chrome extension that does something on the local machine (write a file, run a script) when its toolbar button is clicked. Covers the Manifest V3 extension + native-messaging host pattern, pinning the extension ID with a "key", registering the host under HKCU (no admin), the one manual "Load unpacked" step and why automation cannot do it, and how to test the real Chrome round trip yourself without clicking the toolbar. Trigger on "chrome extension", "browser button that saves to a file", "native messaging", "clip the page to a file", "load unpacked", "extension shows a red !".

    Also in 4 projects that use this

  • LLl0k0laDSkill

    code-review-and-quality

    Use before merging any change. Use when reviewing code written by yourself, another agent, or a human. Use when you need to assess code quality across multiple dimensions before it enters the main branch.

    Also in 3 projects that use this

  • VercelSkill

    find-skills

    Helps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express interest in extending capabilities. This skill should be used when the user is looking for functionality that might exist as an installable skill.

    Also in 3 projects that use this

The file

We split this skill into the rules it gives an agent

5 rules. 0 are common, 2 are distinctive, and 3 are very specific to this project.

  • 0

    Common

    Most of the 20 edited versions we read keep these.

  • 2

    Distinctive

    This author's own choices. Worth a look.

  • 3

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    Read the matching guides in full, plus the discipline guide of the same category when the table below lists one.

    line 18
  2. Distinctive:

    Write the code with the guide's patterns and fallbacks, then check the result against the guide and the user's request before finishing.

    line 19
  3. Distinctive:

    When no guide matches after a second search, continue without one.

    line 20
  4. Very specific:

    When the user or the project states a support policy (for example Safari 17.4+ or Baseline 2024), use the compatibility data in the guide …

    line 29
  5. Very specific:

    Call showModal() and similar methods through refs, generate per-instance IDs and anchor-name values, and keep :root and @starting-style …

    line 37

“Common” is measured: kept by at least 6 in 10 of the 20 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Modern Web Guidance

Guides from GoogleChrome/modern-web-guidance, copied from npm modern-web-guidance@1.0.0 (skill version 2026_11_09-5bcc021b, published 2026-11-10). Each guide is references/<category>/<id>.md; each category's index.md lists its guides with a one-line description, a token count, and feature gates.

Workflow

  1. Find guides. Open the index of each category that fits the task, or search all indexes at once: rg -i "<keyword>" references/*/index.md. Search by the user-visible capability or the UI primitive it implies (confirm dialog, date picker), not by framework or app names, and search once per feature when a task touches several.
  2. Read the matching guides in full, plus the discipline guide of the same category when the table below lists one. Guides cite other guides as npx -y modern-web-guidance@latest retrieve "<id>"; read references/*/<id>.md for those instead of running the command.
  3. Write the code with the guide's patterns and fallbacks, then check the result against the guide and the user's request before finishing.
  4. When no guide matches after a second search, continue without one.

Feature gates

A guide with an Origin Trial or Volatile entry in the Gate column relies on an experimental Origin Trial API or on a feature that ships in one engine only or is still changing. Use such a guide only when the user agrees, or when .mwgrc in the project root (or ~/.mwgrc) sets "allowOriginTrials": true or "allowVolatileFeatures": true respectively.

Browser support

  • Baseline Widely available features need no fallback. For any other feature, follow the fallback the guide gives.
  • When the user or the project states a support policy (for example Safari 17.4+ or Baseline 2024), use the compatibility data in the guide to decide which fallbacks to keep. A feature meets a Baseline YYYY target when its Baseline year is YYYY or earlier.

Frameworks

The guides use plain HTML, CSS, and JavaScript. Keep the platform feature when porting to a framework:

  • Pass new HTML attributes that the framework types do not know yet (popover, commandfor, interestfor) through a spread or cast instead of dropping them.
  • Guard window and DOM globals during server rendering, and load polyfills with a dynamic import() on the client.
  • Call showModal() and similar methods through refs, generate per-instance IDs and anchor-name values, and keep :root and @starting-style rules unscoped.

Categories

CategoryGuidesDiscipline guideIndex
accessibility4accessibilityindex
built-in-ai4-index
css18cssindex
forms19formsindex
html8htmlindex
js5-index
performance26performanceindex
privacy1privacyindex
pwa2-index
security17securityindex
ui-atoms13-index
ui-behaviors40-index
ui-components22-index
user-experience3-index
visual-design22-index
wasm1-index
webmcp3webmcpindex

Source and license

The guide text is from GoogleChrome/modern-web-guidance and is licensed under CC-BY 4.0; parts of it derive from MDN Web Docs and from W3C, WHATWG, and IETF specifications. sources.json records the package version, tarball, and the upstream index entry of every guide. scripts/sync-modern-web-guidance.ts in Alice39s/agent-stash copies the guides and writes this file and the category indexes.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.