ui-review-tahoe_skill

Overview

This skill performs comprehensive UI/UX reviews for macOS Tahoe apps, focused on Liquid Glass design, HIG compliance, SwiftUI patterns, AppKit modernization, and accessibility. I deliver prioritized, actionable findings with concrete fixes and references so teams can align their app with macOS 26 best practices.

How this skill works

I begin by asking about the app’s purpose, audience, supported macOS versions, and framework (SwiftUI, AppKit, or hybrid). Then I run a systematic audit across visual design, layout/navigation, controls, accessibility, performance, and platform integration. For each issue I provide: the problem, guideline violated, user impact, a recommended fix (code or design), and module references for deeper reading.

When to use it

• Before a public macOS 26 (Tahoe) release to ensure HIG compliance
• When migrating UI from AppKit to SwiftUI or using a hybrid approach
• To verify Liquid Glass design and system material usage
• When addressing accessibility gaps (VoiceOver, keyboard, Dynamic Type)
• During design reviews to align spacing, hierarchy and animations

Best practices

• Start reviews by sharing app goals, target users, screenshots, and key screens
• Prioritize accessibility and platform conventions as critical issues
• Use concrete code snippets for SwiftUI/AppKit fixes to speed developer acceptance
• Check Tahoe-specific SwiftUI quirks and NSHostingView usage for hybrid apps
• Reference specific modules (e.g., skills/ui-review-tahoe/macos-tahoe-hig.md) for deeper guidance

Example use cases

• A developer migrating a legacy AppKit toolbar to Liquid Glass and Tahoe HIG
• A design team validating spacing, depth, and transparency against macOS 26 standards
• An accessibility audit to fix VoiceOver navigation and Dynamic Type support
• A QA pass to identify SwiftUI layout bugs and animation performance regressions
• Preparing an app for App Store review with a checklist-driven HIG compliance pass