agentleFS
admos98admos98/liquid-glass-suite/skills/liquid-glass/SKILL.md

liquid-glass

Skill0 starsChanged 7 days agoMITView on GitHub

Use when asked to "make this glass", glassmorphism, frosted or translucent UI, Apple-like UI, or a glass nav/card/modal/dropdown. Drop-in CSS recipes for navigation, tab bars, cards, sheets, buttons, search, sidebars, sliders, React and Tailwind v4.

14 other projects use a version of this.

Adopted by

Most recently taken up by

The file

We split this skill into the rules it gives an agent

2 rules. 0 are common, 1 is distinctive, and 1 is very specific to this project.

  • 0

    Common

    Most of the 13 edited versions we read keep these.

  • 1

    Distinctive

    This author's own choices. Worth a look.

  • 1

    Very specific

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

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

    Every browser keeps blur+saturate.

    line 25
  2. Distinctive:

    Tint colorless: keep the material's tint neutral.

    line 49

“Common” is measured: kept by at least 6 in 10 of the 13 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

Liquid Glass

Refraction, not blur: glass is the floating layer, never the content.

60-second path

From this skill's directory, copy the two blessed files into the app:

cp ../../shared/assets/liquid-glass.css /path/to/app/
cp ../../shared/assets/liquid-glass.js /path/to/app/
<link rel="stylesheet" href="liquid-glass.css">
<script src="liquid-glass.js"></script><!-- before the first glass element -->
<nav class="lg lg--backdrop">Navigation</nav>

Every browser keeps blur+saturate; bend is additive and enabled only by the paint probe plus the conservative Chromium gate. Use lg--backdrop on floating surfaces; omit it for static cards and inset inputs.

Recipe index

Open recipes.md for minimal HTML, theme tokens, fallback and the surface's pitfall.

SurfaceUse whenClassesNotes
Navigation barFloating top navlg lg--backdropFloating chrome, not page content
ToolbarControls over contentlg lg--backdropKeep the toolbar above the content layer
Tab barFloating tabslg lg--backdropOne carrier around the tab list
Floating cardPopover-like cardlg (+ gated bend if floating)Ordinary content cards stay standard material
Modal / sheetTransient overlaylg lg-strong lg--backdropFew, transient strong surfaces
Dropdown / popoverFloating menulg lg-strong lg--backdropStrong fill aids readability
Button / FABFloating action or controllg lg--backdropNo pointer rim on an icon-only FAB
Search fieldInset inputlg lg-insetConcave fill; no displacement or rim
SidebarStructural dark overlaylg lg-dark lg--backdropDark fill and on-dark text
SliderOnly while activatedlg lg--backdropTransient glass exception

Framework variants are in the final section of recipes.md.

Three rules

  1. Floating layer, not content: navigation and overlays get glass; lists, tables, media and ordinary content cards do not.
  2. Tint colorless: keep the material's tint neutral; let the refracted/saturated backdrop supply color.
  3. Never animate opacity on a backdrop-filter carrier: fade a separate scrim and keep motion off the filter element.

Escalation

Bend/rim/Safari/reference-matching problems → liquid-glass-optics for strategy/parity or liquid-glass-debug for symptom-led diagnosis. SwiftUI/UIKit/AppKit → liquid-glass-native.

Part of liquid-glass-suite — install the suite, not this folder alone.

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.