Skills

Mac Design

Design rules that make a SwiftUI app look and feel like a native Mac app on macOS 26...

Install

npx skills add daveebbelaar/bama --skill mac-design -g -a claude-code -y
Repository
daveebbelaar/bama1.3k
Category
Design
Updated
3d ago
License
MIT
Context cost
Mediumabout 2,373 tokens
Runs scripts
Yes, review before use

What it does

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.

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. Use it for reviews.
  • Copyable SwiftUI code: patterns.md.
  • The Settings window: settings.md.
  • Toolbars: which item goes where, per column: toolbars.md.
  • The menu bar, context menus, and the Dock menu: 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, sheets). It prints the HIG page as plain text.
  • App-wide tokens (colors, radii, motion): call the Skill tool with design-system.
  • How a feature works and what it says (names, flow, modals, errors, accessibility): call the Skill tool with ux-design.
  • Spacing, alignment, and the checks that catch misalignment: call the Skill tool with layout-grid.
  • Parts of your own instead of Apple's: call the Skill tool with design-kit, or design-from-app to match an app the user names.

Apple's eight principles

Use them as the review lens for every screen (HIG Design principles, 2026):

Read the whole SKILL.md on GitHub

More in Design