macos-app-skills
AI coding agent skills for building, shipping, and maintaining native macOS apps
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/fayazara--macos-app-skills)HTML
<a href="/listings/fayazara--macos-app-skills"><img src="/api/listings/fayazara--macos-app-skills/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
OpenCode (per-project)
Copy the skills you need into your project's `.agents/skills/` directory:
# Copy all skills cp -r build settings-ui auto-update release notch-ui /path/to/your/project/.agents/skills/ # Or just the ones you need cp -r settings-ui /path/to/your/project/.agents/skills/
OpenCode (global)
Copy into your global skills directory:
cp -r build settings-ui auto-update release notch-ui ~/.config/opencode/skills/
Other AI agents
Each skill is a self-contained directory with a `SKILL.md` file and optional `references/` folder. The `SKILL.md` is a markdown file with YAML frontmatter -- adapt to your agent's skill format.
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 100 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- # 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.
- ```bash
- 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, screen geometry (frame vs visibleFrame, Y-axis flip, multi-monitor), keyboard shortcuts (3 tiers: SwiftUI, NSEvent monitors, Carbon hotkeys), file pickers, clipboard/pasteboard, drag and drop, NavigationSplitView + inspector layout, launch at login, Quick Look, NSWorkspace, ScreenCaptureKit, and UserDefaults/@AppStorage.
- This is the skill to load proactively on any macOS project to prevent the AI from applying web patterns that don't work.
- ### `notch-ui/` -- Dynamic Island / Notch Extender
- Create a Dynamic Island-style overlay that extends from the MacBook's hardware notch. Uses a borderless NSPanel at `CGShieldingWindowLevel` positioned flush against the top of the screen, with a custom `NotchShape` that has concave Bezier "ear" curves matching the hardware notch. Includes spring animations for the expand/collapse effect and a fallback pill mode for non-notch Macs.
- Includes reference `NotchWindow.swift` (the panel) and `NotchShape.swift` (the shape).
- ### `release/` -- Release Pipeline + CLI Tool
- Release a macOS app to GitHub with DMG packaging and Sparkle appcast updates. Covers the full pipeline: version bump, archive, notarize, export, DMG creation via `create-dmg`, EdDSA signing via Sparkle's `sign_update`, appcast.xml updates, and GitHub release creation via `gh`.
- Includes a **Go CLI tool** (`release/cli/`) that automates the entire pipeline in a single command. Just add a `release.json` to your project root and run:
- ```bash
- go run github.com/fayazara/macos-app-skills/release/cli@latest
- ```
- ## Installation
- ### OpenCode (per-project)
- Copy the skills you need into your project's `.agents/skills/` directory:
- ```bash
- # Copy all skills
- cp -r build settings-ui auto-update release notch-ui /path/to/your/project/.agents/skills/
- # Or just the ones you need
- cp -r settings-ui /path/to/your/project/.agents/skills/
- ```
- ### OpenCode (global)
- Copy into your global skills directory:
- ```bash
- cp -r build settings-ui auto-update release notch-ui ~/.config/opencode/skills/
- ```
- ### Other AI agents
- Each skill is a self-contained directory with a `SKILL.md` file and optional `references/` folder. The `SKILL.md` is a markdown file with YAML frontmatter -- adapt to your agent's skill format.
- ## What These Skills Solve
- Building native macOS apps with AI coding agents is great until you hit the parts where the AI confidently generates code that doesn't work:
- - **Settings windows** look wrong because SwiftUI's `Window` scene doesn't support `.fullSizeContentView`, which is required for liquid glass on macOS 26
- - **Sparkle integration** has subtle timing requirements (`SPUStandardUpdaterController` must be created before `applicationDidFinishLaunching` returns) that are easy to miss
- - **Release pipelines** involve 8+ manual steps that are error-prone and tedious to explain every time
- - **`xcodebuild`** invocations have enough flags and edge cases that the AI frequently gets them wrong
- - **Notch overlays** require specific NSPanel configuration, screen geometry math, and a custom shape with concave Bezier curves that no AI gets right from scratch
- - **Native patterns** like NSPanel vs NSWindow, activation policy toggling, window levels, Carbon hotkeys, pasteboard clearing, and screen geometry have no web equivalents and the AI defaults to web-like approaches that don't work
- These skills encode the correct patterns so the AI gets it right the first time.
- ## Requirements
- - macOS 14+ (macOS 26+ for liquid glass features, with graceful fallbacks)
- - Xcode 15+ (Xcode 26 beta for Tahoe SDK features)
- - Swift 5.9+
- ## License
- MIT
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.