macos-design-guidelines

Review macOS app UI elements against Apple Human Interface Guidelines.

8|2|Updated Dec 29, 2025
One-click install
npx skills add https://github.com/hack-dance/hack --skill macos-design-guidelines-hack-dance
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: macos-design-guidelines
Source: https://github.com/hack-dance/hack/tree/main/.agents/skills/macos-design-guidelines
Command: npx skills add https://github.com/hack-dance/hack --skill macos-design-guidelines-hack-dance

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill ensures your macOS applications adhere to Apple's Human Interface Guidelines, creating a native, intuitive, and polished user experience.

Core Features & Use Cases

  • UI Consistency: Enforces standard macOS UI patterns for menus, windows, toolbars, and sidebars.
  • Keyboard & Pointer Interaction: Guides implementation of robust keyboard shortcuts and pointer-based interactions.
  • System Integration: Promotes seamless integration with macOS features like Spotlight, Share extensions, and Shortcuts.
  • Visual Design: Ensures adherence to system fonts, colors, and materials for a native look and feel.
  • Use Case: When developing a new macOS application, use this Skill to review your UI elements, keyboard shortcuts, and overall design to ensure it feels like a true Mac app, not an iOS port.

Quick Start

Review the provided macOS design guidelines to ensure the application adheres to Apple's Human Interface Guidelines.

Frequently Asked Questions about macos-design-guidelines

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

FAQPage Schema
How do I design a native macOS app that follows Apple Human Interface Guidelines?

To design a native macOS app following Apple Human Interface Guidelines, implement standard UI patterns for menus, windows, toolbars, and sidebars while ensuring proper keyboard and pointer interactions for a polished user experience.

What macOS UI components are required for proper system integration?

Proper macOS system integration requires implementing standard menu bar designs, window management, toolbar customization, and seamless connections to system features like Spotlight, Share extensions, and Shortcuts.

Can I use these macOS design guidelines with both SwiftUI and AppKit?

Yes, you can apply these macOS design guidelines with both SwiftUI and AppKit to ensure your application adheres to visual design principles, system fonts, and materials for a native look and feel.

What's the best way to implement keyboard shortcuts and pointer interactions in a Mac app?

The best way to implement keyboard shortcuts and pointer interactions in a Mac app is to follow established macOS Human Interface Guidelines for robust, intuitive, and standard user input behaviors.

Why does my macOS application feel like an iOS port instead of a native Mac app?

Your macOS application feels like an iOS port if it lacks native UI consistency, standard menu bar designs, window management, and robust keyboard interactions outlined in the macOS Human Interface Guidelines.