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

liquid-glass-debug

Skill0 starsChanged 7 days agoMITView on GitHub

Use when glass works in Chrome but is broken on iPhone, bend/refraction is missing in Safari, rim looks painted or like a border, glass looks like plastic, backdrop-filter url() paints nothing, edges are square, nested glass is milky, or optical measurements must be verified.

The file

We split this skill into the rules it gives an agent

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

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈3

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 2

    Very specific

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

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

    Start with the symptom, then use the full first checks and diagnostic order in ../../shared/references/11-failure-catalogue.md.

    line 8
  2. Very specific:

    Strategy/parity: use liquid-glass-optics for WebGL2, per-geometry maps or reference matching.

    line 50
  3. Distinctive:

    Run from the suite root. Map/chroma scripts use the Python standard library.

    line 54
  4. Distinctive:

    Test the actual target engine and the explicit fallback.

    line 72
  5. Distinctive:

    Verify reduced transparency, reduced motion, forced colors, corner geometry and the built bundle after the last edit.

    line 73

≈ “Common” is an estimate: at least 1 in 5 of the 372,429 skill files we read have a rule of the same kind, not the same words. “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 debug

Start with the symptom, then use the full first checks and diagnostic order in ../../shared/references/11-failure-catalogue.md. Do not tune tokens before checking chain delivery, wiring, filter region and map alpha.

#Symptom / entryFirst move
S01Just blur, not glassCheck live url() and edge/interior structure
S02Frosted plasticPut url() last; remove blur after it
S03Rim looks like a painted/dirty borderRemove rim blur; use mask + inset treatment
S04White rim on white panelMeasure contrast ceiling; change structure
S05Shine is a static stripeUse size-relative rim thickness
S06Same shine on every panelCheck where clamp() stops binding
S07Shine does not track pointerVerify delegated flare listener
S08Nearest edge does not brightenCheck distance ramp and eased boost
S09Transparent even at edgesFind a zero-floored feather mask
S10Bottom/some corners squareClip rectangular children
S11Curved panel, square blurRestore exact filter region; widen map ramp
S12Dark glass looks flat/plasticCheck opacity, shadow, then dim law
S13Practically blackCheck for affine/flat-multiply dim
S14Flat on the groundMeasure backdrop luminance range
S15Rim present, bend lostCheck computed url() and live filter IDs
S16Thicker rim made it worseInspect hard-cutout mask
S17Still lines, now thickerA ring cannot fade inward
S18Change made it flatterDiff mask, shadow and bend layers separately
S19Something indescribably offFix a starved backdrop field first
S20Line behind panelsProve transmitted content vs painted line
S21Logo disappearedCheck per-theme color-math filters
S22Logo is just a circlePreserve raw computed token before transforms
S23Menu closes before shape returnsFit child exit inside container budget
S24Ghost blur after closeNever fade opacity on filter carrier; split veil
S25Cards resize/jelly on scrollRemove content-visibility:auto
S26Panels lag scrollCheck compositor vs rAF clocks
S27Pointer is a flashlightSize falloff in px against rim thickness
S28White stripe through bodyDelete the diagonal glint layer
S29Washed-out/milky panelDe-nest glass; stop stacking fills
S30Chrome works, iPhone brokenSVG backdrop is WebKit-blocked; keep fallback or use WebGL2
S31Bend/refraction not showingurl() last, map alpha 255, output not raw map
S32Bend is not curvedCheck square map and oversized filter region
S33Rim and panel corner disagreeRebuild map from painted corner geometry

Engine quirks

  • Chromium: alpha-0 maps die; filters cache by ID; backdrop ends at the element edge; transforms can skew the lens. See ../../shared/references/05-chromium-quirks.md.
  • Safari/WebKit: backdrop-filter:url() is blocked in documented WebKit behaviour (245510); content filter:url() is different. Filter IDs cache, promoted children can leave an ancestor filter, and Playwright WebKit is not a real iPhone — the owner's physical iPhone Safari renders the standalone showcase's bend (2026-11-08; verify on target versions). See ../../shared/references/06-safari-webkit.md.
  • Strategy/parity: use liquid-glass-optics for WebGL2, per-geometry maps or reference matching. A syntax @supports result is not paint evidence.

Measure

Run from the suite root. Map/chroma scripts use the Python standard library; edge profiles require Pillow.

python shared/scripts/measure-displacement-map.py tests/fixtures/lens-map.png --scale 40
python shared/scripts/edge-profile.py tests/fixtures/rim-swatch.png --at 0.45 --span 40
python shared/scripts/chroma-retention.py --in 240,232,210 --sat 1.4 --wash 0.30 --tint 31,29,41
python -m unittest discover -s tests -v
node scripts/build-showcase.mjs --check

For app maps, replace the fixture path and declared scale; for rim/glow/cutout comparisons use the corresponding fixture. Commands, live-bundle audits and thresholds are in ../../shared/references/10-measurement.md. Run npm test only when Playwright browsers are installed; otherwise report browser behavior untested.

Verification gate

From ../../shared/references/15-honesty-and-checklists.md:

  1. Capture a large panel over a fine grid; small screenshots hide edge/region defects.
  2. Over ruled stripes, prove compression/flipping at the edge; include a zero-effect control.
  3. Test the actual target engine and the explicit fallback; content-filter success does not prove SVG-backdrop support.
  4. Verify reduced transparency, reduced motion, forced colors, corner geometry and the built bundle after the last edit.
  5. Report renderer, browser, geometry, settings and actual output. Never claim an unrun check, real-device pass or visual parity.

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.