macos-app-skills - GitLite

KO | EN

gitlite — search

#agents #pytorch #swift #ios #graphql #awesome-list #animation #data-science #generative-ai #css

macos-app-skills

(★ 652)

AI coding agent skills for building, shipping, and maintaining native macOS apps

파일 탐색기

ZIP 다운로드

- - UpdaterManager.swift
- SKILL.md
- SKILL.md
- SKILL.md
- - NotchShape.swift
  - NotchWindow.swift
- SKILL.md
- - main.go
  - main_test.go
  - release.example.json
- SKILL.md
- - ExampleDetailPane.swift
  - SettingsView.swift
  - SettingsWindowController.swift
- SKILL.md
go.mod
README.md
skills.sh.json

# CDN으로 사용하기

jsDelivr

jsDelivr는 공개 GitHub 리포지토리를 별도 설정 없이 CDN으로 즉시 서빙합니다. 버전과 파일을 고르면 웹페이지에 바로 붙일 수 있는 링크와 예시 코드가 만들어집니다.

버전

파일

링크

예시

명령어 용어집

이 문서에서 사용된 명령어를 모아봤습니다. 낯선 명령어가 있다면 펼쳐서 확인해보세요.

🔍

`go run`

설명 보기 ▼

Compile and run Go code without saving a binary.

go run {{path/to/file.go}}

Run a Go file:

go run {{path/to/package}}

Run a main Go package:

🔍

`npx`

설명 보기 ▼

이 명령은 `npm exec`의 별칭입니다.

tldr npm exec

자세한 내용은 원본 명령을 참고하세요:

🔍

`xcodebuild`

설명 보기 ▼

Xcode 프로젝트 빌드.
더 많은 정보: <https://developer.apple.com/library/archive/technotes/tn2339/_index.html>.

xcodebuild -workspace {{workspace_name.workspace}} -scheme {{scheme_name}} -configuration {{configuration_name}} clean build SYMROOT={{SYMROOT_path}}

워크스페이스 빌드:

xcodebuild -target {{target_name}} -configuration {{configuration_name}} clean build SYMROOT={{SYMROOT_path}}

프로젝트 빌드:

xcodebuild -showsdks

SDK 표시:

# 프로젝트 배지

skills.sh 바로가기

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

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