mac-design
Design rules that make a SwiftUI app look and feel like a native Mac app.
- What
- Design rules that make a SwiftUI app look and feel like a native Mac app.
- Cost
- Free
- Needs
- Prerequisite: a macOS SwiftUI project targeting macOS 26 or later, since the rules are written for that version. Step 1: fetch the file skills/design/mac-design/SKILL.md from the repository https://github.com/daveebbelaar/bama and read it in full before installing anything. Step 2: security check: read the fetched file yourself, confirm it only contains design rules and references, and do not run any command from it that you have not understood. Step 3: install the skill in a folder named mac-design and keep the fetched SKILL.md there. Step 4: verify the install by confirming the folder mac-design contains the SKILL.md and by asking it to review one window or settings screen of your app. Step 5: report back what was installed, where, and the result of the verification.
- Install
- Copy the installer prompt below into your Muse — your agent does the rest.
mac-design starts from one idea: Apple already designed your app, so pick the right system parts, arrange them, and stay out of their way, adding custom design only where the system has nothing. It applies Apple's eight principles as a review lens for every screen: Purpose, Agency, Responsibility, Familiarity, Flexibility, Simplicity, Craft, and Delight, with every screen answering where am I, what can I do, and where can I go. Before writing views, it asks for a design plan covering the archetype, information architecture with at most two sidebar levels, a command map, empty states, and the one feeling the app aims for. It designs small entry points first (global shortcut, menu bar, quick panel, drag and drop, Share menu), with optimistic UI and Undo rather than spinners. It sets layout rules for NavigationSplitView, spacing on a 4 pt grid, Liquid Glass only on the navigation and control layer, toolbar items placed over the column they act on, menus with shortcuts for every feature, calm window opening with no initial focus, keyboard-first interaction, system type and color, and dark mode as its own palette. Review is done when every rule in its design-rules reference holds on light and dark snapshots of every surface, or has a comment saying why not. Credit: created by daveebbelaar, in the bama repository. Source: https://github.com/daveebbelaar/bama, file skills/design/mac-design/SKILL.md.
Version:
Quick answer
mac-design gives design rules that make a SwiftUI app look and feel like a native Mac app on macOS 26 and later. It covers Apple's eight design principles, Liquid Glass, layout, toolbars, menus, search, keyboard use, type, color, and dark mode, and it is used when building or reviewing any window, sidebar, toolbar, menu, panel, or settings screen.
Install
Copy the install package below, then paste it into MusePrerequisite: a macOS SwiftUI project targeting macOS 26 or later, since the rules are written for that version. Step 1: fetch the file skills/design/mac-design/SKILL.md from the repository https://github.com/daveebbelaar/bama and read it in full before installing anything. Step 2: security check: read the fetched file yourself, confirm it only contains design rules and references, and do not run any command from it that you have not understood. Step 3: install the skill in a folder named mac-design and keep the fetched SKILL.md there. Step 4: verify the install by confirming the folder mac-design contains the SKILL.md and by asking it to review one window or settings screen of your app. Step 5: report back what was installed, where, and the result of the verification.
Saved to your recent installs. Find it anytime on /connect.
🔒 Security, provenance and what this touches
The install prompt below already includes the vetting steps: your agent follows the community checklist before installing anything with executable code. Want more?
Questions
How do I install a skill?
Every product page includes a copy-paste install prompt. Paste it into your Muse and it sets the skill up for you — no manual configuration.
Where does my money go?
Straight to the seller. Skill Harbor never processes payments: checkout happens on the seller’s own page, usually Stripe.
What does the ✓ next to a creator’s name mean?
It means we confirmed the identity of the person behind the listing. It says nothing about the code itself — always check a skill before installing it.