ui-review-tahoe

Reviews macOS app interfaces for Liquid Glass design, HIG compliance, and accessibility.

Updated Mar 12, 2026
One-click install
npx skills add https://github.com/RavitejaKarra24/dotfiles --skill ui-review-tahoe-ravitejakarra24
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ui-review-tahoe
Source: https://github.com/RavitejaKarra24/dotfiles/tree/main/agents/.agents/skills/macos-development/ui-review-tahoe
Command: npx skills add https://github.com/RavitejaKarra24/dotfiles --skill ui-review-tahoe-ravitejakarra24

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Reviewing a macOS app's UI against Apple's Human Interface Guidelines, the Liquid Glass design system, and accessibility standards is time-consuming and easy to get wrong, especially with macOS 26 (Tahoe) introducing new design conventions and SwiftUI quirks. ## Core Features & Use Cases - Structured UI Audits: Systematically reviews visual design, layout, controls, accessibility, performance, and platform integration against a detailed checklist. - Prioritized Feedback: Categorizes findings as Critical, Important, or Nice-to-have, each with the violated guideline, user impact, and concrete SwiftUI or AppKit fix examples. - On-Demand Reference Modules: Loads focused guides for Liquid Glass design, macOS Tahoe HIG, SwiftUI patterns, AppKit modernization, and accessibility only when relevant. - Use Case: Paste your SwiftUI view code or share a screenshot of your macOS app, and receive a structured review report identifying HIG violations, VoiceOver gaps, and Tahoe-specific rendering issues with code-level fixes. ## Quick Start Ask the assistant to review your macOS app's SwiftUI view code or screenshots for macOS Tahoe HIG compliance and accessibility issues.

Frequently Asked Questions about ui-review-tahoe

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

FAQPage Schema
How do I review my macOS app for HIG compliance?

Provide your SwiftUI or AppKit UI code, or screenshots of the interface, and describe the app's purpose and minimum macOS version. The review checks window chrome, toolbars, navigation patterns, controls, and menus against macOS Tahoe guidelines, returning prioritized findings with code fixes.

What is the Liquid Glass design system in macOS Tahoe?

Liquid Glass is the design language for macOS 26 built on transparency, depth, and system materials like .ultraThinMaterial and .regularMaterial. It emphasizes a transparent menu bar, subtle shadows, smooth spring animations, and semantic colors that adapt to light and dark modes.

Does the review cover both SwiftUI and AppKit?

Yes, it handles SwiftUI, AppKit, and hybrid apps. SwiftUI reviews cover NavigationSplitView, Table, and known Tahoe layout bugs, while AppKit reviews cover NSVisualEffectView, NSTableView, window controllers, and NSHostingView integration patterns.

How do I make my macOS app accessible for VoiceOver users?

Group related controls into containers with accessibilityElement, provide labels and hints on interactive elements, mirror hover-only controls as accessibility actions, and support keyboard navigation and Dynamic Type. The review audits all of these plus color contrast against WCAG AA.

What are known SwiftUI layout issues on macOS Tahoe?

Some SwiftUI layouts break on Tahoe, frame changes may not animate smoothly inside NSHostingView, and certain custom transparency effects render incorrectly. Workarounds include explicit frames and spacing, fixed animation durations, and sticking to tested system materials.