macos-development

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

Updated May 11, 2026
One-click install
npx skills add https://github.com/cloudofgeorge/AI-hands-Engineer --skill macos-development-cloudofgeorge
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: macos-development
Source: https://github.com/cloudofgeorge/AI-hands-Engineer/tree/main/skills/engineering/domains/macos/macos-development
Command: npx skills add https://github.com/cloudofgeorge/AI-hands-Engineer --skill macos-development-cloudofgeorge

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? macOS developers often need consolidated, up-to-date guidance across Swift language idioms, architecture patterns, data persistence, UI review, and new platform APIs, but this knowledge is scattered across documentation and WWDC sessions. ## Core Features & Use Cases - Modular Reference Library: Organized modules covering Swift 6+ best practices, modern concurrency, SOLID architecture, SwiftData schema design, and AppKit/SwiftUI bridging. - macOS 26 Tahoe Coverage: Guidance on Liquid Glass design, Apple Intelligence integration, MLX on-device ML, Continuity features, and Xcode 16 tooling. - UI and Accessibility Review: Checklists for HIG compliance, VoiceOver support, Dynamic Type, keyboard navigation, and WCAG color contrast. - Use Case: When reviewing a SwiftUI view for accessibility, load the ui-review-tahoe module to check VoiceOver labels, focus management, and reduce-motion handling against concrete code examples. ## Quick Start Ask the agent to review your SwiftUI view for macOS 26 Liquid Glass compliance and accessibility issues.

Frequently Asked Questions about macos-development

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

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

Use NSViewRepresentable to wrap AppKit views for use inside SwiftUI hierarchies, and NSHostingView or NSHostingController to embed SwiftUI content inside AppKit apps. The skill's appkit-swiftui-bridge module covers state management between the two frameworks.

What is the best way to handle data persistence in a new macOS app?▼

Use SwiftData for new projects, defining @Model classes with explicit relationships and delete rules, and query with @Query in SwiftUI views. Core Data remains appropriate for legacy migrations or advanced features not yet available in SwiftData.

Does SwiftUI support the macOS 26 Liquid Glass design system?▼

Yes, Liquid Glass is applied through system materials like .ultraThinMaterial and .regularMaterial, semantic colors, subtle shadows, and spring animations. The skill also references a dedicated liquid-glass skill for the newer .glassEffect() API.

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

Add accessibilityLabel and accessibilityHint to interactive elements, combine child elements where appropriate, support keyboard navigation with @FocusState, and respect Dynamic Type and reduce-motion preferences. Test with VoiceOver enabled using Cmd+F5.

When should I use AppKit instead of SwiftUI on macOS?▼

Choose AppKit for complex table views with custom cells, advanced text editing via NSTextView, precise custom drawing, performance-critical UI, or features not yet available in SwiftUI. Hybrid approaches using hosting controllers are common.

How do I migrate an existing Core Data app to SwiftData?▼

Create SwiftData @Model classes mirroring your Core Data entities, then run a migration utility that fetches NSManagedObject instances and inserts converted models into a ModelContext. The skill's data-persistence module includes a step-by-step migration example.