$npx skillfedfor your agent

Macos App Design

Master the fundamentals of building apps that feel native to macOS. This skill covers essential patterns—from menu bar organization and keyboard navigation to multi-window support and Liquid Glass styling—plus a checklist for becoming a true "good Mac citizen." Learn the archetype framework, command mapping, and common pitfalls to avoid.

macOS App Design teaches you how to build native-feeling apps that follow Mac conventions and integrate seamlessly with the platform.

AI-generated summary based on this skill's SKILL.md

5 2 unlicensed, metadata onlyupdated by petekp

Decision gist · record as of 2026-06-04

macOS App Design teaches you how to build native-feeling apps that follow Mac conventions and integrate seamlessly with the platform. Master the fundamentals of building apps that feel native to macOS. This skill covers essential patterns—from menu bar organization and keyboard navigation to multi-window support and Liquid Glass styling—plus a checklist for becoming a true "good Mac citizen." Learn the archetype framework, command mapping, and common pitfalls to avoid.

manual: git clone https://github.com/petekp/agent-skills → cp -r agent-skills ~/.claude/skills/macos-app-design

Use it when

  • Macos App Design covers the fundamentals of building interfaces that feel native to macOS.
  • Macos App Design introduces you to macOS design guidelines and standards that define how applications should behave and appear.
Same gist for agents: .md · .json

Install

petekp/agent-skills/macos-app-design · repository language: Python

generated, unverified - the skill's exact subdirectory could not be determined; check the repository on GitHub

Open directory. Skills are indexed for reading, not audited. Review a skill's body before installing it.

Frequently asked questions

AI-generated answers based on this skill's SKILL.md and metadata

What are the key macOS app design best practices?

Macos App Design teaches essential patterns for building native applications, including menu bar organization, keyboard navigation, multi-window support, and Liquid Glass styling. The skill emphasizes becoming a "good Mac citizen" by following macOS design principles, understanding the archetype framework, and learning proper command mapping. You'll discover common pitfalls to avoid and gain a checklist for ensuring your app feels truly native to the platform.

How do I create a user interface for a macOS application?

Macos App Design covers the fundamentals of building interfaces that feel native to macOS. The skill guides you through essential UI patterns, including proper menu bar organization, keyboard navigation conventions, and multi-window support. You'll learn the archetype framework that underpins macOS interface design, understand visual design standards like Liquid Glass styling, and gain practical insights into implementing interfaces that align with macOS design guidelines and user expectations.

What does the macOS HIG (Human Interface Guidelines) cover?

Macos App Design introduces you to macOS design guidelines and standards that define how applications should behave and appear. The skill covers the Human Interface Guidelines through practical patterns and principles, teaching you menu organization, keyboard shortcuts, multi-window workflows, and visual design elements. Understanding these guidelines helps you create applications that users recognize as native Mac apps, following established conventions for navigation, interaction, and visual presentation.

How to design macOS applications that feel native?

Macos App Design provides a comprehensive framework for designing native macOS desktop applications. The skill teaches you to master fundamental patterns—from menu bar organization and keyboard navigation to multi-window support and Liquid Glass styling. You'll learn the archetype framework that defines macOS app behavior, understand command mapping conventions, and gain access to a checklist for becoming a true "good Mac citizen." This ensures your application integrates seamlessly with the macOS ecosystem.

What are macOS design patterns and principles?

Macos App Design covers the core patterns and principles that define macOS application design. The skill teaches the archetype framework—the foundational structure that shapes how Mac apps behave—along with essential patterns like menu bar organization, keyboard navigation, and multi-window support. You'll understand visual design principles including Liquid Glass styling, learn proper command mapping, and discover the principles that make an app feel like a native macOS application rather than a port from another platform.

What should I avoid when designing for macOS?

Macos App Design identifies common pitfalls to help you avoid design mistakes when building macOS applications. The skill provides a checklist for becoming a "good Mac citizen," highlighting patterns and conventions you must follow to create native-feeling apps. By understanding these pitfalls alongside best practices, you'll learn what makes apps feel out of place on macOS—such as ignoring keyboard navigation conventions, improper menu organization, or failing to support multi-window workflows—and how to prevent these issues in your own designs.

Let your AI agent find skills like this

Example. Real query, live index.

You found this page by searching. An agent finds it by wishing: SkillFed indexes 56,283 agent skills by what they can do, searchable in plain language.

wish › “Learn macOS app design principles and best practices”

Give your agent the search over MCP, or paste the wish link into any chat. No install? Search from any chat →

Related skills

macos-design-guidelines
by ehmo · ehmo/platform-design-skills

This skill distills Apple's Human Interface Guidelines into actionable rules for macOS development. Learn how to implement standard menu structures, keyboard shortcuts, resizable windows, fullscreen support, and toolbars that power users expect. Includes SwiftUI and AppKit code examples for every pattern.

MITupdated Mar 2026
★ 471repo stars
Macos Design
by dirnbauer · dirnbauer/webconsulting-skills

This skill covers Apple's Human Interface Guidelines tailored for macOS development. Learn to implement critical Mac UI patterns including menu bar structure, window management, resizable layouts, and keyboard shortcuts using SwiftUI and AppKit. Get actionable rules and code examples for building apps that respect Mac power users' expectations around deep keyboard control, persistent menus, and system integration.

no license declared → metadata onlyupdated Jul 2026
★ 33repo stars
Swiftui Patterns
by duyet · duyet/codex-claude-plugins

SwiftUI Patterns teaches you how to structure macOS applications using SwiftUI's native scene and view system. Learn when to use WindowGroup, Settings, MenuBarExtra, and other scene models; how to organize files and state ownership; and which system affordances—commands, toolbars, sidebars, inspectors—work best for desktop interactions. The skill covers everything from new app scaffolding to refactoring existing projects with proper file structure and adaptive design.

no license declared → metadata onlyupdated Jul 2026
★ 8repo stars
Macos App Best Practices
by duyet · duyet/codex-claude-plugins

This skill covers the core patterns for building macOS applications, from choosing the right scene types (WindowGroup, DocumentGroup, Settings, MenuBarExtra) to managing multiple windows and menu bar integration. It explains when to use SwiftUI versus AppKit, how to gate platform-specific code, and provides practical guidance on Mac Catalyst for bringing iPad apps to macOS.

no license declared → metadata onlyupdated Jul 2026
★ 8repo stars
Macos Patterns
by fayazara · fayazara/macos-app-skills

This skill guides developers through macOS-specific design patterns that differ fundamentally from web development. It covers menu bar apps using MenuBarExtra and NSStatusItem, window management with NSPanel versus NSWindow, activation policies for Dock visibility, screen geometry with macOS's bottom-left coordinate system, and collection behaviors for multi-space and fullscreen interactions. Essential for anyone building native macOS applications who needs to avoid applying web paradigms to platform-specific APIs.

no license declared → metadata onlyupdated May 2026
★ 631repo stars
swift-expert
by Jeffallan · Jeffallan/claude-skills

swift-expert equips you with expert-level guidance for crafting robust iOS and macOS applications using Swift 5.9 and beyond. Leverage modern concurrency features and type-safety principles to accelerate your full-stack development workflow. This skill bridges the gap between foundational Swift knowledge and production-ready app architecture.

MITupdated May 2026
★ 10,759repo stars
Tags
ui-designdesktop-applicationsinterface-guidelinesmacos-developmentdesign-patternsnative-appsvisual-standardsuser-experience