macos-liquid-glass-designer

macos-liquid-glass-designer is a skill for Claude Code, Codex from Xopoko/build-swift-apps. It costs 42 tokens per session (641 once invoked), scanned A, original, MIT.

A guide for updating macOS SwiftUI interfaces to use Apple's current system materials, including Liquid Glass, the translucent appearance used by newer macOS interfaces. It keeps standard app structures and controls at the center.

In plain words
What is it for?
Use it when modernizing sidebars, split views, tabs, sheets, inspectors, toolbars, floating controls, or media-focused layouts in a macOS SwiftUI app.
Why use it?
It reduces custom backgrounds and decorative layers that conflict with the operating system's appearance. It also helps decide when a custom glass surface is actually needed.

Skill for Claude CodeCodex

Written for Claude Code and Codex: shipped in a Claude Code plugin, but also agents/openai.yaml present.

Part of the build-swift-apps plugin — 61 skills, 3 commands, 3 MCP servers shipped together

Good fit Use it when modernizing sidebars, split views, tabs, sheets, inspectors, toolbars, floating controls, or media-focused layouts in a macOS SwiftUI app.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/xopoko/build-swift-apps/macos-liquid-glass-designer
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add Xopoko/build-swift-apps --skill macos-liquid-glass-designer
Clone the repo
git clone --depth 1 https://github.com/Xopoko/build-swift-apps

Made for: Claude Code, Codex.

Or install build-swift-apps, the plugin that ships this one along with the rest of its 61 skills, 3 commands, 3 MCP servers.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for macos-liquid-glass-designer

README.md
[![agentmods](https://agentmods.dev/badge/skills/xopoko/build-swift-apps/macos-liquid-glass-designer/github.svg)](https://agentmods.dev/skills/xopoko/build-swift-apps/macos-liquid-glass-designer)
Your own site
<a href="https://agentmods.dev/skills/xopoko/build-swift-apps/macos-liquid-glass-designer"><img src="https://agentmods.dev/badge/skills/xopoko/build-swift-apps/macos-liquid-glass-designer/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for macos-liquid-glass-designer

Your own site · 80×15
<a href="https://agentmods.dev/skills/xopoko/build-swift-apps/macos-liquid-glass-designer"><img src="https://agentmods.dev/badge/skills/xopoko/build-swift-apps/macos-liquid-glass-designer.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 42 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 641 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe. Third-party audits
  • NVIDIA SkillSpector pass 7 Sept 2026
How audits are shown
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00042 $0.00641
Opus 5 $0.00021 $0.00320
Sonnet 5 $0.00008 $0.00128
Haiku 4.5 $0.00004 $0.00064

Measured 12d ago against content hash 21d9938042d4, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-11, from the pricing page.

Security

Grade A, and why

macos-liquid-glass-designer scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 12d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/macos-liquid-glass-designer/SKILL.md · 48 lines

How it starts

The opening of the file, as written. The whole thing — 48 lines — stays where its author put it; the contents beside it link to each section on GitHub.

macOS Liquid Glass Designer

Modernize macOS SwiftUI UI by using standard app structure and system materials first; add custom glass only for app-specific surfaces.

Workflow

  1. Inspect the scene/root view and identify the pattern: split view, tab, sheet, toolbar, inspector, custom floating controls.
  2. Remove custom opaque backgrounds, scrims, and toolbar/sheet fills that fight system material unless intentionally required.
  3. Update standard SwiftUI structure and controls first.
  4. Add glassEffect only where standard controls do not cover the design.
  5. Validate grouping, transitions, icon treatment, pointer/keyboard usability, and foreground activation. Use macos-runtime-debugger for SwiftPM GUI apps.

Rules

  • Prefer NavigationSplitView; let sidebars use system Liquid Glass material.
  • Use backgroundExtensionEffect for hero/media that should extend beyond safe area near floating chrome.
  • Keep inspectors visually lighter than or equal to the content they inspect.
  • Keep TabView for persistent top-level sections; do not force iPhone tab/search patterns onto macOS.
  • Remove old presentationBackground imitation layers when the system sheet material is enough.
  • Put hierarchy-wide search on NavigationSplitView; use searchToolbarBehavior for compact secondary search.
  • Assume toolbar items live on floating glass; use ToolbarSpacer, sharedBackgroundVisibility, and badge instead of custom chrome.
  • Tint icons/glass only for semantic meaning.
  • Prefer standard controls and system glass/prominent button styles before custom translucent buttons.
  • Use controlSize, buttonBorderShape, slider step/ticks/neutralValue, and Label before custom controls.
  • Use concentric rectangle/container corner configuration for custom shapes that must align with sheet/card/window corners.

Custom Glass

  • glassEffect defaults to a capsule-like shape and vibrant text; pass an explicit shape when needed.
  • Use .interactive() for custom controls/containers with interactive elements.
  • Put nearby custom glass in one GlassEffectContainer; separate containers cannot sample each other correctly.
  • Use glassEffectID with a local @Namespace for collapsed/expanded morphing with stable identity.

Read the full file on GitHub · 48 lines

Files

What ships with it

1 file beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 12d ago First seen · 48 lines · 42 tokens per session scan A 21d9938042d4

Subscribe to this mod's changes

macos-liquid-glass-designer is a skill published in the GitHub repository Xopoko/build-swift-apps (45 stars, last pushed 15d ago), licensed MIT. It adds 42 tokens to every session and 641 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

frontend-ui-engineering

Builds production-quality, accessible, responsive user-facing UIs. Use when building or modifying interfaces and pages, creating components, implementing layouts, meeting WCAG accessibility requirements, managing state, or when the output needs to look and feel production-quality rather than AI-generated.

addyosmani/agent-skills · 58 tokens

brand-landingpage

Brand-first landing page designer — runs a brand-identity interview (colors, typography, shape language), then generates and iterates on a polished landing page via Stitch with deployment-ready HTML. Use when the user asks to create, design, or build a landing page, homepage, or marketing page and has no established…

wshobson/agents · 112 tokens

21st-ui

Find, install, and generate UI with 21st.dev. Use when the user asks for a UI component (pricing table, hero, navbar, dashboard, form, etc.), wants design inspiration, needs a brand logo as an SVG component, or wants to generate new UI from a prompt.

21st-dev/magic-mcp · 63 tokens

tailwind-design-system

Build scalable design systems with Tailwind CSS v4, design tokens, component libraries, and responsive patterns. Use when creating component libraries, implementing design systems, or standardizing UI patterns.

calesthio/OpenMontage · 42 tokens

interaction-skill

Layer A interaction-mechanics reference anchored to the beui.dev catalog. Stacks on any style skill whenever work adds or changes motion or interaction — micro-interactions, animated components, transitions, gestures, hover/press/state feedback, loading/success/error morphs, 'make it feel alive'. Mandates reading the…

code-yeongyu/oh-my-openagent · 104 tokens

layout-skill

Layer A layout-mechanics reference. Stacks on any style skill when the screen is an app shell, dashboard, settings, list-detail, mail/inbox, or any layout with fixed regions plus a scrolling body — or when a layout breaks under long, empty, or unbroken content. Owns spatial structure and scroll ownership; owns zero…

code-yeongyu/oh-my-openagent · 88 tokens