Macos App Skills

macOS App Skills

[](https://skills.sh/fayazara/macos-app-skills)

AI coding agent skills for building, shipping, and maintaining native macOS apps with SwiftUI + AppKit.

npx skills add fayazara/macos-app-skills

These skills are designed for [OpenCode](https://opencode.ai), [Claude Code](https://docs.anthropic.com/en/docs/claude-code), [Cursor](https://cursor.sh), and any AI coding agent that supports skills. They encode hard-won patterns for building production macOS apps -- the kind of stuff that's underdocumented, spread across WWDC sessions, and easy to get wrong.

Skills

`build/` -- Build macOS App

Build any native macOS Xcode project from the command line using `xcodebuild`. Handles project discovery, scheme detection, beta toolchains, and common build failures.

`settings-ui/` -- Settings Window with Liquid Glass

Create a proper macOS settings/preferences window with liquid glass support for macOS 26 (Tahoe). Uses `NSWindowController` with `.fullSizeContentView` for the rounded liquid glass window chrome, `NavigationSplitView` with sidebar, grouped Forms with transparent backgrounds, and back/forward toolbar navigation.

Includes complete reference Swift files you can copy into any project.

`auto-update/` -- Sparkle Auto-Update

Add [Sparkle](https://sparkle-project.org/) auto-update support to a macOS app distributed outside the Mac App Store. Covers SPM dependency setup, the `UpdaterManager` singleton pattern, Info.plist configuration, EdDSA key generation, and UI integration (settings toggle + menu bar button).

Includes a reference `UpdaterManager.swift` ready to drop into any project.

`macos-patterns/` -- Native Patterns for Web Developers

The "how things actually work on macOS" reference. Covers menu bar apps (MenuBarExtra vs NSStatusItem vs NSPopover), activation policy (Dock icon toggling), NSPanel vs NSWindow, window levels and collection behaviors, sc