macos-development

Provides macOS development guidance covering Swift 6, SwiftUI, SwiftData, AppKit, and macOS 26 Tahoe APIs.

70|4|Updated Jul 22, 2025
One-click install
npx skills add https://github.com/AlexW00/Zettel --skill macos-development-alexw00
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: macos-development
Source: https://github.com/AlexW00/Zettel/tree/main/.agents/skills/macos-development
Command: npx skills add https://github.com/AlexW00/Zettel --skill macos-development-alexw00

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? macOS developers often need consolidated, up-to-date guidance across many domains—Swift 6 concurrency, SwiftData persistence, AppKit bridging, accessibility, and new macOS 26 Tahoe APIs—without hunting through scattered documentation. This Skill aggregates modular reference material so an AI assistant can give accurate, platform-specific answers for code review, architecture decisions, and UI review. ## Core Features & Use Cases - Modular reference library: Organized modules covering coding best practices, architecture patterns (SOLID, MVVM, Repository, Coordinator), SwiftData schema design and performance, macOS Tahoe APIs (Apple Intelligence, MLX, Continuity), AppKit-SwiftUI bridging, sandboxing, background tasks, and accessibility. - Code review and UI review: Review Swift/SwiftUI/AppKit code against modern idioms, HIG compliance, Liquid Glass design, and WCAG accessibility checklists. - Architecture planning: Plan new macOS apps or audit existing ones using clean architecture, dependency injection, and modular SPM design. - Use Case: Ask why your SwiftData queries are slow, and the assistant reads the SwiftData performance and query-patterns modules to recommend fetch limits, predicates, and background contexts tailored to your code. ## Quick Start Ask the assistant to review your macOS app's SwiftUI code for macOS 26 best practices and accessibility compliance.

Frequently Asked Questions about macos-development

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I structure a macOS app with SwiftUI and MVVM?▼

Use feature-based project organization with ViewModels marked @Observable or @MainActor ObservableObject, and inject repositories via protocols. The skill's code-organization and design-patterns modules provide complete MVVM, Repository, and Coordinator implementations.

SwiftData vs Core Data: which should I use for a new macOS app?▼

Use SwiftData for new projects—it offers @Model classes, #Predicate queries, and CloudKit sync with less boilerplate. Core Data remains appropriate for complex migrations from existing apps or advanced fetched results controller scenarios.

How do I bridge AppKit views into SwiftUI on macOS?▼

Wrap AppKit views using NSViewRepresentable to embed them in SwiftUI hierarchies, or use NSHostingView to embed SwiftUI inside AppKit view controllers. The appkit-swiftui-bridge module covers state management between both frameworks.

Does the skill cover macOS 26 Tahoe features like Apple Intelligence?▼

Yes, the macos-tahoe-apis module covers Foundation Models, on-device ML with MLX, Model Context Protocol integration, Continuity features like Handoff and Universal Clipboard, and Xcode 16 tooling.

How do I make my macOS app accessible with VoiceOver?▼

Add accessibility labels, hints, and traits to all interactive elements, support Dynamic Type and keyboard navigation, and respect reduce-motion preferences. The accessibility module includes a full checklist and SwiftUI/AppKit code examples.

How do I run background tasks or launch at login on macOS?▼

Register login items with SMAppService from the ServiceManagement framework, and schedule periodic work with BGTaskScheduler or NSBackgroundActivityScheduler. The background module covers sandboxed-app constraints and file system monitoring.