Guide · Agent skill

How to use the SwiftUI Liquid Glass agent skill

Updated 2026-11-02 · written with AI from the project's own documentation and checked against our catalogue data

The swiftui-liquid-glass skill is a set of SwiftUI rules that teaches an AI agent how to build and review Apple's iOS 26 Liquid Glass visual style using native APIs. It is aimed at iOS developers adopting the design in an existing SwiftUI app, and at anyone who wants a review focused on Liquid Glass correctness and performance. After this guide you will know how to install the skill, ask for the work in plain language, and check the agent's output before you ship it.

SwiftUI Liquid Glasssteipete/agent-scripts · MIT Download the skill

Quick start

1Download the ZIP. Download the swiftui-liquid-glass ZIP from this page and unzip it.
2Place the skill folder. Move the unzipped folder into ~/.claude/skills/ for personal use, or into your project's .claude/skills/ folder.
3Or upload in the Claude apps. In the Claude apps, go to Settings → Capabilities → Skills and upload the skill instead.
4Make a natural request. Describe the SwiftUI screen and say whether you want a review, a refactor or a new feature using Liquid Glass.
5Check the availability fallback. Confirm the output wraps glass code in #available(iOS 26, *) and includes a non-glass fallback.
6Build and test in Xcode. Build with an iOS 26 SDK and test the screen on a device or simulator before shipping.

What is an agent skill and what does this one make the agent do?

An agent skill is a folder of instructions that an AI agent reads when a task matches it. This one is named swiftui-liquid-glass and is built around a SKILL.md file plus a reference guide, references/liquid-glass.md.

Once installed, the agent follows SwiftUI rules for Liquid Glass. It prefers native modifiers such as glassEffect, GlassEffectContainer and glass button styles over custom blurs, adds an #available(iOS 26, *) check with a non-glass fallback, and groups and animates glass elements correctly. It can review a screen against a checklist or help add glass to a new feature.

Review an existing feature for modifier order, shape usage, container placement and availability handling.
Improve a feature by wrapping multiple glass elements in GlassEffectContainer and making only tappable elements interactive.
Implement a new feature by designing glass surfaces, grouping and interactions first, then adding morphing transitions where the view hierarchy changes.

How do you install the swiftui-liquid-glass skill?

Download the ZIP for this skill from this page and unzip it. For a personal setup, place the unzipped skill folder in ~/.claude/skills/. To scope it to one project, place it in that project's .claude/skills/ folder instead.

If you use the Claude apps, you can instead upload the skill under Settings → Capabilities → Skills.

Personal install: ~/.claude/skills/
Project install: .claude/skills/ inside your project
Claude apps: Settings → Capabilities → Skills

How do you trigger the skill with a natural request?

You do not need a special command. Describe the task in SwiftUI terms and mention Liquid Glass or iOS 26, so the agent matches the request to the skill. The skill's description covers implementing, adopting, refactoring and reviewing for correctness, performance and design.

Be specific about the screen or component and whether you want changes or a review. The agent will then choose the matching path from its decision tree.

"Review my ProfileView for Liquid Glass correctness, including availability checks and modifier order."
"Add Liquid Glass to the toolbar buttons in this SwiftUI screen with a fallback for older iOS."
"Refactor these three chips into a GlassEffectContainer and make only the tappable ones interactive."
"Implement a new card feature using Liquid Glass; design the glass surfaces first."

What code patterns should you expect?

The skill's examples show the basic single-view pattern, a grouped pair of glass icons in a container, and a prominent glass button. The first example gates the glass with #available(iOS 26, *) and falls back to ultraThinMaterial on older systems.

Expect the agent to use the same shapes and spacing across related elements, and to apply .glassEffect after layout and appearance modifiers.

if #available(iOS 26, *) {
    Text("Hello")
        .padding()
        .glassEffect(.regular.interactive(), in: .rect(cornerRadius: 16))
} else {
    Text("Hello")
        .padding()
        .background(.ultraThinMaterial, in: RoundedRectangle(cornerRadius: 16))
}

What do you need before using it?

The skill needs Xcode and an iOS 26 SDK to build and test the SwiftUI code. It also needs an agent runtime that can read the SKILL.md and references/liquid-glass.md files. It does not run scripts and does not use the network.

It is not suitable for apps that must support only pre-iOS 26 systems or non-Apple platforms, because the APIs will not compile or apply there. It also does not apply to UIKit-only or Android code.

Xcode with an iOS 26 SDK
An agent runtime that can read SKILL.md and references/liquid-glass.md
Runs scripts: no
Uses network: no

Is it safe to install?

According to the skill's metadata, it runs no scripts and makes no network requests. It consists of instructions and reference text, so the main thing to check is the code the agent writes. Review any generated SwiftUI in Xcode and test it on an iOS 26 device or simulator before merging.

The skill is released under the MIT licence.

Tips for better results

Give the agent the real view code rather than a description, so it can check modifier order and container placement. Name the older iOS version you still support so the fallback path is included. Ask for a review first when you are unsure how much glass a screen should have.

The skill's own guidance notes that Apple's docs are the up-to-date source for API details, so verify any unfamiliar modifier against them.

Paste the actual SwiftUI view, not a summary.
Ask for the availability fallback explicitly.
Use review mode before refactoring a working screen.
Check current Apple documentation for API details.

What people use it for

Adding glass button styles such as buttonStyle(.glass) to an existing iOS 26 SwiftUI screen.
Reviewing a feature for modifier order, interactive glass only on tappable elements, and consistent shapes.
Grouping several glass chips or icons in a GlassEffectContainer with tuned spacing.
Adding morphing transitions with glassEffectID and @Namespace when a view hierarchy animates.
Learning which SwiftUI modifiers Apple's glass style uses by reading the generated code and references.

Frequently asked questions

Is the swiftui liquid glass skill free?

The skill is released under the MIT licence, as stated on this page. Check the licence file in the source repository for the full terms.

What do I need to use the swiftui-liquid-glass skill?

You need Xcode with an iOS 26 SDK to build and test the code, and an agent runtime that can read SKILL.md and references/liquid-glass.md. The skill runs no scripts and uses no network.

Where do I install the swiftui-liquid-glass skill?

Unzip the downloaded ZIP into ~/.claude/skills/ for personal use, or into a project's .claude/skills/ folder. In the Claude apps you can upload it under Settings → Capabilities → Skills.

Does it work for apps that support iOS 16 or 17?

The skill gates Liquid Glass with #available(iOS 26, *) and provides a fallback using materials, so older systems get a non-glass look. Apps that must support only pre-iOS 26 systems are not a good fit, because the APIs will not compile or apply there.

Can I use it for UIKit or Android projects?

No. The instructions cover SwiftUI only, so UIKit-only and Android code are outside its scope.

How is this different from just asking an AI for SwiftUI code?

The skill gives the agent a fixed set of Liquid Glass rules and a review checklist covering availability, container use, modifier order, interactivity and transitions. A general prompt may not apply those checks consistently.

New agent skills, repos and AI tools — every week

The best new skills and open-source projects, the fastest-growing repos, and one free prompt. Five minutes to read. Unsubscribe anytime.

Our verdict

This skill suits iOS developers who are adopting the iOS 26 Liquid Glass design in an existing SwiftUI app, and anyone who wants Liquid Glass-focused code reviews. If your app must support only pre-iOS 26 systems, or your code is UIKit-only or Android, pick a different resource because these instructions will not apply.

Download the skill