swiftui-expert-skill

par expo

Écrire, réviser ou améliorer du code SwiftUI en suivant les meilleures pratiques pour la gestion d'état, la composition de vues, les performances, les API spécifiques à macOS et iOS 26+ Liquid…

npx skills add https://github.com/expo/agent-templates --skill swiftui-expert-skill

SwiftUI Expert Skill

Operating Rules

  • Consult references/latest-apis.md at the start of every task to avoid deprecated APIs
  • Prefer native SwiftUI APIs over UIKit/AppKit bridging unless bridging is necessary
  • Focus on correctness and performance; do not enforce specific architectures (MVVM, VIPER, etc.)
  • Encourage separating business logic from views for testability without mandating how
  • Follow Apple's Human Interface Guidelines and API design patterns
  • Only adopt Liquid Glass when explicitly requested by the user (see references/liquid-glass.md)
  • Present performance optimizations as suggestions, not requirements
  • Use #available gating with sensible fallbacks for version-specific APIs

Task Workflow

Review existing SwiftUI code

  • Read the code under review and identify which topics apply
  • Flag deprecated APIs (compare against references/latest-apis.md)
  • Run the Topic Router below for each relevant topic
  • Validate #available gating and fallback paths for iOS 26+ features

Improve existing SwiftUI code

  • Audit current implementation against the Topic Router topics
  • Replace deprecated APIs with modern equivalents from references/latest-apis.md
  • Refactor hot paths to reduce unnecessary state updates
  • Extract complex view bodies into separate subviews
  • Suggest image downsampling when UIImage(data:) is encountered (optional optimization, see references/image-optimization.md)

Implement new SwiftUI feature

  • Design data flow first: identify owned vs injected state
  • Structure views for optimal diffing (extract subviews early)
  • Apply correct animation patterns (implicit vs explicit, transitions)
  • Use Button for all tappable elements; add accessibility grouping and labels
  • Gate version-specific APIs with #available and provide fallbacks

Topic Router

Consult the reference file for each topic relevant to the current task:

TopicReference
State managementreferences/state-management.md
View compositionreferences/view-structure.md
Performancereferences/performance-patterns.md
Lists and ForEachreferences/list-patterns.md
Layoutreferences/layout-best-practices.md
Sheets and navigationreferences/sheet-navigation-patterns.md
ScrollViewreferences/scroll-patterns.md
Animations (basics)references/animation-basics.md
Animations (transitions)references/animation-transitions.md
Animations (advanced)references/animation-advanced.md
Accessibilityreferences/accessibility-patterns.md
Swift Chartsreferences/charts.md
Charts accessibilityreferences/charts-accessibility.md
Image optimizationreferences/image-optimization.md
Liquid Glass (iOS 26+)references/liquid-glass.md
macOS scenesreferences/macos-scenes.md
macOS window stylingreferences/macos-window-styling.md
macOS viewsreferences/macos-views.md
Deprecated API lookupreferences/latest-apis.md

Correctness Checklist

These are hard rules -- violations are always bugs:

  • @State properties are private
  • @Binding only where a child modifies parent state
  • Passed values never declared as @State or @StateObject (they ignore updates)
  • @StateObject for view-owned objects; @ObservedObject for injected
  • iOS 17+: @State with @Observable; @Bindable for injected observables needing bindings
  • ForEach uses stable identity (never .indices for dynamic content)
  • Constant number of views per ForEach element
  • .animation(_:value:) always includes the value parameter
  • iOS 26+ APIs gated with #available and fallback provided
  • import Charts present in files using chart types

References

  • references/latest-apis.md -- Read first for every task. Deprecated-to-modern API transitions (iOS 15+ through iOS 26+)
  • references/state-management.md -- Property wrappers, data flow, @Observable migration
  • references/view-structure.md -- View extraction, container patterns, @ViewBuilder
  • references/performance-patterns.md -- Hot-path optimization, update control, _logChanges()
  • references/list-patterns.md -- ForEach identity, Table (iOS 16+), inline filtering pitfalls
  • references/layout-best-practices.md -- Layout patterns, GeometryReader alternatives
  • references/accessibility-patterns.md -- VoiceOver, Dynamic Type, grouping, traits
  • references/animation-basics.md -- Implicit/explicit animations, timing, performance
  • references/animation-transitions.md -- View transitions, matchedGeometryEffect, Animatable
  • references/animation-advanced.md -- Phase/keyframe animations (iOS 17+), @Animatable macro (iOS 26+)
  • references/charts.md -- Swift Charts marks, axes, selection, styling, Chart3D (iOS 26+)
  • references/charts-accessibility.md -- Charts VoiceOver, Audio Graph, fallback strategies
  • references/sheet-navigation-patterns.md -- Sheets, NavigationSplitView, Inspector
  • references/scroll-patterns.md -- ScrollViewReader, programmatic scrolling
  • references/image-optimization.md -- AsyncImage, downsampling, caching
  • references/liquid-glass.md -- iOS 26+ Liquid Glass effects and fallback patterns
  • references/macos-scenes.md -- Settings, MenuBarExtra, WindowGroup, multi-window
  • references/macos-window-styling.md -- Toolbar styles, window sizing, Commands
  • references/macos-views.md -- HSplitView, Table, PasteButton, AppKit interop

Plus de skills de expo

add-app-clip
expo
Ajouter une cible App Clip iOS à une application Expo. Utiliser lorsque l'utilisateur mentionne App Clip, AASA, apple-app-site-association, appclips, bannière d'application intelligente, ou souhaite publier…
android-e2e-testing
expo
Testez les fonctionnalités d'Expo Router sur des émulateurs Android à l'aide d'ADB. À utiliser après avoir implémenté des fonctionnalités Android natives ou lors de la vérification du comportement de l'interface utilisateur sur Android.
android-jetpack-compose
expo
À utiliser lors de la création d'interfaces utilisateur Android avec Jetpack Compose, de la gestion d'état avec remember/mutableStateOf, ou de l'implémentation de motifs d'interface déclaratifs.
api-routes
expo
Directives pour créer des routes API dans Expo Router avec EAS Hosting
building-native-ui
expo
Guide complet pour créer des applications Expo natives avec routage, styles, composants et conventions de plateforme. Couvre les fondamentaux d'Expo Router, les onglets natifs, la navigation par pile, les modales et les feuilles de formulaire avec des conventions détaillées de structure de routage. Inclut des règles de style alignées sur les Apple Human Interface Guidelines : mises en page flexbox, gestion des zones de sécurité, animations, ombres via CSS boxShadow, et motifs de conception responsive. Documente les préférences de bibliothèques (expo-image pour les symboles SF, expo-audio, expo-video,...).
building-ui
expo
Guide complet pour créer de belles applications avec Expo Router. Couvre les fondamentaux, le style, les composants, la navigation, les animations, les motifs et les onglets natifs.
cicd-workflows
expo
Aide à comprendre et à rédiger des fichiers YAML de workflows EAS pour les projets Expo. Utilisez cette compétence lorsque l'utilisateur pose des questions sur le CI/CD ou les workflows dans un contexte Expo ou EAS,…
data-fetching
expo
À utiliser lors de l'implémentation ou du débogage de TOUTE requête réseau, appel API ou récupération de données. Couvre fetch API, axios, React Query, SWR, gestion des erreurs, mise en cache…