Individual skill
liquid-glass-ui
Implement, restyle, or debug interactive liquid glass in web interfaces. Use for refractive buttons, switches, sliders, segmented controls, toolbars, and floating surfaces with press, drag, or merge behavior. Choose CSS glass for arbitrary page content or WebGL2 refraction for a backdrop the app can supply as pixels.
SKILL.md
Source commit e9ad85dfd5cdef8cc4d22dea1798795e1fb8db48
What was checked
- Matches the observed repository HEAD
- Yes
- Scanner rules are current
- No
- Repository scan complete
- No
- Skill scan complete
- No
- Observed behavior
- Not checked yet
- Last checked
- Nov 6, 2026
These are observations at the recorded commit, not a guarantee of safety. Review the source before running it.
Install this skill
Choose an agent in your Stack or copy a command below. Commands fetch the pinned commit and copy only this skill directory. Existing destinations are refused. Copying a command does not install anything.
An install command is unavailable: current rules, complete repository and skill scans, an eligible behavior level and a permitted license are required.
Repository context
- Repository stars (not skill ratings)
- 4
- Repository last updated
- Nov 5, 2026
- License
- MIT
Observed agent integration: No specific integration evidence. Standard SKILL.md installation does not imply verified compatibility.
- agent-skills Repository topic
- codex Repository topic
- design-tools Repository topic
- liquid-glass Repository topic
- refraction Repository topic
- ui-components Repository topic
- webgl2 Repository topic
- design Derived category
- writing Derived category
- design-interface Derived category
Files and excerpt
File metadata and permitted, redacted excerpts come from the recorded scan. Source links are pinned to that commit.
Browse files
.github/workflows/pages.ymlasset · 1,692 bytes.gitignoreasset · 234 bytesLICENSEasset · 1,085 bytesREADME.mddoc · 5,992 bytesREADME_CN.mddoc · 5,689 bytesREADME_JA.mddoc · 7,536 bytesSKILL.mdcore · 4,339 bytesSKILL.mdcore · 4,339 bytesSKILL.mdcore · 4,339 bytesSKILL.mdcore · 4,339 bytesTHIRD_PARTY_NOTICES.mddoc · 1,490 bytesagents/openai.yamlasset · 219 bytesassets/LICENSE-lucideasset · 3,208 bytesassets/glass-backdrop.svgasset · 1,830 bytesassets/glass-button.jsruns · 25,269 bytesassets/glass-grid.svgasset · 573 bytesassets/glass-motion.jsruns · 2,397 bytesassets/liquid-glass-renderer.jsruns · 33,614 bytesassets/liquid-glass.cssasset · 4,121 bytesassets/liquid-glass.jsruns · 1,667 bytesassets/mount-liquid-glass.jsruns · 2,665 bytesassets/wallpapers/daisy.jpgasset · 119,517 bytesassets/wallpapers/lake.jpgasset · 3,237,854 bytesassets/wallpapers/prism.jpgasset · 116,622 bytesdemo/button-editor.jsruns · 23,982 bytesdemo/demo.cssasset · 25,000 bytesdemo/demo.jsruns · 34,700 bytesdemo/glass-menu.jsruns · 4,012 bytesdemo/icon-picker.jsruns · 8,504 bytesdemo/index.htmlasset · 11,436 bytesdemo/language.jsruns · 11,204 bytesdemo/lucide-catalog.jsonasset · 770,147 bytesdemo/merge-outline.jsruns · 3,002 bytesdemo/outline-editor.jsruns · 12,034 bytesdemo/replica.jsruns · 3,179 bytesdemo/shape-picker.jsruns · 4,227 bytesdocs/media/liquid-glass-ui-demo.mp4asset · 11,534,004 bytespackage-lock.jsonasset · 1,240 bytespackage.jsonruns · 404 bytesreferences/acceptance.mddoc · 1,393 bytesreferences/design-system.mddoc · 1,789 bytesreferences/integration.mddoc · 11,396 bytesreferences/validation.mddoc · 1,027 bytesscripts/package.mjsruns · 3,536 bytesscripts/serve.mjsruns · 3,190 bytesscripts/verify.mjsruns · 72,776 bytes
Read excerpt
# Liquid Glass UI
Apply glass only to the named buttons or controls. Preserve the host background, layout, labels, and behavior. Before editing, state the target controls and confirm any unspecified visual choice. A change to another part of the interface requires a separate agreement.
## Confirm the button design
Use a design the user has already selected or pasted. Otherwise, open the demo at `http://localhost:58423/demo/` and ask the user to choose a control and click **Copy for AI**. Start `node scripts/serve.mjs` from the skill directory if needed. Before asking for the selection, read the baseline `copiedAt` from `GET http://localhost:58423/api/glass-handoff`. Use a newer handoff or the clipboard payload the user provides. Wait for the choice before editing the target.
Pass the returned configuration directly to the matching runtime. Version 2 uses `createLiquidGlassButton` from `assets/glass-button.js`. Version 3 uses `mountLiquidGlassReplica` from `demo/replica.js` for moving controls or group selections. Use the revision specified in a clipboard handoff. Use the existing page's readable source and preserve the crop, layout, and original actions. See the [handoff integration recipes](references/integration.md#integrate-a-copied-design). When the host pixels cannot be read, explain the available fallback and confirm it before editing the target.
## Choose the rendering path
- **CSS glass** fits arbitrary DOM, text, and scrolling content. Copy `assets/liquid-glass.css` for blur, tint, and a rim. Add `assets/liquid-glass.js` only if the user wants pointer highlights. CSS glass cannot bend or merge backdrop pixels.
- **WebGL2 refraction** fits images, video, and canvases controlled by the app. Copy `assets/liquid-glass-renderer.js` and `assets/mount-liquid-glass.js`. Keep the actual controls in HTML above an `aria-hidden` canvas. Use the app's original layout and a permitted backdrop.