Summary

This repository provides AI coding agent "skills" for building, shipping, and maintaining native macOS apps with SwiftUI/AppKit. It addresses complex, underdocumented patterns, enabling AI agents to generate production-ready code and prevent costly errors for developers.

How It Works

The project offers modular, self-contained skills—directories with SKILL.md and reference code—integrating into AI agents like OpenCode, Claude Code, and Cursor. These skills encapsulate hard-won patterns for intricate macOS development challenges (UI, builds, releases). By encoding best practices, they guide AI agents to produce correct implementations, bypassing common AI-generated code pitfalls for platform-specific features.

Quick Start & Requirements

• Installation: Copy desired skill directories (e.g., build/, settings-ui/) into your project's .agents/skills/ or a global skills directory (e.g., ~/.config/opencode/skills/). Adapt SKILL.md for other agents.
• Prerequisites: macOS 14+ (macOS 26+ for Liquid Glass), Xcode 15+ (Xcode 26 beta for Tahoe SDK), Swift 5.9+.
• Links: OpenCode, Sparkle, create-dmg, gh

Highlighted Details

• build/: Automates xcodebuild for macOS projects, handling discovery and failures.
• settings-ui/: Implements macOS settings windows with Liquid Glass (macOS 26+).
• auto-update/: Integrates Sparkle auto-update.
• macos-patterns/: Reference for native macOS behaviors (menu bar, activation, windows, shortcuts), preventing web-pattern misapplications.
• notch-ui/: Creates Dynamic Island-style overlays.
• release/: Full release pipeline skill and Go CLI tool for automating archiving, notarization, DMG creation, appcast updates, and GitHub releases.

Maintenance & Community

No specific details regarding maintainers, community channels (e.g., Discord/Slack), or roadmap were found in the provided README.

Licensing & Compatibility

• License: MIT License.
• Compatibility: Permissive MIT license generally allows for commercial use and integration into closed-source projects without copyleft obligations.

Limitations & Caveats

Certain advanced features, such as Liquid Glass UI effects, require specific, newer versions of macOS (26+) and Xcode (26 beta). The primary utility is contingent on the user employing an AI coding agent that supports the "skills" integration format.