What is the glassmorphism skill?
Glassmorphism is a skill in the pedronauck/skills repository for creating or refining glass interfaces. It tells an AI coding agent to pick glass only where a backdrop gives it something to show, to ship a solid twin first, and to measure text contrast on the rendered result.
It is a skill in Pedro Nauck's skills repository, filed under the mine bucket. Its description says it creates or refines glass UI with accessible solid fallbacks, covering frosted surfaces and Liquid Glass while excluding unrelated UI and 3D glass rendering.
What changes in your agent's output
- The agent separates environment, content and chrome first, and uses glass only for chrome such as toolbars, docks, popovers and small widgets.
- Over flat color it picks a tinted solid, because the blur has nothing to sample and the surface turns into a gray box.
- Ink is chosen by the luminance behind the surface: white on a thin tint over dark scenes, dark ink on white frost over pale ones.
- One light direction drives the rim, highlight, sheen and shadow, so edges do not all glow at once.
- Tables, editors, long text and forms stay on a solid reading plane.
How it is organized
SKILL.md stays short and loads one reference only when needed: art direction, web engineering, accessibility and validation, or advanced platforms. A runnable material lab page and a glass.css file sit in the assets folder for adapting.
Who the skill is for
Best for
- Designers and developers who want glass that survives real backdrops, themes and accessibility settings.
- Web projects using plain CSS, Tailwind, React or shadcn, which the web engineering reference covers.
- Teams that also target native Liquid Glass, visionOS, Fluent or Material through the advanced platforms reference.
Not for
- Pages that need glass across long reading content, which the skill sends to a solid panel.
- 3D glass rendering, which its description excludes.
- Projects that cannot afford backdrop filters on low-end devices, since the skill caps glass at one to three surfaces per view.
For a darker take on the same material see glass-dark-ui. To check text against the background it sits on, pair it with color-system or accessibility-audit.
How to install Glassmorphism Skill for AI Coding Agents
git clone https://github.com/pedronauck/skills.gitThe repository holds many other skills. Copy only the folder you want.Clone the repository
Run
git clone https://github.com/pedronauck/skills.git. The skill is the skills/mine/glassmorphism folder.Copy the skill folder
Copy skills/mine/glassmorphism, including its references and assets folders, into your AI coding agent's skills folder. SKILL.md loads references on demand.
Open a project with a visual backdrop
Start the agent in a project that has imagery or a gradient behind the surfaces you want to turn into glass.
Ask for a glass surface
Request a toolbar, card or popover and review the result against the skill's validation list.
Check that it loaded
Ask for a floating toolbar over a photo. The result should use a thin light fill, a solid fallback inside a feature query and a stated ink choice, not a heavy blur on the whole page.
Key features
- Material job firstReads the brief for platform, reading density, backdrop owner, themes and devices, then separates environment, content and chrome before styling.
- Surface decision tableMaps toolbars, widgets, popovers, tables, modals and primary actions to glass, plate, solid or scrim.
- Backdrop and ink rulesChooses white, smoked or dark ink by the luminance behind the surface and measures it rather than guessing.
- One locked light directionA single light variable drives the rim, inset highlight, sheen falloff and elevation shadow.
- Thickness presetsStarts from clear, regular and frosted presets and adds a plate under dense text instead of raising overall alpha.
- Solid twin firstDeclares an opaque fill and ink pair, then enhances inside a feature query, with a solid mode for reduced transparency and forced colors.
- Backdrop filter budgetKeeps live blur to one to three surfaces per view, never glass on glass, never animated blur.
- Optional refractionSmall controls can use a displacement map through a backdrop filter that only Chromium renders, falling back to frost.
- Validation passChecks visual, functional, accessible and rendering states and discloses untested engines and devices.
Frequently asked questions
What is the glassmorphism skill?
It is a skill in the pedronauck/skills repository that guides an AI coding agent through building frosted glass interfaces. It covers the material, the CSS, contrast and accessibility fallbacks, and excludes unrelated UI and 3D glass rendering.
How do I install the glassmorphism skill?
Clone pedronauck/skills and copy the skills/mine/glassmorphism folder, with its references and assets, into your agent's skills folder. The repository README also lists a skills CLI route and a bucket based install for the whole repository.
Why does glass look gray over a flat color?
The skill explains that blur needs something to sample. Over a flat color there is nothing to blur, so the surface reads as a gray box. It recommends a tinted solid there, or a composed backdrop with a luminance ramp.
How does it keep text readable on glass?
It picks the ink by the luminance behind the surface, adds a stabilized plate under dense content and says to measure contrast against the rendered composite. Long reading text should sit on a solid plane.
Does it work in every browser?
The core glass uses backdrop filters. The lens refraction effect renders only in Chromium and the skill says it must degrade to frost. It also says to declare the solid version first and enhance inside a feature query.
How many glass surfaces should a page have?
The skill sets a budget of one to three glass surfaces per view, with the navigation layer counting as one and at most one transient sheet above it. It also bans glass on glass and animated blur.
Which skills pair with it for contrast and accessibility checks?
Use color-system for tonal scales that hold contrast, and web-accessibility-skill for a broader audit of the finished page. Glassmorphism covers the material, and those two cover verification of the result.


