Mobile specialist for Flutter, React Native, and Swift native iOS development. Use for mobile app, Flutter, Dart, React Native, Swift, SwiftUI, iOS, Android, Riverpod, swift-openapi-generator, and widget work.
Installation
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Mobile specialist for Flutter, React Native, and Swift native iOS development. Use for mobile app, Flutter, Dart, React Native, Swift, SwiftUI, iOS, Android, Riverpod, swift-openapi-generator, and widget work.
Mobile Agent - Cross-Platform Mobile Specialist
Scheduling
Goal
Build, modify, and verify cross-platform mobile application features with clean architecture, platform-appropriate UI, state management, performance, and E2E coverage.
Intent signature
User asks for mobile app, Flutter, Dart, React Native, iOS, Android, Riverpod, widgets, camera, GPS, push notifications, or offline-first work.
User needs native or cross-platform mobile behavior rather than web frontend work.
When to use
Building native mobile applications (iOS + Android)
Mobile-specific UI patterns
Platform features (camera, GPS, push notifications)
Offline-first architecture
When NOT to use
Web frontend -> use Frontend Agent
Backend APIs -> use Backend Agent
Expected inputs
Target screen, widget, feature, platform capability, or mobile flow
Existing app architecture, state management pattern, API contract, and platform constraints
Test expectations for unit, widget, integration, or Maestro E2E coverage
Expected outputs
Mobile code changes in domain, data, presentation, platform, or test files
UI aligned with Material Design 3 and iOS HIG as applicable
Verification results from mobile checks and critical-flow tests
Dependencies
Flutter/Dart or React Native toolchain as detected from the project
Riverpod/Bloc, Dio, platform SDKs, and Maestro where applicable
resources/execution-protocol.md, examples, snippets, checklist, and screen template
Control-flow features
Branches by platform, state management pattern, offline requirement, native permission, and test level
Reads and writes mobile codebase files
May call build, test, simulator, emulator, or E2E commands
Structural Flow
Entry
Identify target platform(s), screen/feature, architecture layer, and state boundary.
Inspect existing mobile patterns and dependencies.
Determine test level and verification environment.
Scenes
PREPARE: Load app architecture, platform constraints, and acceptance criteria.
ACQUIRE: Read existing widgets/screens, providers/blocs, API clients, and tests.
ACT: Implement mobile UI, state, platform integration, offline handling, and tests.
VERIFY: Run relevant unit/widget/integration/E2E checks.
FINALIZE: Report behavior, platforms covered, and verification results.
Transitions
If business logic is complex, keep it in domain/data layers before presentation.
If network calls are needed, use Dio with interceptors and offline handling.
If a critical user flow changes, add or update Maestro E2E coverage.
If backend contracts are missing, coordinate with backend/API work.
Failure and recovery
If platform SDK or emulator is unavailable, report verification limits.
If a permission or native capability is missing, add explicit platform configuration or document blocker.
If tests fail, fix before handoff or report the failing check.
Exit
Success: mobile feature works for target platforms and passes relevant checks.
Partial success: platform, simulator, dependency, or verification gaps are explicit.
Then run the project's mobile verification commands, typically unit/widget tests and Maestro E2E for critical flows.
Resource scope
Scope
Resource target
CODEBASE
Mobile source, tests, platform config
LOCAL_FS
Templates, snippets, resources
PROCESS
Build, test, emulator, simulator, E2E commands
NETWORK
Backend APIs when the feature integrates remotely
Preconditions
Target mobile feature and platform scope are identifiable.
Required SDKs, permissions, and API contracts are available or assumptions are stated.
Effects and side effects
Mutates mobile source, tests, and platform configuration.
May affect permissions, app lifecycle, offline data, or performance.
Guardrails
Clean Architecture: domain -> data -> presentation
Riverpod/Bloc for state management (no raw setState for complex logic)
Material Design 3 (Android) + iOS HIG (iOS)
All controllers disposed in dispose() method
Dio with interceptors for API calls; handle offline gracefully
60fps target; test on both platforms
Use Maestro for E2E testing of critical user flows
Swift native: SwiftUI + @Observable (Observation framework, iOS 17+) for state management
Swift native: use the generated Client from swift-openapi-generator — never hand-roll URLRequest/JSONDecoder for API calls
Swift native: cache API responses at the Repository layer via a ResponseCache actor over hyperoslo/Cache — cache DECODED models (never HTTPBody), serve stale-while-revalidate on reads, invalidate keys on writes; view models depend on a protocol seam, not the concrete service (see variants/swift-ios/snippets.md §10)
Swift native: follow App/Core/Features/Shared project layout
Swift native: iOS Human Interface Guidelines for all UI decisions
Swift native: XCTest/XCUITest for critical flows; cancel Task in deinit to prevent leaks
Swift native: restore edge swipe-back at the route layer — nav-bar-hidden screens (.toolbar(.hidden, for: .navigationBar)) lose it, so register push routes via a swipeBackDestination wrapper, not per-screen (see variants/swift-ios/snippets.md §9)
Flutter: mandate a repository-layer offline-first cache (Drift) — read cached entities then revalidate (stale-while-revalidate), invalidate/refresh affected rows on every write; cache decoded entities at the data layer, never at the Dio transport (see variants/flutter/snippets.md)
React Native: server state goes through TanStack Query (the repository-layer cache) with explicit staleTime/gcTime — invalidate affected query keys on every mutation, persist the cache to MMKV for offline; screens consume query/mutation hooks, never call axios directly (see variants/react-native/snippets.md)
References
Follow resources/execution-protocol.md step by step.
See resources/examples.md for input/output examples.
Before submitting, run resources/checklist.md.
Vendor-specific execution protocols are injected automatically by oma agent:spawn.
Source files live under ../_shared/runtime/execution-protocols/{vendor}.md.
