Agent-Skills.md

Agent Skills: iOS Design Review

Review iOS code for Apple HIG compliance. Use when validating SwiftUI/UIKit code, checking accessibility, or auditing iOS design implementation.

UncategorizedID: beshkenadze/claude-skills-marketplace/ios-design-review
1

Install this agent skill to your local

pnpm dlx add-skill https://github.com/beshkenadze/claude-skills-marketplace/tree/HEAD/skills/development/ios-design-review

Skill Files

Browse the full folder contents for ios-design-review.

Download Skill

Loading file tree…

skills/development/ios-design-review/SKILL.md

Skill Metadata

Name
ios-design-review
Description
Review iOS code for Apple HIG compliance. Use when validating SwiftUI/UIKit code, checking accessibility, or auditing iOS design implementation.

iOS Design Review

Validate SwiftUI/UIKit code against Apple Human Interface Guidelines.

When to Use

  • After generating SwiftUI components
  • Before submitting iOS code for review
  • Auditing existing iOS UI code
  • Checking accessibility compliance

Review Checklist

1. Colors & Theming

  • [ ] Uses semantic colors (Color.primary, Color(.systemBackground))
  • [ ] No hardcoded hex colors
  • [ ] Works in both Light and Dark mode
  • [ ] High contrast mode support

2. Typography

  • [ ] Uses system fonts (San Francisco)
  • [ ] Supports Dynamic Type
  • [ ] Proper text styles (.headline, .body, .caption)
  • [ ] No fixed font sizes for body text

3. Touch Targets

  • [ ] Minimum 44×44 points for interactive elements
  • [ ] Adequate spacing between tappable items (12-24pt)
  • [ ] No gesture conflicts with system gestures

4. Accessibility

  • [ ] VoiceOver labels on icon-only buttons
  • [ ] accessibilityElement(children: .combine) for grouped content
  • [ ] accessibilityHidden(true) for decorative elements
  • [ ] Meaningful accessibility hints where needed

5. Navigation

  • [ ] Tab bar for 2-5 primary destinations (not actions)
  • [ ] Navigation titles present
  • [ ] Back button behavior correct
  • [ ] Modal dismiss patterns (swipe, X button)

6. SF Symbols

  • [ ] Uses SF Symbols over custom icons where possible
  • [ ] Correct rendering mode (monochrome/hierarchical/palette)
  • [ ] Symbols scale with Dynamic Type

7. Layout

  • [ ] Safe area respected
  • [ ] Adapts to different screen sizes
  • [ ] Proper keyboard avoidance
  • [ ] No content clipping

Review Output Format

## HIG Compliance Review

**File:** `Views/SettingsView.swift`

### Issues Found

#### Critical
- Line 45: Touch target too small (32×32pt)
  Fix: Add `.frame(minWidth: 44, minHeight: 44)`

#### Warnings
- Line 23: Hardcoded color `Color(hex: "#FF5733")`
  Fix: Use `Color.accentColor` or semantic color

#### Suggestions
- Line 67: Consider adding accessibilityLabel to icon button

### Summary
- Critical: 1
- Warnings: 1
- Suggestions: 1
- Overall: Needs fixes before shipping

Common Issues

Color Issues

// ❌ Problem
Text("Hello").foregroundColor(Color(hex: "#333333"))

// ✅ Fix
Text("Hello").foregroundStyle(.primary)

Touch Target Issues

// ❌ Problem
Button { } label: {
    Image(systemName: "plus")
}

// ✅ Fix
Button { } label: {
    Image(systemName: "plus")
        .frame(minWidth: 44, minHeight: 44)
}

Accessibility Issues

// ❌ Problem
Button { delete() } label: {
    Image(systemName: "trash")
}

// ✅ Fix
Button { delete() } label: {
    Image(systemName: "trash")
}
.accessibilityLabel("Delete item")

Usage

User: Review this SwiftUI view for HIG compliance
[pastes code]

Claude: [Runs checklist against code]
- Identifies issues by category
- Provides specific line numbers
- Suggests fixes with code examples

Related Skills

  • ios-swiftui-generator — Generate compliant code
  • ios-hig-reference — Full HIG reference
iOS Design Review Skill | Agent Skills