swiftui-expert-skill

por expo

Escribir, revisar o mejorar código SwiftUI siguiendo las mejores prácticas para gestión de estado, composición de vistas, rendimiento, APIs específicas de macOS y Liquid… de iOS 26+.

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

Más skills de expo

add-app-clip
expo
Agregar un destino de App Clip de iOS a una app de Expo. Úsalo cuando el usuario mencione App Clip, AASA, apple-app-site-association, appclips, smart app banner, o quiera enviar…
android-e2e-testing
expo
Prueba las funciones de Expo Router en emuladores de Android usando ADB. Úsalo después de implementar funciones nativas de Android o al verificar el comportamiento de la interfaz de usuario en Android.
android-jetpack-compose
expo
Úsalo al crear interfaces de Android con Jetpack Compose, gestionar estado con remember/mutableStateOf o implementar patrones de UI declarativos.
api-routes
expo
Directrices para crear rutas de API en Expo Router con EAS Hosting
building-native-ui
expo
Guía completa para crear aplicaciones nativas con Expo, que abarca enrutamiento, estilos, componentes y convenciones de plataforma. Cubre los fundamentos de Expo Router, pestañas nativas, navegación en pila, modales y hojas de formulario con convenciones detalladas de estructura de rutas. Incluye reglas de estilo alineadas con las Guías de Interfaz Humana de Apple: diseños flexbox, manejo de áreas seguras, animaciones, sombras mediante CSS boxShadow y patrones de diseño responsivo. Documenta preferencias de librerías (expo-image para SF Symbols, expo-audio, expo-video,...).
building-ui
expo
Guía completa para crear aplicaciones hermosas con Expo Router. Cubre fundamentos, estilos, componentes, navegación, animaciones, patrones y pestañas nativas.
cicd-workflows
expo
Ayuda a comprender y escribir archivos YAML de flujos de trabajo EAS para proyectos de Expo. Usa esta habilidad cuando el usuario pregunte sobre CI/CD o flujos de trabajo en un contexto de Expo o EAS,…
data-fetching
expo
Úsalo al implementar o depurar CUALQUIER solicitud de red, llamada a API o recuperación de datos. Cubre fetch API, axios, React Query, SWR, manejo de errores, almacenamiento en caché…