liquid-glass-skill — Claude Code skill: what it does, how to install
Guides SwiftUI interface development with Apple's Liquid Glass styling for iOS 26 and macOS 26. Helps set up modifiers, grouped glass layers, and UI migrations.
MIT 212 installs ★ 35 updated 2026-10-21
npx skills add podo/design-agent-skills --skill liquid-glass-skill -a claude-codeWhat liquid-glass-skill does
The skill provides guidelines for Apple's Liquid Glass material system. It assists with applying the .glassEffect() view modifier and grouping glass surfaces inside GlassEffectContainer. Interactive components use .buttonStyle(.glass), and patterns reflect code from Apple's Landmarks project.
It accounts for platform-specific behavior across iOS, macOS, tvOS, and visionOS. Included references tackle practical hitches around visual contrast and rendering overhead when stacking multiple translucent views.
Because Liquid Glass APIs do not exist on operating systems before iOS 26, the skill is unusable for legacy software targets.
What it helps with
- group glass surfaces using
GlassEffectContainer - style interactive elements with
.buttonStyle(.glass) - resolve contrast and rendering issues with translucent materials
- migrate pre-26 interface layouts to Liquid Glass
Example prompts for the agent
- Show how to group panels with
GlassEffectContaineron macOS 26. - Apply the
.glassEffect()modifier to this toolbar without dropping contrast. - Help migrate this pre-26 settings view to iOS 26 Liquid Glass.
How to install liquid-glass-skill
1Skills CLI (Vercel)
npx skills add podo/design-agent-skills --skill liquid-glass-skill -a claude-code2Manually: put the files in place
~/.claude/skills/liquid-glass-skill/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/liquid-glass-skill/
1Skills CLI (Vercel)
npx skills add podo/design-agent-skills --skill liquid-glass-skill -a codex2Manually: put the files in place
.agents/skills/liquid-glass-skill/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add podo/design-agent-skills --skill liquid-glass-skill -a cursor2Manually: put the files in place
.cursor/skills/liquid-glass-skill/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install podo/design-agent-skills skills/liquid-glass-skill2Manually: put the files in place
.github/skills/liquid-glass-skill/SKILL.md1Skills CLI (Vercel)
npx skills add podo/design-agent-skills --skill liquid-glass-skill -a gemini-cli2Platform CLI
gemini skills install https://github.com/podo/design-agent-skills --path skills/liquid-glass-skillManually: put the files in place
.devin/skills/liquid-glass-skill/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add podo/design-agent-skills --skill liquid-glass-skill -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about liquid-glass-skill
How to install liquid-glass-skill in Claude Code?
Run npx skills add podo/design-agent-skills --skill liquid-glass-skill -a claude-code in your terminal.
What does liquid-glass-skill do?
It gives the assistant reference data and code patterns for Apple's Liquid Glass interface framework on iOS 26 and macOS 26.
Does liquid-glass-skill work on releases before iOS 26?
No, the underlying Liquid Glass APIs require iOS 26 or macOS 26 and cannot run on earlier versions.
Source text
SKILL.md · MIT
--- name: liquid-glass-skill description: | Deep knowledge of Apple's Liquid Glass design system (iOS 26+/macOS 26+): .glassEffect() modifier, .buttonStyle(.glass), GlassEffectContainer, platform-specific implementations, migration from existing apps, and common pitfalls with tested solutions. triggers: - "Liquid Glass" - "iOS 26 design" - "glassEffect" - "GlassEffectContainer" - "liquid-glass-skill" das: type: skill category: visual-components upstream: "https://github.com/haider-nawaz/liquid-glass-skill" upstream_path: "plugins/liquid-glass/skills/liquid-glass/SKILL.md" version: latest install: false --- # liquid-glass-skill > Catalogue stub — full skill: [haider-nawaz/liquid-glass-skill](https://github.com/haider-nawaz/liquid-glass-skill) <!-- das:install:start — generated from stub.yaml by `npm run generate`; edit stub.yaml, not this block --> ## Decision tree 1. **Is the full skill already installed?** Upstream names this skill `liquid-glass`, so it installs next to this pointer (the pointer is not replaced). - Global: `f=~/.agents/skills/liquid-glass/SKILL.md; [ -f "$f" ] && ! grep -q "^das:" "$f" && echo "installed" || echo "pointer"` - Project: `f=.agents/skills/liquid-glass/SKILL.md; [ -f "$f" ] && ! grep -q "^das:" "$f" && echo "installed" || echo "pointer"` - `installed` → the skill is installed as `liquid-glass`, invoke it and proceed - `pointer` → go to step 2 2. **Detect scope, then install:** ```bash [ -e ~/.agents/skills/liquid-glass-skill ] && echo "global" || echo "project" ``` **Global:** ```bash npx skills add haider-nawaz/liquid-glass-skill --skill liquid-glass -g -y ``` **Project:** ```bash npx skills add haider-nawaz/liquid-glass-skill --skill liquid-glass -y ``` > **Claude Code:** send a command as a chat message starting with `!` to run it without leaving the conversation. **Claude Code plugin route:** ``` /plugin marketplace add haider-nawaz/liquid-glass-skill /plugin install liquid-glass@liquid-glass-skills ``` **Heads-up** - **License:** no LICENSE file in the upstream repo <!-- das:install:end --> ## Invoke after install - Skill name: `liquid-glass` - Plugin route only: the `/liquid-glass:liquid-glass` command - Trigger phrases: "Liquid Glass", "iOS 26 design", "glassEffect", "GlassEffectContainer" ## What it does Provides comprehensive knowledge of Apple's Liquid Glass material system introduced in iOS 26 and macOS 26. Covers the SwiftUI `.glassEffect()` view modifier, `.buttonStyle(.glass)` for interactive elements, `GlassEffectContainer` for grouping glass surfaces, morphing transitions, glass toolbars and tab bars, platform-specific behavioral differences between iOS, macOS, tvOS, and visionOS, a step-by-step migration workflow for apps upgrading from pre-26 designs, and a catalogue of known pitfalls (performance, layering, contrast) with tested solutions. The skill ships API, migration, platform and pitfall reference files plus code patterns from Apple's Landmarks sample. ## When NOT to use - Apps targeting iOS versions before iOS 26 — Liquid Glass APIs are unavailable - Android or cross-platform design — use `mobile-app-design` instead - General SwiftUI patterns beyond Liquid Glass — use `swiftui-claude-skills` or `swiftui-patterns`
© podo · MIT · podo/design-agent-skills