# Swiftui Liquid Glass

SwiftUI Liquid Glass: implement, adopt, refactor, review correctness/perf/design.

- Repository: https://github.com/steipete/agent-scripts (7431 stars)
- Category: Design
- License: MIT
- Last updated: 2026-10-30
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add steipete/agent-scripts --skill swiftui-liquid-glass -g -a claude-code -y`
Codex: `npx skills add steipete/agent-scripts --skill swiftui-liquid-glass -g -a codex -y`
Cursor: `npx skills add steipete/agent-scripts --skill swiftui-liquid-glass -g -a cursor -y`
Gemini CLI: `npx skills add steipete/agent-scripts --skill swiftui-liquid-glass -g -a gemini-cli -y`

## Description

SwiftUI Liquid Glass: implement, adopt, refactor, review correctness/perf/design.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# SwiftUI Liquid Glass

_Attribution: copied from @Dimillian’s `Dimillian/Skills` (2025-12-31)._

## Overview
Use this skill to build or review SwiftUI features that fully align with the iOS 26+ Liquid Glass API. Prioritize native APIs (`glassEffect`, `GlassEffectContainer`, glass button styles) and Apple design guidance. Keep usage consistent, interactive where needed, and performance aware.

## Workflow Decision Tree
Choose the path that matches the request:

### 1) Review an existing feature
- Inspect where Liquid Glass should be used and where it should not.
- Verify correct modifier order, shape usage, and container placement.
- Check for iOS 26+ availability handling and sensible fallbacks.

### 2) Improve a feature using Liquid Glass
- Identify target components for glass treatment (surfaces, chips, buttons, cards).
- Refactor to use `GlassEffectContainer` where multiple glass elements appear.
- Introduce interactive glass only for tappable or focusable elements.

### 3) Implement a new feature using Liquid Glass
- Design the glass surfaces and interactions first (shape, prominence, grouping).
- Add glass modifiers after layout/appearance modifiers.
- Add morphing transitions only when the view hierarchy changes with animation.

## Core Guidelines
- Prefer native Liquid Glass APIs over custom blurs.
- Use `GlassEffectContainer` when multiple glass elements coexist.
- Apply `.glassEffect(...)` after layout and visual modifiers.
- Use `.interactive()` for elements that respond to touch/pointer.
- Keep shapes consistent across related elements for a cohesive look.
- Gate with `#available(iOS 26, *)` and provide a non-glass fallback.

The rest: https://github.com/steipete/agent-scripts/blob/HEAD/skills/swiftui-liquid-glass/SKILL.md