wshobson/agents

Overview

This skill teaches iOS Human Interface Guidelines and SwiftUI patterns for building native, polished iOS apps. It focuses on clarity, deference, and depth while enabling adaptive layouts, accessible components, and platform-consistent navigation. Use it to design, implement, and validate iOS interfaces that feel native on iPhone and iPad.

How this skill works

The skill inspects UI decisions and suggests SwiftUI idioms, layout structures, and system integrations (SF Symbols, semantic colors, Dynamic Type). It recommends navigation patterns (NavigationStack, TabView, sheets), performance techniques (lazy stacks, grid patterns), and accessibility improvements. It also flags common pitfalls like hardcoded colors, navigation bugs, and layout breakage.

When to use it

• Designing UI that follows Apple Human Interface Guidelines
• Implementing SwiftUI views, stacks, grids, and cards
• Creating adaptive layouts for iPhone, iPad, and multitasking
• Ensuring accessibility, Dynamic Type, and Dark Mode support
• Integrating SF Symbols and semantic system colors
• Diagnosing layout, performance, or navigation issues

Best practices

• Prefer semantic fonts (.body, .headline) and system colors (.primary, .background) to support Dynamic Type and Dark Mode
• Use stack- and grid-based layouts (VStack, HStack, LazyVGrid) instead of fixed frames for adaptability
• Embrace SF Symbols for consistent iconography and automatic accessibility behavior
• Respect safe areas and use safeAreaInset instead of hardcoded edge padding
• Add accessibility modifiers (.accessibilityLabel, .accessibilityHint) and test with VoiceOver
• Use lazy containers for long lists and @SceneStorage for simple state restoration

Example use cases

• Convert a UIKit screen to SwiftUI using NavigationStack and adaptive LazyVGrid
• Design a reusable FeatureCard component with semantic styling and accessibility labels
• Fix a layout that breaks at large Dynamic Type sizes by switching to flexible stacks
• Implement TabView-based app structure with stateful selection and deep-link restoration
• Optimize a long-scrolling feed by replacing VStack with LazyVStack and onAppear loading