android-agent-skills

Idiomatic Kotlin patterns for Android AI agents. Use this skill whenever writing Kotlin code for Android, especially: coroutines, Flow, StateFlow, SharedFlow, viewModelScope, lifecycleScope, Dispatchers, withContext, suspend functions, sealed classes, sealed interfaces, data classes, extension functions, scope functions (let, apply, also, run, with), null safety, !! operator, runCatching, Result, lazy, by delegate, stateIn, flatMapLatest, combine, error handling, structured concurrency, or any Kotlin-specific patterns. Always apply before writing coroutines, Flow chains, or data modeling code.

Material 3 Expressive components and theming for Android AI agents. Use this skill for any M3 component: TopAppBar, LargeTopAppBar, CenterAlignedTopAppBar, BottomAppBar, FAB, ExtendedFAB, NavigationBar, NavigationRail, NavigationDrawer, NavigationSuiteScaffold, ModalBottomSheet, Chip (Filter/Assist/Input/Suggestion), Badge, SegmentedButton, DatePicker, TimePicker, SearchBar, Slider, Switch, Checkbox, RadioButton, ListItem, Divider, ProgressIndicator, Snackbar, Tooltip, PullToRefreshBox, ExposedDropdownMenuBox, Card/ElevatedCard/OutlinedCard, shape morphing, MotionScheme, dynamic color, tonal elevation, surface containers, color roles, M3 migration from M2. Always apply when using any androidx.compose.material3 API.

Jetpack Compose animations for Android AI agents — M3 Expressive motion system. Use this skill for any animation: AnimatedVisibility, AnimatedContent, Crossfade, animate*AsState, animateColorAsState, animateDpAsState, animateFloatAsState, updateTransition, InfiniteTransition, rememberInfiniteTransition, spring physics, tween, keyframes, snap, M3 Expressive motion tokens, MotionScheme, animateItemPlacement, LazyList item animations, shared element transitions, SharedTransitionLayout, predictive back animation, shimmer loading skeleton screens, morphing shapes, gesture-driven animation, or any motion in Compose. Always apply when adding any animation — M3 Expressive replaced fixed easing curves with physics-based springs.

Jetpack Compose Navigation for Android AI agents. Use this skill whenever implementing navigation, NavHost, NavController, back stack, deep links, navigation arguments, routes, type-safe navigation, @Serializable routes, navController.navigate, popBackStack, navigateUp, bottom navigation, tab navigation, nested navigation graphs, shared ViewModels across destinations, navigation with Hilt, passing arguments between screens, transition animations between screens, or any navigation pattern. Always apply before writing any NavHost or navigation logic. Triggers on: navigate, NavController, NavHost, route, backstack, deep link, navigation argument, destination, composable(), navigation graph.

Adaptive UI for Android — responsive layouts for phones, tablets, foldables, Chromebooks, and large screens. Use this skill for EVERY screen you build. Triggers on: WindowSizeClass, ListDetailPaneScaffold, SupportingPaneScaffold, ThreePaneScaffold, NavigationSuiteScaffold, NavigationRail, NavigationDrawer, adaptive layout, responsive, tablet layout, foldable, FoldingFeature, two-pane, large screen, GridCells.Adaptive, WindowWidthSizeClass, WindowHeightSizeClass, landscape, Chromebook, bottom sheet to side sheet, dialog sizing, content width, LazyVerticalGrid, breakpoints, hinge, fold state. Apply to EVERY screen — AI agents without this produce phone-only apps on 1B+ large-screen Android devices.

Global-level design system for Android AI agents — Material 3 Expressive. Use this skill for visual consistency: spacing tokens, 8dp grid, M3 typography scale (15 styles), HCT color system, dynamic color Material You, shape system with morphing, motion tokens, physics-based spring animations, design tokens, AppButton/AppCard/AppTextField components, loading/error/empty states, dark mode, surface containers, tonal elevation, or when any two screens look visually different. Always apply when starting any new screen — without this skill AI agents produce apps where every screen looks designed by a different person. Apply immediately alongside compose-ui, material3, and adaptive-ui skills.

Supabase Kotlin SDK for Android AI agents. Use this skill whenever integrating Supabase in Android apps: supabase-kt setup, Auth (email/password, Google, phone OTP), UnauthorizedRestException fix, persistSession configuration, getUser(jwt) pattern, FunctionsHttpException, Edge Functions invocation, Realtime subscriptions, Postgres queries, Row Level Security, Supabase Storage file upload, sessionStatus Flow, verify_jwt in config.toml, @Serializable DTOs, decodeList, or any supabase-kt usage in Kotlin/Android.

Play Store release process for Android AI agents. Use this skill whenever preparing an Android app for Play Store submission, creating a release AAB, app signing, Play App Signing, version code management, release tracks (internal/alpha/beta/production), store listing requirements, content ratings, data safety form, target API level requirements, Play Store policies, APK vs AAB, deobfuscation files, ProGuard mappings, release notes, screenshots requirements, feature graphic, app icon requirements, or any Play Store publishing step. Always apply before any release build.

CI/CD pipeline for Android AI agents. Use this skill whenever setting up GitHub Actions for Android, automated testing in CI, APK/AAB build automation, Play Store deployment automation, Fastlane for Android, code quality checks in CI, lint in pipeline, unit test automation, instrumented test automation, Firebase Test Lab integration, code signing in CI, artifact upload, pull request checks, or any continuous integration/deployment for Android.

Gradle build system for Android AI agents. Use this skill whenever configuring Gradle, managing dependencies with Version Catalog, Gradle Kotlin DSL, Convention Plugins, composite builds, build variants, product flavors, build types, signing configs, Gradle properties, build optimization, configuration cache, parallel execution, dependency conflicts, version resolution, kapt vs KSP migration, buildSrc vs includeBuild, or any Gradle build issue. Triggers on: build.gradle.kts, libs.versions.toml, Gradle error, dependency, plugin, flavor, buildType, convention plugin, build speed.

Android accessibility for AI agents. Use this skill whenever implementing accessibility, TalkBack support, content descriptions, semantic properties, touch target sizes, contrast ratios, screen reader support, contentDescription, semantics modifier, clearAndSetSemantics, mergeDescendants, heading, stateDescription, traversalOrder, custom actions, live regions, accessibility service, WCAG compliance, accessibility audit, or any Compose accessibility. Required for Play Store submission in many markets. Always apply before shipping any screen.

Android app security for AI agents. Use this skill whenever implementing secure data storage, EncryptedSharedPreferences, EncryptedFile, Android Keystore, ProGuard/R8 code obfuscation, certificate pinning, network security config, root detection, SSL/TLS, token storage, preventing reverse engineering, securing API keys, BuildConfig secrets, environment variables, cleartext traffic, backup rules, screenshot prevention, overlay attack prevention, or any Android security hardening. Always apply when handling user credentials, payments, or PII.

Android app performance for AI agents. Use this skill whenever optimizing app performance, reducing recomposition, Compose stability, @Stable, @Immutable, skippable composables, baseline profiles, R8 optimization, lazy loading, image memory, Coil caching, RecyclerView vs LazyList performance, memory leaks, LeakCanary, ANR prevention, background work, Trace API, systrace, profiling, overdraw, rendering performance, startup time optimization, or any Android performance concern. Apply whenever a screen feels slow or laggy.

Android testing for AI agents. Use this skill whenever writing unit tests, integration tests, UI tests, ViewModel tests, Repository tests, DAO tests, Compose UI tests, Hilt testing, @HiltAndroidTest, TestCoroutineDispatcher, runTest, turbine Flow testing, MockK, Mockito, FakeRepository, Robolectric, Espresso, Compose testing semantics, screenshot tests, Roborazzi, JUnit 4/5, test doubles, test dispatchers, MainCoroutineRule, or any testing in Android. Always apply before writing any test class. Production apps require tests.

Biometric authentication for Android AI agents. Use this skill whenever implementing fingerprint authentication, face unlock, biometric login, BiometricPrompt, BiometricManager, CryptoObject, Keystore encryption with biometrics, Class 2 vs Class 3 biometrics, biometric availability check, fallback to PIN/pattern, secure credential storage, or any biometric/fingerprint/face authentication flow in Android.

Android notifications for AI agents. Use this skill whenever implementing push notifications, local notifications, notification channels, FCM (Firebase Cloud Messaging), notification styles (BigText, BigPicture, Inbox), notification actions, notification groups, notification importance, foreground services with notifications, notification permission (Android 13+), deep link from notification, PendingIntent, NotificationCompat, WorkManager notifications, or any notification in Android.

Android runtime permissions for AI agents. Use this skill whenever requesting permissions, handling permission results, camera permission, location permission, microphone permission, storage permission, contacts permission, notifications permission, Bluetooth permission, ActivityResultLauncher, requestPermissions, shouldShowRequestPermissionRationale, Accompanist Permissions, rememberPermissionState, rememberMultiplePermissionsState, permission denied handling, permission rationale dialog, or any runtime permission flow.

Firebase integration for Android AI agents. Use this skill whenever integrating Firebase Authentication, Firestore, Realtime Database, Firebase Storage, Firebase Analytics, Firebase Crashlytics, Firebase Messaging (FCM), Firebase Remote Config, Firebase App Check, google-services.json, Firebase SDK setup, BoM (Bill of Materials), Hilt Firebase injection, Firebase Auth with email/password/Google/phone, Firestore CRUD, Firestore real-time listeners, Firebase Collections, Documents, Queries, or any Firebase service in Android.

Offline-first architecture for Android AI agents. Use this skill whenever the app needs to work without internet, implementing cache-first strategy, local-first data, sync architecture, optimistic UI updates, conflict resolution, network connectivity monitoring, WorkManager background sync, retry logic, pending operations queue, stale-while-revalidate, or any pattern where local data is the source of truth and network data is synced. Triggers on: offline, cache, sync, local-first, network unavailable, background sync, WorkManager, ConnectivityManager, no internet, optimistic update.

DataStore (Preferences and Proto) for Android AI agents. Use this skill whenever storing user preferences, settings, small key-value data, replacing SharedPreferences, using DataStore Preferences, DataStore Proto, reading/writing Flow from DataStore, Hilt DataStore injection, migration from SharedPreferences, or any persistent lightweight data storage. Always apply when the task involves user settings, theme preferences, onboarding state, auth tokens (non-secure), feature flags, or any small persistent data that is not a database.

Retrofit HTTP networking for Android AI agents. Use this skill whenever implementing REST API calls, Retrofit service interfaces, OkHttp client, interceptors, authentication headers, API key injection, JWT tokens, @GET @POST @PUT @DELETE @PATCH annotations, @Query @Path @Body @Header @Field @Multipart, kotlinx.serialization, JSON parsing, error handling, network result wrapping, timeout configuration, certificate pinning, logging interceptor, mock API for testing, Hilt network module, base URL configuration, or any HTTP client networking in Android. Always apply before writing any Retrofit interface.

Room database for Android AI agents. Use this skill whenever implementing local data persistence with Room: @Entity, @Dao, @Database, @Query, @Insert, @Update, @Delete, @Upsert, TypeConverter, database migration, Room Flow queries, RoomDatabase.Builder, fallbackToDestructiveMigration, prepopulate, FTS (full-text search), database testing, Room with Hilt, embedded entities, foreign keys, indices, database inspector, or any Room/SQLite local storage. Always apply before writing any Room entity, DAO, or database class.

Hilt dependency injection for Android AI agents. Use this skill whenever setting up Hilt, writing @HiltViewModel, @AndroidEntryPoint, @HiltAndroidApp, @Module, @InstallIn, @Provides, @Binds, @Singleton, @ViewModelScoped, @ActivityScoped, @EntryPoint, @AssistedInject, @HiltWorker, @HiltAndroidTest, @BindValue, or debugging any Dagger/Hilt compile error. Also applies when choosing between @Provides vs @Binds, scoping dependencies, injecting into non-Hilt classes, or setting up Hilt for testing. Always use this skill before writing any @Module, @HiltViewModel, or @AndroidEntryPoint.

Android project initialization and environment setup for AI agents. Use this skill whenever starting a new Android project, setting up build files, configuring version catalogs, choosing SDK versions, setting up Kotlin DSL, or when the agent needs to know the project's base configuration. Triggers on: new Android project, build.gradle.kts, settings.gradle.kts, libs.versions.toml, version catalog, minSdk, targetSdk, compileSdk, KSP setup, project structure, Gradle Kotlin DSL, AndroidManifest, app module setup, multi-module init. Always use this skill before writing any build files or starting a new Android project.

MVVM + Clean Architecture + Unidirectional Data Flow patterns for Android AI agents. Use this skill whenever designing app structure, creating ViewModels, Repositories, UseCases, data classes, domain models, UiState, UiEvent, package structure, separation of concerns, data layer, domain layer, presentation layer, dependency inversion, multi-module architecture, or any discussion of how to organize Android code. Always apply before writing any ViewModel, Repository, or UseCase. Triggers on: ViewModel, Repository, UseCase, UiState, architecture, data layer, domain layer, Clean Architecture, MVVM, MVI, package structure, module structure.

Jetpack Compose UI best practices for AI agents building Android apps. Use this skill whenever writing any Composable function, building screens, handling UI state, working with Scaffold, LazyColumn, ModalBottomSheet, BottomSheet, edge-to-edge, IME keyboard insets, recomposition, side effects, LaunchedEffect, DisposableEffect, remember, collectAsStateWithLifecycle, StateFlow, SharedFlow, UiState, loading/error/empty states, accessibility semantics, Material 3 components, Coil images, TextField, animations, modifiers, or any Compose layout. Always apply this skill before writing any @Composable function.

Material 3 design system foundation for Android apps. Use this skill for ANY theming, color, spacing, shape, or elevation work — MaterialTheme, colorScheme, ColorScheme roles, lightColorScheme, darkColorScheme, dynamicColorScheme, primary/secondary/tertiary/surface/background tokens, onSurface, onBackground, surfaceContainer, outline, spacing scale, 4dp grid, shape tokens, RoundedCornerShape, Shapes, elevation, tonalElevation, shadowElevation, dark mode, isSystemInDarkTheme, Material You, dynamic color, brand colors, semantic colors, Theme.kt, Color.kt. Applies to ALL app categories: fintech, edtech, healthtech, ecommerce, social, proptech, enterprise, productivity, entertainment, food, travel.