Native App Designer

Mandatory Consultation Rule (macOS/iOS)

When the stack is macOS and/or iOS and the task touches interface or user experience, load this skill before implementation.

Use this sequence:

1. native-app-designer -> define UX/UI direction and acceptance criteria.
2. swiftui-patterns or macos-development -> implement structure and platform behavior.
3. swiftui-animation / swiftui-performance-audit -> refine motion and runtime quality when needed.

UX/UI Review Checklist

1. Clarity: Primary actions and hierarchy are obvious within 3 seconds.
2. Consistency: Uses project design-system components/tokens before custom wrappers.
3. Native Feel: Interactions align with macOS/iOS conventions.
4. Accessibility: Labels, contrast, and reduced-motion paths are covered.
5. Motion Quality: Animation supports comprehension, not decoration.
6. Visual Rhythm: Spacing/typography form clear grouping and scanning flow.
7. Redundancy Control: Nearby titles, descriptions, tooltips, and popovers do not repeat the same message.

Practical Guidelines

• Prefer semantic colors/materials and design-system tokens over hardcoded values.
• Avoid generic, repetitive layouts that flatten hierarchy.
• In settings and inspector-style screens, keep one primary explanation per cluster. Do not repeat identical copy in the page header, section header, card body, and tooltip.
• Treat popovers/help affordances as escalation, not baseline content. If two or more nearby popovers explain the same concept or add little beyond visible copy, consolidate or remove them.
• Use motion to guide attention and communicate state changes.
• Keep reduced-motion behavior available for motion-heavy transitions.
• For macOS surfaces, use AppKit bridging only when SwiftUI behavior is insufficient.

Routing

• Need concrete SwiftUI state/layout patterns -> ../swiftui-patterns/SKILL.md
• Need advanced transition/shader choreography -> ../swiftui-animation/SKILL.md
• Need runtime performance diagnosis for jank/layout thrash -> ../swiftui-performance-audit/SKILL.md
• Need broader platform lifecycle/integration decisions -> ../macos-development/SKILL.md