macos-hig-designer

Validate macOS SwiftUI and AppKit code against Apple's Human Interface Guidelines.

4|Updated Jan 27, 2026
One-click install
npx skills add https://github.com/k97/dock-tile --skill macos-hig-designer-k97
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: macos-hig-designer
Source: https://github.com/k97/dock-tile/tree/main/.agents/skills/macos-hig-designer
Command: npx skills add https://github.com/k97/dock-tile --skill macos-hig-designer-k97

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill solves the challenge of maintaining consistency with Apple's evolving Human Interface Guidelines and the complex Liquid Glass design system, ensuring your macOS apps feel native and polished.

Core Features & Use Cases

  • HIG Compliance: Validates UI code against Apple's latest design principles, including Liquid Glass materials and window management.
  • Modern API Migration: Identifies deprecated AppKit patterns and provides modern SwiftUI replacements for windowing, menus, and toolbars.
  • Use Case: Use this to modernize a legacy macOS app by replacing outdated NSWindowControllers with declarative WindowGroup scenes and applying the correct Liquid Glass materials to sidebars and toolbars.

Quick Start

Ask the macos-hig-designer to review your current SwiftUI view code for compliance with the latest Liquid Glass design principles.

Frequently Asked Questions about macos-hig-designer

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

FAQPage Schema
How do I apply Liquid Glass materials to a SwiftUI sidebar in macOS?

To apply Liquid Glass materials in a SwiftUI sidebar, you must follow architectural guidance for modern API recommendations and compliance checks for Apple's HIG. This ensures your navigation structures and toolbars use system-standard window management correctly.

What is the best way to migrate deprecated AppKit patterns to modern SwiftUI windowing?

Migrating deprecated AppKit patterns to modern SwiftUI windowing involves replacing outdated NSWindowControllers with declarative WindowGroup scenes. This approach modernizes macOS apps by adopting current API recommendations for windowing, menus, and toolbars.

How do I validate my macOS app code against Apple's Human Interface Guidelines?

You validate your macOS app code against Apple's Human Interface Guidelines by running automated compliance checks on your SwiftUI and AppKit implementation. This validates UI code against the latest design principles, including Liquid Glass materials and window management.

Can I use AppKit components alongside SwiftUI for native macOS Tahoe interfaces?

Yes, you can use AppKit components alongside SwiftUI to build native macOS Tahoe interfaces. The Skill provides architectural guidance and code validation for native macOS application development using both frameworks, ensuring proper integration and HIG compliance.

Why does my macOS app not feel native despite using SwiftUI WindowGroup scenes?

Your macOS app might not feel native if it lacks proper Liquid Glass materials, correct navigation structures, or system-standard window management. Validating your SwiftUI view code against the latest Human Interface Guidelines ensures adherence to modern design principles.