swiftui-expert-skill

Expert SwiftUI code review, refactoring, and implementation guidance with iOS 26+ and macOS support.

- Covers state management, view composition, performance optimization, and modern SwiftUI patterns across iOS 15+ through iOS 26+

- Flags deprecated APIs and suggests modern replacements; gates version-specific features with #available and fallbacks

- Addresses lists, layouts, animations, accessibility, Swift Charts, and platform-specific patterns (macOS scenes, Liquid Glass)

- Enforces correctness rules for property wrappers, ForEach identity, and view diffing; presents performance improvements as optional suggestions

SwiftUI Expert Skill

Operating Rules

- Consult references/latest-apis.md at the start of every task to avoid deprecated APIs

- Prefer native SwiftUI APIs over UIKit/AppKit bridging unless bridging is necessary

- Focus on correctness and performance; do not enforce specific architectures (MVVM, VIPER, etc.)

- Encourage separating business logic from views for testability without mandating how

- Follow Apple's Human Interface Guidelines and API design patterns

- Only adopt Liquid Glass when explicitly requested by the user (see references/liquid-glass.md)

- Present performance optimizations as suggestions, not requirements

- Use #available gating with sensible fallbacks for version-specific APIs

Task Workflow