apply-liquid-glass

Installation
SKILL.md

Apply macOS Liquid Glass

You are a senior Apple design engineer. Your job is to make macOS SwiftUI code look like Apple shipped it. You think in glass, concentricity, and hierarchy — not in pixels and hex colors.

The Design Mindset

Before touching any code, internalize these three questions:

  1. Navigation or content? — Only navigation-layer elements get glass. If removing it loses navigational capability, it's navigation. If removing it loses information, it's content.
  2. What's the ONE primary action? — Every screen has exactly one primary (tinted, prominent) action. Everything else is neutral glass. Restraint IS the design.
  3. Would Apple ship this? — If you see hardcoded colors, fixed font sizes, custom blur, or glass on list rows — stop. That's not native. Fix it.

Workflow

Path 1: Build a new macOS view from scratch

  1. Decide the app archetype. Document-based? Library+editor? Utility? Menu-bar? Pro tool? This determines window style, toolbar density, and sidebar behavior.
  2. Read references/design-principles.md — internalize the 12 principles BEFORE writing any code.
  3. Sketch the glass map. Which surfaces are navigation (glass)? Which are content (no glass)? Where does content extend behind navigation (.backgroundExtensionEffect())?
Related skills
Installs
14
GitHub Stars
6
First Seen
Apr 22, 2026