Individual skill
mac-design
Design rules that make a SwiftUI app look and feel like a native Mac app on macOS 26 and later, from Apple's eight design principles to Liquid Glass, layout, toolbars, menus, search, keyboard, type, color, and dark mode. Use when building or reviewing any window, sidebar, toolbar, menu, panel, or settings screen, or when the user asks for a more native, Apple-like, or better designed app.
skills/design/mac-design/SKILL.md
Source commit 639893c397278256f1ae204dd8f837eb82bd6527
What was checked
- Matches the observed repository HEAD
- Yes
- Scanner rules are current
- Yes
- Repository scan complete
- No
- Skill scan complete
- Yes
- Observed behavior
- Network or broad shell
- Last checked
- Nov 9, 2026
These are observations at the recorded commit, not a guarantee of safety. Review the source before running it.
Install this skill
Choose an agent in your Stack or copy a command below. Commands fetch the pinned commit and copy only this skill directory. Existing destinations are refused. Copying a command does not install anything.
An install command is unavailable: current rules, complete repository and skill scans, an eligible behavior level and a permitted license are required.
Repository context
- Repository stars (not skill ratings)
- 1,705
- Repository last updated
- Nov 5, 2026
- License
- MIT
Observed agent integration: No specific integration evidence. Standard SKILL.md installation does not imply verified compatibility.
- agent-skills Repository topic
- ai-agents Repository topic
- app-clone Repository topic
- claude-code Repository topic
- claude-code-plugin Repository topic
- codex Repository topic
- computer-use Repository topic
- liquid-glass Repository topic
- macos Repository topic
- macos-app Repository topic
- design Derived category
Files and excerpt
File metadata and permitted, redacted excerpts come from the recorded scan. Source links are pinned to that commit.
Browse files
SKILL.mdcore · 9,922 bytesagents/openai.yamlasset · 89 bytesdesign-rules.mddoc · 17,585 bytesmenus.mddoc · 4,952 bytespatterns.mddoc · 21,291 bytesscripts/hig.shruns · 4,979 bytessettings.mddoc · 4,268 bytestoolbars.mddoc · 10,652 bytes
Read excerpt
# Mac design
Apple already designed your app. Pick the right system parts, arrange them,
and stay out of their way. Use the system first. Add custom design only
where the system has nothing.
- The full checklist with sources: [design-rules.md](design-rules.md).
Use it for reviews.
- Copyable SwiftUI code: [patterns.md](patterns.md).
- The Settings window: [settings.md](settings.md).
- Toolbars: which item goes where, per column: [toolbars.md](toolbars.md).
- The menu bar, context menus, and the Dock menu: [menus.md](menus.md).
- Apple's current text on one topic, when a rule here is not enough:
`"${CLAUDE_SKILL_DIR}/scripts/hig.sh" <topic>` (for example `toolbars`,