Android Development Skill

Production-ready Android development with Kotlin 2.0+, Jetpack Compose, and modern architecture patterns.

When Active

Use when building Android features, UI components, or platform-specific functionality. Auto-activated for:

• Kotlin files (.kt, .kts)
• Android project structure (build.gradle.kts, AndroidManifest.xml)
• Android commands (/cook android, /test android)

Quick Start Templates

Build Configuration

• build-gradle-app.kts - App module with Compose, Hilt, Room, Retrofit
• build-gradle-lib.kts - Library module for shared code

UI Components

• compose-screen-template.kt - Complete screen with loading/error/success states
• navigation-template.kt - Type-safe Navigation with nested graphs

Architecture

• viewmodel-template.kt - ViewModel with StateFlow and error handling
• hilt-module-template.kt - Dependency injection setup

Data Layer

• room-entity-dao-template.kt - Database with migrations
• retrofit-service-template.kt - API service with error handling

Architecture Patterns

MVVM Pattern

Reference: mvvm-architecture.md

Layer responsibilities:

• UI Layer: Composables collect state, emit user actions
• ViewModel Layer: Holds StateFlow, processes actions, calls repositories
• Domain Layer: Business logic, use cases, domain models
• Data Layer: Repository implementations, Room, Retrofit

// Example Flow
User clicks button
    ↓
Composable calls ViewModel function
    ↓
ViewModel updates StateFlow
    ↓
Composable recomposes with new state

Compose Best Practices

Reference: compose-best-practices.md

Key concepts:

• State Hoisting: Move state up, pass down callbacks
• Recomposition: Use remember, derivedStateOf, keys in lists
• Side Effects: LaunchedEffect, DisposableEffect, rememberCoroutineScope
• Modifiers: Order matters, always accept Modifier parameter

Error Handling

Reference: error-handling.md

Patterns:

• Result Wrapper: Sealed class for Success/Error/Loading
• Custom Exceptions: Domain-specific error types
• User Messages: Convert exceptions to friendly text
• Retry Logic: Exponential backoff for network errors
• Validation: Form validation with detailed errors

Test Examples

Unit Tests

• viewmodel-test-example.kt - Test ViewModels with Turbine
• repository-test-example.kt - Test repositories with fakes/mocks

UI Tests

• compose-ui-test-example.kt - Compose testing with semantics

Testing patterns:

• Use runTest for coroutine tests
• Use Turbine for Flow assertions
• Use MockK for mocking
• Use Fake implementations for complex dependencies
• Test state transitions, not implementation

Tech Stack

Core (Required)

• Language: Kotlin 2.0+
• Min SDK: Android 7.0+ (API 24)
• Target SDK: Android 14+ (API 34)
• UI: Jetpack Compose + Material 3
• Architecture: MVVM with ViewModel + StateFlow

Jetpack Libraries

• Compose: UI toolkit (BOM for version management)
• Navigation: Type-safe navigation with Compose
• ViewModel: Lifecycle-aware state management
• Room: Local database with Flow
• Hilt: Dependency injection

Networking & Serialization

• Retrofit: HTTP client
• OkHttp: Networking layer with interceptors
• Kotlinx Serialization: JSON serialization (preferred over Gson)

Concurrency

• Coroutines: Structured concurrency
• Flow: Reactive streams

Testing

• JUnit: Unit testing framework
• MockK: Kotlin mocking library
• Turbine: Flow testing assertions
• Compose Testing: UI testing with semantics
• Espresso: Android UI testing (if needed)

Usage Instructions & Version Compatibility

See references/usage-and-compatibility.md for step-by-step setup guides (project, features, database, API, error handling, tests) and version compatibility matrix.

Best Practices

1. Keep files under 200 lines - Split large files into smaller modules
2. Use sealed interfaces for state - Type-safe state representation
3. Hoist state appropriately - Balance reusability and simplicity
4. Provide keys in lazy lists - Optimize recomposition
5. Use Flow for reactive data - Observe database changes efficiently
6. Map DTOs to domain models - Keep layers isolated
7. Handle errors gracefully - Always provide user-friendly messages
8. Test each layer independently - Mock dependencies appropriately
9. Use Material 3 design - Follow system theme and dynamic colors
10. Optimize for performance - Profile with Android Studio Profiler, minimize recomposition

Common Patterns

ViewModel with Flow

@HiltViewModel
class MyViewModel @Inject constructor(
    private val repository: MyRepository
) : ViewModel() {
    val uiState: StateFlow<UiState> = repository.observeData()
        .map { data -> UiState.Success(data) }
        .catch { emit(UiState.Error(it.message ?: "Error")) }
        .stateIn(
            scope = viewModelScope,
            started = SharingStarted.WhileSubscribed(5000),
            initialValue = UiState.Loading
        )
}

Compose with State Collection

@Composable
fun MyScreen(viewModel: MyViewModel = hiltViewModel()) {
    val uiState by viewModel.uiState.collectAsStateWithLifecycle()

    when (val state = uiState) {
        is UiState.Loading -> LoadingView()
        is UiState.Success -> SuccessView(state.data)
        is UiState.Error -> ErrorView(state.message)
    }
}

Repository with Caching

class MyRepository @Inject constructor(
    private val api: ApiService,
    private val dao: MyDao
) {
    fun observeData(): Flow<List<Item>> = dao.observeAll()

    suspend fun refresh() {
        val items = api.fetchItems()
        dao.insertAll(items)
    }
}

References

• Android Developer Docs
• Kotlin Coroutines Guide
• Jetpack Compose
• Material 3 Design
• Now in Android Sample

Build Commands

./gradlew assembleDebug       # Build debug APK
./gradlew installDebug        # Install on device
./gradlew build               # Full build with tests
./gradlew test                # Run unit tests
./gradlew connectedAndroidTest # Run instrumentation tests
./gradlew jacocoTestReport    # Generate coverage report
./gradlew lint                # Run Android linter
./gradlew ktlintCheck         # Run Kotlin linter

Coverage Goals

• Minimum: 80% overall coverage
• ViewModels: 90%+ (business logic)
• Utilities: 95%+ (pure functions)
• UI: 70%+ (composables)

Sub-Skill Routing

When this skill is active and user intent matches a sub-skill, delegate:

Rules

• Use StateFlow, not LiveData for state management
• Coroutines for async operations and Flow for data streams
• Jetpack Compose for all UI (no XML layouts)
• Use MockK for mocking in tests
• Keep composables small and focused
• Use Material 3 design system
• Support both light and dark themes