Liquid Glass
robinebers/openusage
Implement, refactor, or review modern macOS SwiftUI UI for the new design system and Liquid Glass.
A skill your agent uses when designing or building native macOS applications with SwiftUI or AppKit.
Install macOS App Design
$ npx skills add vaayne/mori --skill macos-app-design -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install vaayne/mori macos-app-design --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/vaayne/mori.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/macos-app-design .claude/skills/macos-app-design && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "macos-app-design" agent skill from https://github.com/vaayne/mori/tree/main/.agents/skills/macos-app-design into .claude/skills/macos-app-design/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "macos-app-design", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/vaayne/mori/tree/main/.agents/skills/macos-app-designType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add vaayne/mori --skill macos-app-design -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install vaayne/mori macos-app-design --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/vaayne/mori.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.agents/skills/macos-app-design .agents/skills/macos-app-design && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "macos-app-design" agent skill from https://github.com/vaayne/mori/tree/main/.agents/skills/macos-app-design into .agents/skills/macos-app-design/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "macos-app-design", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add vaayne/mori --skill macos-app-design -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install vaayne/mori macos-app-design --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/vaayne/mori.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.agents/skills/macos-app-design .cursor/skills/macos-app-design && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "macos-app-design" agent skill from https://github.com/vaayne/mori/tree/main/.agents/skills/macos-app-design into .cursor/skills/macos-app-design/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "macos-app-design", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/vaayne/mori.git --path .agents/skills/macos-app-design--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add vaayne/mori --skill macos-app-design -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install vaayne/mori macos-app-design --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/vaayne/mori.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.agents/skills/macos-app-design .gemini/skills/macos-app-design && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "macos-app-design" agent skill from https://github.com/vaayne/mori/tree/main/.agents/skills/macos-app-design into .gemini/skills/macos-app-design/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "macos-app-design", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install vaayne/mori macos-app-designInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add vaayne/mori --skill macos-app-design -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/vaayne/mori.git skills-src && mkdir -p .github/skills && cp -r skills-src/.agents/skills/macos-app-design .github/skills/macos-app-design && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "macos-app-design" agent skill from https://github.com/vaayne/mori/tree/main/.agents/skills/macos-app-design into .github/skills/macos-app-design/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "macos-app-design", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add vaayne/mori --skill macos-app-design -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install vaayne/mori macos-app-design --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/vaayne/mori.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.agents/skills/macos-app-design .opencode/skills/macos-app-design && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "macos-app-design" agent skill from https://github.com/vaayne/mori/tree/main/.agents/skills/macos-app-design into .opencode/skills/macos-app-design/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "macos-app-design", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
macos-app-design- GitHub stars
- 303
- Token cost
- ~789 tokens
- SKILL.md length
- 328 words
- Files
- 2 (incl. references)
- Skills in repo
- 3
- Repo updated
- First seen
- Licence
- MIT
At a glance
A skill your agent uses when designing or building native macOS applications with SwiftUI or AppKit.
- Works in 2 steps: Prefer system components and conventions… → If you customize bars, backgrounds,…
- Building native macOS applications with SwiftUI
- SKILL.md covers Two Rules That Beat Everything…, Quick Reference: Mac Citizen…, Liquid Glass Quick Rules and App Archetypes, plus 3 more sections
- Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
What it does
macOS App Design is an agent skill from vaayne/mori. Use when designing or building native macOS applications with SwiftUI or AppKit. Triggers on menu bar structure, keyboard shortcuts, multi-window behavior, Liquid Glass design system, macOS Tahoe/Sequoia, sidebar navigation, toolbar design, app icons, SF Symbols, or making an app feel like a "good Mac citizen."
Its SKILL.md is about 790 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including reference files (for example `references/macos-design-guide.md`).
It sits in Mobile, covering iOS development and Design systems. It works with macOS, SwiftUI, Git and tmux. The repository describes itself as: A native macOS workspace terminal organized around Projects and Worktrees, powered by tmux and libghostty. The licence is MIT.
When your agent uses it
- Building native macOS applications with SwiftUI
- Menu bar structure
- Keyboard shortcuts
- Multi-window behavior
Example prompts
- “good Mac citizen.”
- “/macos-app-design”
Workflow steps
2 steps, taken from the first numbered list in SKILL.md.
- Prefer system components and conventions over bespoke UI—fastest path to "feels right on Mac"
- If you customize bars, backgrounds, borders, or control chrome: stop and justify it
What it can do on your machine
Read from SKILL.md and the folder at commit ff206ee. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
No scripts in the folder and no shell commands in SKILL.md.
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
macOS App Design loads about 789 tokens when it runs, and up to ~3.7k if it reads all its reference files. Until then it costs about 82 tokens; SKILL.md has 328 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
The full file from vaayne/mori at commit ff206ee, republished under its MIT licence (© vaayne). 328 words, ~789 tokens.
Download SKILL.mdSave it as
.claude/skills/macos-app-design/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.- name
- macos-app-design
- description
- Use when designing or building native macOS applications with SwiftUI or AppKit. Triggers on menu bar structure, keyboard shortcuts, multi-window behavior, Liquid Glass design system, macOS Tahoe/Sequoia, sidebar navigation, toolbar design, app icons, SF Symbols, or making an app feel like a "good Mac citizen."
macOS App Design & Development
Guide for designing and implementing native-feeling, "good Mac citizen" apps: fast, elegant, accessible, and deeply integrated with macOS workflows.
Two Rules That Beat Everything Else
- Prefer system components and conventions over bespoke UI—fastest path to "feels right on Mac"
- If you customize bars, backgrounds, borders, or control chrome: stop and justify it
Quick Reference: Mac Citizen Checklist
| Area | Requirement |
|---|---|
| Menu Bar | Standard layout (App/File/Edit/View/Window/Help), ⌘, for Settings |
| Keyboard | Every primary command reachable via keyboard, standard shortcuts work |
| Windows | Resize fluidly, support multiple windows, respect fullscreen/minimize |
| Sidebars | Top-level navigation, scannable items, content extends behind |
| Toolbars | Group by function/frequency, demote secondary to "more" menu |
| Text | Use system text components, standard editing behaviors |
| Accessibility | VoiceOver labels, full keyboard navigation, Reduced Motion support |
Liquid Glass Quick Rules
Do:
- Use for navigation/controls layer (toolbars, sidebars, bars)
- Let system components provide built-in behaviors
Don't:
- Apply to content layer (tables, lists, document content)
- Stack "glass on glass"
App Archetypes
Identify your app type first:
- Document-based: Files as primary units (open/save/duplicate)
- Library + editor: Sidebar lists items, detail in main area
- Utility: Single window, optional menu bar
- Menu-bar app: Lives in menu bar, minimal UI
- Pro tool: Dense, power-user workflows
Deliverables Before Building
- App archetype identified
- Information architecture (sidebar structure, navigation, window model)
- Command map (menus + keyboard shortcuts for every major feature)
- State + data model (persistence, undo/redo, concurrency)
- Accessibility plan (VoiceOver, keyboard, contrast, reduce motion)
Full Reference
For complete design system details, Icon Composer workflow, SF Symbols guidance, evaluation rubrics, and Definition of Done checklist:
See: references/macos-design-guide.md
Common Mistakes
| Mistake | Fix |
|---|---|
| Missing menu bar commands | Every feature in menus with keyboard shortcuts |
| Settings outside App menu | Always ⌘, opening from App menu |
| Custom text components | Use system text for Mac editing ecosystem |
| Toolbar overload | Demote secondary actions, group by function |
| Glass on content | Reserve Liquid Glass for navigation layer only |
| Breaking standard shortcuts | Never override ⌘C, ⌘V, ⌘Z, etc. |
| Single-window only | Support multiple windows when it benefits workflows |
© vaayne, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
SKILL.md and 1 other file (references) in .agents/skills/macos-app-design of vaayne/mori.
- SKILL.md
- references/macos-design-guide.md
Open the folder on GitHubat commit ff206ee
Compare with similar skills
macOS App Design next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| macOS App Design this skillvaayne/mori | 303 | — | ~789 | Automated safety check: Pass | MIT | |
| Liquid Glassrobinebers/openusage | 4.3k | — | ~2.2k | Automated safety check: Pass | MIT | |
| Native App Designercuriositech/some_claude_skills | 243 | — | ~1.9k | Automated safety check: Notes | MIT | |
| macOS Hig DesignerLeoYeAI/openclaw-master-skills | 2.2k | — | ~5.6k | Automated safety check: Pass | MIT | |
| Swiftui Patternsrobinebers/openusage | 4.3k | — | ~3.4k | Automated safety check: Pass | MIT | |
| macOS Swiftui Patternsrobinebers/openusage | 4.3k | — | ~2.9k | Automated safety check: Pass | MIT |
Similar skills
Native App Designer
curiositech/some_claude_skills
Creates breathtaking iOS/Mac and web apps with organic, non-AI aesthetic.
macOS Hig Designer
LeoYeAI/openclaw-master-skills
Design native macOS apps following Apple's Human Interface Guidelines and Liquid Glass design system.
Swiftui Patterns
robinebers/openusage
Best practices and example-driven guidance for building native macOS SwiftUI scenes and components, including windows, commands, toolbars, settings, split views, inspectors, menu bar extras, and…
macOS Swiftui Patterns
robinebers/openusage
Build macOS SwiftUI scenes and components with desktop patterns.
- Official
macOS Golden Gate Design
github/awesome-copilot
Design, implement, review, or refactor native macOS 27 Golden Gate interfaces in SwiftUI or AppKit.
More from vaayne/mori
Mori Agent Bridge
vaayne/mori
Use Mori CLI to enable agent-to-agent communication and coordination across Mori-managed panes.
Release
vaayne/mori
Release workflow for Mori macOS workspace terminal and MoriRemote iOS app.
Related
Categories
Questions about macOS App Design
What does macOS App Design do?
A skill your agent uses when designing or building native macOS applications with SwiftUI or AppKit. macOS App Design is an agent skill from vaayne/mori. Use when designing or building native macOS applications with SwiftUI or AppKit.
When should I use macOS App Design?
macOS App Design fits situations like: building native macOS applications with SwiftUI; menu bar structure; keyboard shortcuts; multi-window behavior.
How do I install macOS App Design in Claude Code?
Run `npx skills add vaayne/mori --skill macos-app-design -a claude-code`. Or copy the skill folder (.agents/skills/macos-app-design in vaayne/mori) into .claude/skills/macos-app-design in your project. Claude Code loads it when a task matches its description.
How do I install macOS App Design in Codex?
Run `npx skills add vaayne/mori --skill macos-app-design -a codex`. Or copy the skill folder (.agents/skills/macos-app-design in vaayne/mori) into .agents/skills/macos-app-design in your project. Codex loads it when a task matches its description.
Can I use macOS App Design in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add vaayne/mori --skill macos-app-design -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/macos-app-design, .gemini/skills/macos-app-design, .github/skills/macos-app-design and .opencode/skills/macos-app-design in your project.
What does macOS App Design need to run?
SKILL.md names no scripts, command-line tools or credentials: macOS App Design is instructions for the agent only.
Does macOS App Design access the network?
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Is macOS App Design safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does macOS App Design use?
macOS App Design is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does macOS App Design use?
About 789 tokens (SKILL.md is roughly 3.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 2.9k tokens, read only when the agent opens those files.
What are the alternatives to macOS App Design?
Skills that share tags, products or a category with macOS App Design: Liquid Glass (robinebers/openusage, 4.3k stars), Native App Designer (curiositech/some_claude_skills, 243 stars), macOS Hig Designer (LeoYeAI/openclaw-master-skills, 2.2k stars) and Swiftui Patterns (robinebers/openusage, 4.3k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains macOS App Design?
vaayne (a GitHub user) maintains it in vaayne/mori, which has 303 GitHub stars. The repository holds 3 skills in this directory. The repository was last updated on August 5, 2026.
Source: vaayne/mori on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.