Use when building, fixing, or improving ANY SwiftUI UI — views, navigation, layout, animations, performance, architecture, gestures, debugging, iOS 26 features.
You MUST use this skill for ANY SwiftUI work including views, state, navigation, layout, animations, architecture, gestures, and debugging.
| Symptom / Task | Reference |
|---|---|
| View not updating | See skills/debugging.md |
| View update still broken after debugging | See skills/debugging-diag.md |
| Navigation issues | See skills/nav.md |
| Navigation still broken after debugging | See skills/nav-diag.md |
| Navigation API reference | See skills/nav-ref.md |
| Layout breaks on iPad/rotation | See skills/layout.md |
| Layout API reference | See skills/layout-ref.md |
| Performance/lag/slow scroll |
See skills/swiftui-performance.md |
| Architecture/testability | See skills/architecture.md |
| Animation issues | See skills/animation-ref.md |
| Stacks/grids/outlines | See skills/containers-ref.md |
| Search implementation | See skills/search-ref.md |
| Gesture conflicts | See skills/gestures.md |
| iOS 26 features | See skills/26-ref.md |
These topics are part of the broader iOS UI domain but live in separate suites:
/skill axiom-accessibility/skill axiom-testingux-flow-auditor agentaxiom-swiftui vs axiom-performance: When UI is slow (e.g., "SwiftUI List slow"):
digraph swiftui {
start [label="SwiftUI issue" shape=ellipse];
what [label="What's wrong?" shape=diamond];
start -> what;
what -> "skills/debugging.md" [label="view not updating"];
what -> "skills/nav.md" [label="navigation"];
what -> "skills/swiftui-performance.md" [label="slow/lag"];
what -> "skills/layout.md" [label="adaptive layout"];
what -> "skills/containers-ref.md" [label="stacks/grids/outlines"];
what -> "skills/architecture.md" [label="feature architecture"];
what -> "skills/animation-ref.md" [label="animations"];
what -> "skills/gestures.md" [label="gestures"];
what -> "skills/search-ref.md" [label="search"];
what -> "skills/26-ref.md" [label="iOS 26 features"];
what -> "axiom-uikit-bridging" [label="UIKit interop"];
what -> "axiom-app-composition" [label="app-level (root, auth)"];
what -> "axiom-transferable-ref" [label="drag/drop, sharing"];
}
swiftui-architecture-auditor agentswiftui-performance-analyzer agent or /axiom:audit swiftui-performanceswiftui-nav-auditor agent or /axiom:audit swiftui-navswiftui-layout-auditor agent or /axiom:audit swiftui-layoutux-flow-auditor agent or /axiom:audit ux-flowliquid-glass-auditor agent or /axiom:audit liquid-glasstextkit-auditor agent or /axiom:audit textkit| Thought | Reality |
|---|---|
| "Simple SwiftUI layout, no need" | SwiftUI layout has 12 gotchas. skills/layout.md covers all of them. |
| "I know how NavigationStack works" | Navigation has state restoration, deep linking, and identity traps. skills/nav.md prevents 2-hour debugging. |
| "It's just a view not updating" | View update failures have 4 root causes. skills/debugging.md diagnoses in 5 min. |
| "I'll just add .animation()" | Animation issues compound. skills/animation-ref.md has the correct patterns. |
| "No architecture needed" | Even small features benefit from separation. skills/architecture.md prevents refactoring debt. |
| "I know .searchable" | Search has 6 gotchas. skills/search-ref.md covers all of them. |