agentleFS
IntelliHelperIntelliHelper/agent-skills/skills/liquid-glass/SKILL.md

liquid-glass

Skill1 starsChanged 2 months agoMITView on GitHub

IntelliHelper Liquid Glass design system — chrome vs content layers, frosted surfaces, themes (mono, aurora, sunset, frost, ocean), glass primitives, and visual polish. Use when styling glass UI, choosing button variants, building toolbars vs CTAs, setting themes, or fixing washed-out/over-saturated glass. Triggers: "liquid glass", "glassmorphism", "frosted glass", "chrome layer", "glass-bar", "theme mono aurora", "glass button variant".

11 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

7 rules. 0 are common, 4 are distinctive, and 3 are very specific to this project.

  • 0

    Common

    Most of the 10 edited versions we read keep these.

  • 4

    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:

    Call MCP list_themes for theme IDs and descriptions.

    line 25
  2. Very specific:

    Call get_component for the real variant / size / shape APIs — do not invent them.

    line 26
  3. Distinctive:

    Ensure project CSS loads tokens/themes (init + docs: https://ui.intellihelper.in/getting-started).

    line 27
  4. Very specific:

    Prefer these over custom backdrop-blur one-offs:

    line 43
  5. Distinctive:

    Always re-check exports and prop names via MCP before shipping.

    line 81
  6. Distinctive:

    Contrast: verify light/dark on frosted surfaces (audit checklist).

    line 90
  7. Distinctive:

    Motion: prefer existing component transitions over custom bounce everywhere.

    line 91

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

IntelliHelper UI is a two-layer glass language:

LayerRoleFeelTypical components / variants
ChromeToolbars, icon controls, navigation chrome, secondary actionsNeutral, frosted, Apple mini-playeroutline, secondary, ghost, glass; glass-bar, glass-icon-button
ContentPrimary CTAs, marketing panels, destructive emphasisTheme-saturated, expressiveprimary, destructive; glass-content-card

Rule of thumb: chrome stays quiet so content and data stay legible. One saturated CTA per region is usually enough.

Before styling

  1. Call MCP list_themes for theme IDs and descriptions.
  2. Call get_component for the real variant / size / shape APIs — do not invent them.
  3. Ensure project CSS loads tokens/themes (init + docs: https://ui.intellihelper.in/getting-started).

Themes

IDLabelCharacter
monoMono BasicPure black/white foundational minimal
auroraCool AuroraDeep navy + cyan-violet accents
sunsetWarm SunsetAmber-coral + rose-gold glass
frostNeutral FrostIcy slate, crystalline
oceanDeep OceanTeal depths + aqua accents

Themes drive CSS variables used by glass utilities. Prefer theme tokens over ad-hoc hex for surfaces, borders, and glow.

Glass system components

Prefer these over custom backdrop-blur one-offs:

ComponentUse
glass-barNeutral capsule for grouped media / chrome controls
glass-icon-buttonCircular icon-only chrome actions
glass-content-cardExpressive saturated content panels under chrome
background-picture-pickerMesh/gradient/upload backgrounds for glass stages
component-previewLive preview + source (docs/playground style)
cardFrosted panels for chrome and content layouts

Install (web): npx @intellihelper/cli@latest add glass-bar glass-icon-button card -y
Install (native): npx @intellihelper/cli@latest add @native/glass-bar @native/glass-icon-button @native/card -y

Button language (verify with get_component)

Typical button variants in the design system:

VariantLayerUse
default / glassChrome-ish frostedDefault frosted control
outline / secondary / ghostChromeNeutral toolbars, secondary actions
primaryContentMain CTA
destructiveContentDestructive CTA
linkMaterialText link, no glass chrome

Shapes commonly include rounded, pill, rectangular. Sizes: default, sm, lg, icon.

// Chrome toolbar
<Button variant="outline" size="icon"><Settings /></Button>
<Button variant="ghost">Cancel</Button>

// Content CTA
<Button variant="primary">Continue</Button>
<Button variant="destructive">Delete</Button>

Always re-check exports and prop names via MCP before shipping.

Visual quality bar

Ship interfaces that feel intentional:

  • Hierarchy: one primary action; chrome supports, content leads.
  • Density: pick comfortable (gap-6 / p-6) or compact (gap-4 / p-4) per page — do not mix randomly.
  • Radius: stay consistent with component shapes; avoid stacking many different radii.
  • Contrast: verify light/dark on frosted surfaces (audit checklist).
  • Motion: prefer existing component transitions over custom bounce everywhere.
  • Icons: Lucide at consistent sizes (size-4 / h-4 w-4).

Anti-patterns

  • Glass on every surface (noise, illegible text)
  • Saturated primary chrome on icon toolbars
  • Nested glass cards three levels deep
  • Random gradients + glow competing with theme
  • Ignoring focusRing / keyboard focus styles
  • Using playground internal imports (@intelli/ui, @intelli/ui-native, @intelli/utils) in consumer apps

Progressive disclosure

  • Layer details & pairing → references/layers.md
  • Theme setup notes → references/themes.md
  • Page recipes → skill compose-ui
  • Install path → skill add-component

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.