reis-mobile 0.4.0 → 0.5.0

package/skills/{flutter-improving-accessibility/SKILL.md → mobile-flutter/references/accessibility-i18n/accessibility.md}

@@ -1,14 +1,5 @@
----
-name: flutter-improving-accessibility
-description: Configures a Flutter app to support assistive technologies like Screen Readers. Use when ensuring an application is usable for people with disabilities.
-metadata:
-  model: models/gemini-3.1-pro-preview
-  last_modified: Thu, 12 Mar 2026 22:17:37 GMT
-intents: [accessibility]
-stacks: [flutter]
-source: https://github.com/flutter/skills
-license: BSD-3-Clause
----
+> Adapted from the `flutter-improving-accessibility` skill in [flutter/skills](https://github.com/flutter/skills) (BSD-3-Clause). See `THIRD_PARTY_NOTICES.md`.
+
 # Implementing Flutter Accessibility
 
 ## Contents

package/skills/{flutter-setup-localization/SKILL.md → mobile-flutter/references/accessibility-i18n/localization.md}

@@ -1,14 +1,5 @@
----
-name: flutter-setup-localization
-description: Add `flutter_localizations` and `intl` dependencies, enable "generate true" in `pubspec.yaml`, and create an `l10n.yaml` configuration file. Use when initializing localization support for a new Flutter project.
-metadata:
-  model: models/gemini-3.1-pro-preview
-  last_modified: Tue, 21 Apr 2026 21:27:35 GMT
-routing: manual
-stacks: [flutter]
-source: https://github.com/flutter/skills
-license: BSD-3-Clause
----
+> Adapted from the `flutter-setup-localization` skill in [flutter/skills](https://github.com/flutter/skills) (BSD-3-Clause). See `THIRD_PARTY_NOTICES.md`.
+
 # Internationalizing Flutter Applications
 
 ## Contents

package/skills/mobile-flutter/references/accessibility-i18n.md

@@ -0,0 +1,8 @@
+# Flutter: Accessibility and internationalization
+
+Screen readers, semantics and localization. Open only the guide the task needs.
+
+| Guide | What it covers |
+|---|---|
+| [accessibility](accessibility-i18n/accessibility.md) | Configures a Flutter app to support assistive technologies like Screen Readers. |
+| [localization](accessibility-i18n/localization.md) | Add `flutter_localizations` and `intl` dependencies, enable "generate true" in `pubspec.yaml`, and create an `l10n.yaml` configuration file. |

package/skills/{flutter-dart-3-updates/SKILL.md → mobile-flutter/references/dart/dart-3.md}

@@ -1,11 +1,4 @@
----
-name: flutter-dart-3-updates
-description: Applies Dart 3 language features in Flutter/Dart code. Use when writing if-else or switch statements, creating new classes, or deciding between a data class and a record.
-intents: [migration]
-stacks: [flutter]
-source: https://github.com/evanca/flutter-ai-rules
-license: MIT
----
+> Adapted from the `dart-3-updates` skill in [evanca/flutter-ai-rules](https://github.com/evanca/flutter-ai-rules) (MIT). See `THIRD_PARTY_NOTICES.md`.
 
 # Dart 3 Updates Skill
 

package/skills/{flutter-effective-dart/SKILL.md → mobile-flutter/references/dart/effective-dart.md}

@@ -1,11 +1,4 @@
----
-name: flutter-effective-dart
-description: Applies Effective Dart guidelines in Flutter/Dart code. Use when writing or reviewing Dart code for naming conventions, types, style, imports, file structure, usage patterns, documentation, testing, widgets, state management, or performance.
-intents: [review]
-stacks: [flutter]
-source: https://github.com/evanca/flutter-ai-rules
-license: MIT
----
+> Adapted from the `effective-dart` skill in [evanca/flutter-ai-rules](https://github.com/evanca/flutter-ai-rules) (MIT). See `THIRD_PARTY_NOTICES.md`.
 
 # Effective Dart Skill
 

package/skills/{flutter-dart-use-pattern-matching/SKILL.md → mobile-flutter/references/dart/pattern-matching/GUIDE.md}

@@ -1,21 +1,5 @@
----
-name: flutter-dart-use-pattern-matching
-description: >-
-  Applies Dart 3 pattern matching, switch expressions, and destructuring
-  idiomatically to validate data schemas, handle algebraic data types, and
-  decompose control flow. Use when refactoring complex if-else chains,
-  parsing polymorphic JSON or API responses, destructuring Records or Maps, or
-  enforcing exhaustiveness on sealed classes. Don't use for simple boolean
-  conditions, single-variable type promotion (use `is`), or basic collection
-  filtering.
-metadata:
-  model: models/gemini-3.1-pro-preview
-  last_modified: Sun, 06 Sep 2026 06:43:00 GMT
-routing: manual
-stacks: [flutter]
-source: https://github.com/dart-lang/skills
-license: BSD-3-Clause
----
+> Adapted from the `dart-use-pattern-matching` skill in [dart-lang/skills](https://github.com/dart-lang/skills) (BSD-3-Clause). See `THIRD_PARTY_NOTICES.md`.
+
 # Implementing Dart Patterns
 
 ## Contents

package/skills/mobile-flutter/references/dart.md

@@ -0,0 +1,9 @@
+# Flutter: Dart language
+
+Effective Dart, Dart 3 features and pattern matching. Open only the guide the task needs.
+
+| Guide | What it covers |
+|---|---|
+| [effective-dart](dart/effective-dart.md) | Applies Effective Dart guidelines in Flutter/Dart code. |
+| [dart-3](dart/dart-3.md) | Applies Dart 3 language features in Flutter/Dart code. |
+| [pattern-matching](dart/pattern-matching/GUIDE.md) | Applies Dart 3 pattern matching, switch expressions, and destructuring idiomatically to validate data schemas, handle algebraic data types, and decompose control flow. |

package/skills/{flutter-caching-data/SKILL.md → mobile-flutter/references/data/caching.md}

@@ -1,14 +1,5 @@
----
-name: flutter-caching-data
-description: Implements caching strategies for Flutter apps to improve performance and offline support. Use when retaining app data locally to reduce network requests or speed up startup.
-metadata:
-  model: models/gemini-3.1-pro-preview
-  last_modified: Thu, 12 Mar 2026 22:19:54 GMT
-routing: manual
-stacks: [flutter]
-source: https://github.com/flutter/skills
-license: BSD-3-Clause
----
+> Adapted from the `flutter-caching-data` skill in [flutter/skills](https://github.com/flutter/skills) (BSD-3-Clause). See `THIRD_PARTY_NOTICES.md`.
+
 # Implementing Flutter Caching and Offline-First Architectures
 
 ## Contents

package/skills/{flutter-working-with-databases/SKILL.md → mobile-flutter/references/data/databases.md}

@@ -1,14 +1,5 @@
----
-name: flutter-working-with-databases
-description: Manages local data persistence using SQLite or other database solutions. Use when a Flutter app needs to store, query, or synchronize large amounts of structured data on the device.
-metadata:
-  model: models/gemini-3.1-pro-preview
-  last_modified: Thu, 12 Mar 2026 22:19:15 GMT
-routing: manual
-stacks: [flutter]
-source: https://github.com/flutter/skills
-license: BSD-3-Clause
----
+> Adapted from the `flutter-working-with-databases` skill in [flutter/skills](https://github.com/flutter/skills) (BSD-3-Clause). See `THIRD_PARTY_NOTICES.md`.
+
 # Architecting the Data Layer
 
 ## Contents

package/skills/{flutter-use-http-package/SKILL.md → mobile-flutter/references/data/http.md}

@@ -1,14 +1,5 @@
----
-name: flutter-use-http-package
-description: Use the `http` package to execute GET, POST, PUT, or DELETE requests. Use when you need to fetch from or send data to a REST API.
-metadata:
-  model: models/gemini-3.1-pro-preview
-  last_modified: Tue, 21 Apr 2026 21:36:42 GMT
-routing: manual
-stacks: [flutter]
-source: https://github.com/flutter/skills
-license: BSD-3-Clause
----
+> Adapted from the `flutter-use-http-package` skill in [flutter/skills](https://github.com/flutter/skills) (BSD-3-Clause). See `THIRD_PARTY_NOTICES.md`.
+
 # Implementing Flutter Networking
 
 ## Contents

package/skills/{flutter-implement-json-serialization/SKILL.md → mobile-flutter/references/data/json-serialization.md}

@@ -1,14 +1,5 @@
----
-name: flutter-implement-json-serialization
-description: Create model classes with `fromJson` and `toJson` methods using `dart:convert`. Use when manually mapping JSON keys to class properties for simple data structures.
-metadata:
-  model: models/gemini-3.1-pro-preview
-  last_modified: Tue, 21 Apr 2026 21:44:50 GMT
-routing: manual
-stacks: [flutter]
-source: https://github.com/flutter/skills
-license: BSD-3-Clause
----
+> Adapted from the `flutter-implement-json-serialization` skill in [flutter/skills](https://github.com/flutter/skills) (BSD-3-Clause). See `THIRD_PARTY_NOTICES.md`.
+
 # Serializing JSON Manually in Flutter
 
 ## Contents

package/skills/mobile-flutter/references/data.md

@@ -0,0 +1,10 @@
+# Flutter: Data and networking
+
+HTTP, JSON models, local databases and caching. Open only the guide the task needs.
+
+| Guide | What it covers |
+|---|---|
+| [http](data/http.md) | Use the `http` package to execute GET, POST, PUT, or DELETE requests. |
+| [json-serialization](data/json-serialization.md) | Create model classes with `fromJson` and `toJson` methods using `dart:convert`. |
+| [databases](data/databases.md) | Manages local data persistence using SQLite or other database solutions. |
+| [caching](data/caching.md) | Implements caching strategies for Flutter apps to improve performance and offline support. |

package/skills/{flutter-interoperating-with-native-apis/SKILL.md → mobile-flutter/references/native/native-apis.md}

@@ -1,14 +1,5 @@
----
-name: flutter-interoperating-with-native-apis
-description: Interoperates with native platform APIs on Android, iOS, and the web. Use when accessing device-specific features not available in Dart or calling existing native code.
-metadata:
-  model: models/gemini-3.1-pro-preview
-  last_modified: Thu, 12 Mar 2026 22:21:02 GMT
-routing: manual
-stacks: [flutter]
-source: https://github.com/flutter/skills
-license: BSD-3-Clause
----
+> Adapted from the `flutter-interoperating-with-native-apis` skill in [flutter/skills](https://github.com/flutter/skills) (BSD-3-Clause). See `THIRD_PARTY_NOTICES.md`.
+
 # Integrating Platform-Specific Code in Flutter
 
 ## Contents

package/skills/{flutter-embedding-native-views/SKILL.md → mobile-flutter/references/native/native-views.md}

@@ -1,14 +1,5 @@
----
-name: flutter-embedding-native-views
-description: Embeds native Android, iOS, or macOS views into a Flutter app. Use when integrating complex native components like maps or web views.
-metadata:
-  model: models/gemini-3.1-pro-preview
-  last_modified: Thu, 12 Mar 2026 22:20:28 GMT
-routing: manual
-stacks: [flutter]
-source: https://github.com/flutter/skills
-license: BSD-3-Clause
----
+> Adapted from the `flutter-embedding-native-views` skill in [flutter/skills](https://github.com/flutter/skills) (BSD-3-Clause). See `THIRD_PARTY_NOTICES.md`.
+
 # Integrating Platform Views and Web Content
 
 ## Contents

package/skills/{flutter-building-plugins/SKILL.md → mobile-flutter/references/native/plugins.md}

@@ -1,14 +1,5 @@
----
-name: flutter-building-plugins
-description: Builds Flutter plugins that provide native interop for other apps to use. Use when creating reusable packages that bridge Flutter with platform-specific functionality.
-metadata:
-  model: models/gemini-3.1-pro-preview
-  last_modified: Thu, 12 Mar 2026 22:21:35 GMT
-routing: manual
-stacks: [flutter]
-source: https://github.com/flutter/skills
-license: BSD-3-Clause
----
+> Adapted from the `flutter-building-plugins` skill in [flutter/skills](https://github.com/flutter/skills) (BSD-3-Clause). See `THIRD_PARTY_NOTICES.md`.
+
 # Developing Flutter Plugins
 
 ## Contents

package/skills/mobile-flutter/references/native.md

@@ -0,0 +1,9 @@
+# Flutter: Native code and plugins
+
+Platform channels, native APIs, plugins and embedded native views. Open only the guide the task needs.
+
+| Guide | What it covers |
+|---|---|
+| [plugins](native/plugins.md) | Builds Flutter plugins that provide native interop for other apps to use. |
+| [native-apis](native/native-apis.md) | Interoperates with native platform APIs on Android, iOS, and the web. |
+| [native-views](native/native-views.md) | Embeds native Android, iOS, or macOS views into a Flutter app. |

package/skills/{flutter-reducing-app-size/SKILL.md → mobile-flutter/references/performance/app-size.md}

@@ -1,14 +1,5 @@
----
-name: flutter-reducing-app-size
-description: Measures and optimizes the size of Flutter application bundles for deployment. Use when minimizing download size or meeting app store package constraints.
-metadata:
-  model: models/gemini-3.1-pro-preview
-  last_modified: Thu, 12 Mar 2026 22:22:44 GMT
-intents: [performance]
-stacks: [flutter]
-source: https://github.com/flutter/skills
-license: BSD-3-Clause
----
+> Adapted from the `flutter-reducing-app-size` skill in [flutter/skills](https://github.com/flutter/skills) (BSD-3-Clause). See `THIRD_PARTY_NOTICES.md`.
+
 # Reducing Flutter App Size
 
 ## Contents

package/skills/{flutter-handling-concurrency/SKILL.md → mobile-flutter/references/performance/concurrency.md}

@@ -1,14 +1,5 @@
----
-name: flutter-handling-concurrency
-description: Executes long-running tasks in background isolates to keep the UI responsive. Use when performing heavy computations or parsing large datasets.
-metadata:
-  model: models/gemini-3.1-pro-preview
-  last_modified: Thu, 12 Mar 2026 22:23:14 GMT
-intents: [performance]
-stacks: [flutter]
-source: https://github.com/flutter/skills
-license: BSD-3-Clause
----
+> Adapted from the `flutter-handling-concurrency` skill in [flutter/skills](https://github.com/flutter/skills) (BSD-3-Clause). See `THIRD_PARTY_NOTICES.md`.
+
 # Managing Dart Concurrency and Isolates
 
 ## Contents

package/skills/mobile-flutter/references/performance.md

@@ -0,0 +1,8 @@
+# Flutter: Performance and size
+
+Isolates for heavy work and app size. Open only the guide the task needs.
+
+| Guide | What it covers |
+|---|---|
+| [concurrency](performance/concurrency.md) | Executes long-running tasks in background isolates to keep the UI responsive. |
+| [app-size](performance/app-size.md) | Measures and optimizes the size of Flutter application bundles for deployment. |

package/skills/{flutter-setting-up-on-macos/SKILL.md → mobile-flutter/references/setup/macos.md}

@@ -1,14 +1,5 @@
----
-name: flutter-setting-up-on-macos
-description: Sets up a macOS environment for Flutter development. Use when configuring a macOS machine to run, build, or deploy Flutter applications for iOS or macOS.
-metadata:
-  model: models/gemini-3.1-pro-preview
-  last_modified: Thu, 12 Mar 2026 22:12:50 GMT
-routing: manual
-stacks: [flutter]
-source: https://github.com/flutter/skills
-license: BSD-3-Clause
----
+> Adapted from the `flutter-setting-up-on-macos` skill in [flutter/skills](https://github.com/flutter/skills) (BSD-3-Clause). See `THIRD_PARTY_NOTICES.md`.
+
 # Setting Up a macOS Environment for Flutter Development
 
 ## Contents

package/skills/mobile-flutter/references/setup.md

@@ -0,0 +1,7 @@
+# Flutter: Environment
+
+Setting up the development machine. Open only the guide the task needs.
+
+| Guide | What it covers |
+|---|---|
+| [macos](setup/macos.md) | Sets up a macOS environment for Flutter development. |

package/skills/{flutter-animating-apps/SKILL.md → mobile-flutter/references/ui/animations.md}

@@ -1,14 +1,5 @@
----
-name: flutter-animating-apps
-description: Implements animated effects, transitions, and motion in a Flutter app. Use when adding visual feedback, shared element transitions, or physics-based animations.
-metadata:
-  model: models/gemini-3.1-pro-preview
-  last_modified: Thu, 12 Mar 2026 22:16:34 GMT
-routing: manual
-stacks: [flutter]
-source: https://github.com/flutter/skills
-license: BSD-3-Clause
----
+> Adapted from the `flutter-animating-apps` skill in [flutter/skills](https://github.com/flutter/skills) (BSD-3-Clause). See `THIRD_PARTY_NOTICES.md`.
+
 # Implementing Flutter Animations
 
 ## Contents

package/skills/{flutter-building-forms/SKILL.md → mobile-flutter/references/ui/forms.md}

@@ -1,14 +1,5 @@
----
-name: flutter-building-forms
-description: Builds Flutter forms with validation and user input handling. Use when creating login screens, data entry forms, or any multi-field user input.
-metadata:
-  model: models/gemini-3.1-pro-preview
-  last_modified: Thu, 12 Mar 2026 22:15:24 GMT
-routing: manual
-stacks: [flutter]
-source: https://github.com/flutter/skills
-license: BSD-3-Clause
----
+> Adapted from the `flutter-building-forms` skill in [flutter/skills](https://github.com/flutter/skills) (BSD-3-Clause). See `THIRD_PARTY_NOTICES.md`.
+
 # Building Validated Forms
 
 ## Contents

package/skills/{flutter-adding-home-screen-widgets/SKILL.md → mobile-flutter/references/ui/home-screen-widgets.md}

@@ -1,14 +1,5 @@
----
-name: flutter-adding-home-screen-widgets
-description: Adds home screen widgets to a Flutter app for Android and iOS. Use when providing glanceable app information or quick actions on the device home screen.
-metadata:
-  model: models/gemini-3.1-pro-preview
-  last_modified: Thu, 12 Mar 2026 22:23:50 GMT
-routing: manual
-stacks: [flutter]
-source: https://github.com/flutter/skills
-license: BSD-3-Clause
----
+> Adapted from the `flutter-adding-home-screen-widgets` skill in [flutter/skills](https://github.com/flutter/skills) (BSD-3-Clause). See `THIRD_PARTY_NOTICES.md`.
+
 # Implementing Flutter Home Screen Widgets
 
 ## Contents

package/skills/{flutter-building-layouts/SKILL.md → mobile-flutter/references/ui/layouts.md}

@@ -1,14 +1,5 @@
----
-name: flutter-building-layouts
-description: Builds Flutter layouts using the constraint system and layout widgets. Use when creating or refining the UI structure of a Flutter application.
-metadata:
-  model: models/gemini-3.1-pro-preview
-  last_modified: Thu, 12 Mar 2026 22:14:15 GMT
-routing: manual
-stacks: [flutter]
-source: https://github.com/flutter/skills
-license: BSD-3-Clause
----
+> Adapted from the `flutter-building-layouts` skill in [flutter/skills](https://github.com/flutter/skills) (BSD-3-Clause). See `THIRD_PARTY_NOTICES.md`.
+
 # Architecting Flutter Layouts
 
 ## Contents

package/skills/{flutter-build-responsive-layout/SKILL.md → mobile-flutter/references/ui/responsive-layout.md}

@@ -1,14 +1,5 @@
----
-name: flutter-build-responsive-layout
-description: Use `LayoutBuilder`, `MediaQuery`, or `Expanded/Flexible` to create a layout that adapts to different screen sizes. Use when you need the UI to look good on both mobile and tablet/desktop form factors.
-metadata:
-  model: models/gemini-3.1-pro-preview
-  last_modified: Tue, 21 Apr 2026 20:17:40 GMT
-routing: manual
-stacks: [flutter]
-source: https://github.com/flutter/skills
-license: BSD-3-Clause
----
+> Adapted from the `flutter-build-responsive-layout` skill in [flutter/skills](https://github.com/flutter/skills) (BSD-3-Clause). See `THIRD_PARTY_NOTICES.md`.
+
 # Implementing Adaptive Layouts
 
 ## Contents

package/skills/{flutter-setup-declarative-routing/SKILL.md → mobile-flutter/references/ui/routing.md}

@@ -1,14 +1,5 @@
----
-name: flutter-setup-declarative-routing
-description: Configure `MaterialApp.router` using a package like `go_router` for advanced URL-based navigation. Use when developing web applications or mobile apps that require specific deep linking and browser history support.
-metadata:
-  model: models/gemini-3.1-pro-preview
-  last_modified: Tue, 21 Apr 2026 21:08:03 GMT
-routing: manual
-stacks: [flutter]
-source: https://github.com/flutter/skills
-license: BSD-3-Clause
----
+> Adapted from the `flutter-setup-declarative-routing` skill in [flutter/skills](https://github.com/flutter/skills) (BSD-3-Clause). See `THIRD_PARTY_NOTICES.md`.
+
 # Implementing Routing and Deep Linking
 
 ## Contents

package/skills/{flutter-theming-apps/SKILL.md → mobile-flutter/references/ui/theming.md}

@@ -1,14 +1,5 @@
----
-name: flutter-theming-apps
-description: Customizes the visual appearance of a Flutter app using the theming system. Use when defining global styles, colors, or typography for an application.
-metadata:
-  model: models/gemini-3.1-pro-preview
-  last_modified: Thu, 12 Mar 2026 22:14:47 GMT
-routing: manual
-stacks: [flutter]
-source: https://github.com/flutter/skills
-license: BSD-3-Clause
----
+> Adapted from the `flutter-theming-apps` skill in [flutter/skills](https://github.com/flutter/skills) (BSD-3-Clause). See `THIRD_PARTY_NOTICES.md`.
+
 # Implementing Flutter Theming and Adaptive Design
 
 ## Contents

package/skills/{flutter-add-widget-preview/SKILL.md → mobile-flutter/references/ui/widget-previews.md}

@@ -1,14 +1,5 @@
----
-name: flutter-add-widget-preview
-description: Adds interactive widget previews to the project using the previews.dart system. Use when creating new UI components or updating existing screens to ensure consistent design and interactive testing.
-metadata:
-  model: models/gemini-3.1-pro-preview
-  last_modified: Tue, 21 Apr 2026 20:05:23 GMT
-routing: manual
-stacks: [flutter]
-source: https://github.com/flutter/skills
-license: BSD-3-Clause
----
+> Adapted from the `flutter-add-widget-preview` skill in [flutter/skills](https://github.com/flutter/skills) (BSD-3-Clause). See `THIRD_PARTY_NOTICES.md`.
+
 # Previewing Flutter Widgets
 
 ## Contents

package/skills/mobile-flutter/references/ui.md

@@ -0,0 +1,14 @@
+# Flutter: UI, layout and navigation
+
+Layouts, forms, animations, theming, routing and widgets outside the app. Open only the guide the task needs.
+
+| Guide | What it covers |
+|---|---|
+| [layouts](ui/layouts.md) | Builds Flutter layouts using the constraint system and layout widgets. |
+| [responsive-layout](ui/responsive-layout.md) | Use `LayoutBuilder`, `MediaQuery`, or `Expanded/Flexible` to create a layout that adapts to different screen sizes. |
+| [forms](ui/forms.md) | Builds Flutter forms with validation and user input handling. |
+| [animations](ui/animations.md) | Implements animated effects, transitions, and motion in a Flutter app. |
+| [theming](ui/theming.md) | Customizes the visual appearance of a Flutter app using the theming system. |
+| [routing](ui/routing.md) | Configure `MaterialApp.router` using a package like `go_router` for advanced URL-based navigation. |
+| [widget-previews](ui/widget-previews.md) | Adds interactive widget previews to the project using the previews.dart system. |
+| [home-screen-widgets](ui/home-screen-widgets.md) | Adds home screen widgets to a Flutter app for Android and iOS. |

package/skills/mobile-ios/SKILL.md

@@ -0,0 +1,25 @@
+---
+name: mobile-ios
+description: Builds native iOS apps in Swift — SwiftUI and UIKit screens, state and data flow, NavigationStack, lists, forms and accessibility; networking with URLSession and Codable, persistence with SwiftData, Core Data, files and the Keychain; permissions, push notifications, universal links, background tasks, widgets, App Intents and StoreKit 2 purchases; performance with Instruments and MetricKit; and release with signing, TestFlight and App Store Connect. Use when writing or changing native iOS code, adding a platform feature, preparing a build for TestFlight or the App Store, or when the user asks how to do something on iOS, even if they do not name the framework.
+intents: [performance, release, accessibility]
+stacks: [ios]
+---
+
+# Mobile iOS
+
+Guides for building native iOS apps. Cross-platform topics live in their own skills and have iOS references there: architecture in `mobile-architecture`, tests in `mobile-test`, debugging (Xcode, CocoaPods, crashes) in `mobile-debug`, code review in `mobile-code-review`, security in `mobile-security` and Firebase in `mobile-firebase`.
+
+## Pick the topic
+
+| Topic | Read |
+|---|---|
+| SwiftUI and UIKit screens, navigation, lists, forms, accessibility, localization | [references/ui-navigation.md](references/ui-navigation.md) |
+| Networking, JSON, persistence, caching, offline | [references/data-networking.md](references/data-networking.md) |
+| Permissions, push, universal links, background work, widgets, App Intents, in-app purchases | [references/platform-features.md](references/platform-features.md) |
+| Performance, app size, signing, TestFlight and App Store release | [references/performance-release.md](references/performance-release.md) |
+
+## Before writing code
+
+- Check the deployment target (`IPHONEOS_DEPLOYMENT_TARGET`), the Swift language version and the Xcode version: many APIs in these guides need iOS 16 or 17, and Swift 6 changes concurrency checking.
+- Follow the project: SwiftUI or UIKit, its architecture, and dependencies already in `Package.resolved` or `Podfile.lock`.
+- Apple's requirements change every year (minimum SDK for uploads, privacy manifests, review guidelines); check the current ones instead of relying on these guides for dates or version numbers.

package/skills/mobile-ios/references/data-networking.md

@@ -0,0 +1,70 @@
+# iOS data and networking
+
+## HTTP with URLSession
+
+```swift
+struct APIClient {
+    let baseURL: URL
+    let session: URLSession = .shared
+    let decoder: JSONDecoder = {
+        let decoder = JSONDecoder()
+        decoder.keyDecodingStrategy = .convertFromSnakeCase
+        decoder.dateDecodingStrategy = .iso8601
+        return decoder
+    }()
+
+    func get<T: Decodable>(_ path: String, as type: T.Type = T.self) async throws -> T {
+        let (data, response) = try await session.data(from: baseURL.appending(path: path))
+        guard let http = response as? HTTPURLResponse, (200..<300).contains(http.statusCode) else {
+            throw APIError.badStatus((response as? HTTPURLResponse)?.statusCode ?? -1)
+        }
+        return try decoder.decode(T.self, from: data)
+    }
+}
+```
+
+The names are illustrative.
+
+- `URLSession` does not throw for 4xx/5xx responses: check the status code.
+- Async requests are cancelled when their `Task` is cancelled; SwiftUI's `.task` cancels when the view disappears.
+- Configure timeouts on a custom `URLSessionConfiguration` instead of relying on defaults for slow endpoints.
+- Decoding errors (`DecodingError`) should be logged with the key path; silently returning empty data hides API contract changes.
+- Large downloads and uploads that must continue when the app is suspended use a background `URLSessionConfiguration`.
+- Observe connectivity with `NWPathMonitor` to show offline state, but still handle request failures: reachability is only a hint.
+
+## Persistence
+
+| Data | Store |
+|---|---|
+| Secrets, tokens, credentials | Keychain |
+| Small preferences | `UserDefaults` (or `@AppStorage` in SwiftUI) |
+| Structured app data | SwiftData (iOS 17+) or Core Data |
+| Documents, media, caches | Files in Application Support, Documents or Caches, with the right Data Protection class |
+| HTTP response caching | `URLCache` with proper cache headers |
+
+### SwiftData
+
+```swift
+@Model
+final class Note {
+    var title: String
+    var createdAt: Date
+    init(title: String, createdAt: Date = .now) { self.title = title; self.createdAt = createdAt }
+}
+
+// App: .modelContainer(for: Note.self)
+// View: @Query(sort: \Note.createdAt, order: .reverse) private var notes: [Note]
+// Writes: @Environment(\.modelContext) private var context; context.insert(Note(title: "..."))
+```
+
+- Plan migrations (`VersionedSchema` and `SchemaMigrationPlan`) before shipping schema changes.
+- Model contexts are not shared across concurrency domains; use a `ModelActor` for background work.
+- Core Data projects keep Core Data unless there is a reason to migrate; both can coexist during a transition.
+
+## Offline-first
+
+Read from local storage, refresh from the network into it, and show the cached data while refreshing. Queue writes made offline and retry them with backoff; show pending state to the user.
+
+## Images
+
+`AsyncImage` has no persistent cache and decodes at full size. For feeds, use an image library the project already has, or downsample with ImageIO and cache the result.

package/skills/mobile-ios/references/performance-release.md

@@ -0,0 +1,37 @@
+# iOS performance and release
+
+## Measure before optimizing
+
+- **Instruments:** Time Profiler for CPU, Allocations and Leaks for memory, Hangs for main-thread blocks, the SwiftUI template for view updates. Profile a Release build on a device, not the simulator.
+- **In the field:** Xcode Organizer (launch time, hangs, memory, energy, disk writes) and MetricKit (`MXMetricManager`) for diagnostics from users' devices.
+
+## Common fixes
+
+- **Launch:** defer SDK initialization and data loading that the first screen does not need; avoid synchronous work in the `App` initializer or `application(_:didFinishLaunchingWithOptions:)`.
+- **Hangs:** move disk, network, JSON decoding and image decoding off the main actor.
+- **Scrolling:** stable identity in lists, no heavy work in `body` or `cellForItemAt`, downsampled images.
+- **Memory:** break retain cycles (`[weak self]`, weak delegates), bound in-memory caches and clear them on memory warnings.
+- **Size:** check the App Thinning size report from an archive export; keep images in asset catalogs, remove unused resources and dependencies.
+
+## Versioning and signing
+
+- `CFBundleShortVersionString` (Marketing Version) is the user-facing version; `CFBundleVersion` (build number) must increase for every upload of the same version.
+- Automatic signing is simplest for teams; CI usually uses manual signing or an App Store Connect API key with `xcodebuild -allowProvisioningUpdates`. Keep certificates and keys in the CI secret store, never in the repository.
+- Each extension (widgets, notification services) needs its own bundle identifier, prefixed by the app's, and a matching profile.
+
+## Build and upload
+
+```bash
+xcodebuild -scheme App -configuration Release -archivePath build/App.xcarchive archive
+xcodebuild -exportArchive -archivePath build/App.xcarchive -exportOptionsPlist ExportOptions.plist -exportPath build/export
+```
+
+- Upload with Xcode Organizer, Transporter, fastlane, or a tool based on the App Store Connect API; check which command-line upload method Apple currently supports before scripting it.
+- Keep dSYMs for crash symbolication (upload them to the crash reporter).
+
+## TestFlight and App Store
+
+- Internal testers (members of the App Store Connect team) get builds without review; external testers need a Beta App Review for the first build of a version.
+- Before submitting: screenshots and metadata, privacy details (the App Privacy section must match the privacy manifest and SDKs), export compliance (`ITSAppUsesNonExemptEncryption` in `Info.plist` avoids the question on each upload), sign-in credentials for the reviewer when the app requires an account, and account deletion in the app if it allows creating accounts.
+- Check the current App Store Review Guidelines and the minimum Xcode/SDK required for uploads; both change regularly.
+- Use phased release for updates to limit the impact of a bad build.