ios-design-review_skill

Overview

This skill reviews iOS SwiftUI and UIKit code for compliance with Apple Human Interface Guidelines (HIG). It highlights accessibility, color/theming, typography, touch-targets, navigation, SF Symbols, and layout issues with actionable fixes. Use it to catch HIG violations before code review or shipping.

How this skill works

The skill runs a structured checklist against submitted SwiftUI/UIKit source, detecting hardcoded colors, improper fonts, small touch targets, missing VoiceOver labels, navigation and modal pattern problems, SF Symbol misuse, and layout issues. It reports issues with file/line references, severity categories (Critical, Warning, Suggestion), and concrete code fixes or sample snippets to remediate each problem. Output follows a concise HIG Compliance Review format so you can paste findings directly into PRs or issue trackers.

When to use it

• After generating SwiftUI or UIKit components
• Before submitting iOS code for review or CI gating
• Auditing existing iOS UI implementations for HIG compliance
• Checking accessibility (VoiceOver, Dynamic Type, contrast)
• Validating theming for Light/Dark and high-contrast modes

Best practices

• Prefer semantic colors and system backgrounds; avoid hardcoded hex values
• Use system fonts and Dynamic Type text styles (headline, body, caption) — avoid fixed body sizes
• Ensure interactive elements are at least 44×44 points and spaced 12–24pt apart
• Provide accessibilityLabel, accessibilityHint, and combine grouped elements appropriately
• Use SF Symbols where appropriate and choose correct rendering modes (monochrome, hierarchical, palette)

Example use cases

• Review a SwiftUI View after code generation to catch accessibility gaps
• Audit a settings screen for touch-targets, navigation titles, and modal dismiss patterns
• Scan a large codebase to find hardcoded colors and Dynamic Type violations
• Validate that icons use SF Symbols and scale correctly with text size
• Produce a PR-ready HIG Compliance Review with file/line issue list and suggested fixes