macos-design-guidelines

Deliver Apple Human Interface Guidelines for macOS apps with SwiftUI or AppKit.

Updated Feb 2, 2026

Search Tags:#accessibility #usability #macOS #SwiftUI #AppKit #design-guidelines #HIG

Ready to run

npx skills add https://github.com/brunoamaral/playlister --skill macos-design-guidelines

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: macos-design-guidelines
Source: https://github.com/brunoamaral/playlister/tree/main/.copilot/skills/macos
Command: npx skills add https://github.com/brunoamaral/playlister --skill macos-design-guidelines

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Apple Human Interface Guidelines provide a complete framework to design macOS apps that feel native, accessible, and consistent with system conventions.

Core Features & Use Cases

Comprehensive rules for Menu Bar, Windows, Toolbars, Sidebars, Keyboard, Pointer, Notifications, System Integration, and Visual Design, all aligned with SwiftUI and AppKit.
Practical examples, rationale, and best practices to review and implement in your macOS projects.
Use Case: A design team audits a new macOS app to ensure it follows macOS conventions before code is written.

Quick Start

Review SKILL.md to access the full guidelines and code examples, then apply the rules to your Mac app design.

Frequently Asked Questions about macos-design-guidelines

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I apply Apple Human Interface Guidelines to a SwiftUI app?▼

Apply Apple Human Interface Guidelines to SwiftUI apps by following rules for menus, windows, toolbars, and sidebars. This provides section-by-section guidance, rationale, and checklists to ensure your interface feels native.

What are the macOS design requirements for app accessibility and keyboard shortcuts?▼

macOS design requirements for accessibility and keyboard shortcuts involve adhering to specific Human Interface Guidelines. This covers pointer interactions, system integrations, and visual design to guarantee an accessible user experience.

Can I use these macOS design guidelines for AppKit interfaces?▼

Yes, you can use these macOS design guidelines for AppKit interfaces. The guidelines are explicitly designed for evaluating and designing Mac apps using either SwiftUI or AppKit frameworks.

What is the best way to audit a Mac app for native UX conventions?▼

The best way to audit a Mac app for native UX conventions is checking it against the Apple Human Interface Guidelines. This provides practical examples and checklists for menus, windows, and system integration before code is written.

Why does my Mac app design feel inconsistent with system conventions?▼

Your Mac app design feels inconsistent with system conventions because it likely violates Apple Human Interface Guidelines. Reviewing rules for toolbars, sidebars, and notifications ensures your app aligns with native macOS expectations.