[WIP] Android Development Skill for Claude Code

A production-ready skill that enables Claude Code to build Android applications following Google's official architecture guidance and best practices from the NowInAndroid reference app.

Overview

This skill provides Claude with comprehensive knowledge of modern Android development patterns, including:

• Clean Architecture with UI, Domain, and Data layers
• Jetpack Compose patterns and best practices
• Multi-module project structure with convention plugins
• Offline-first architecture with Room and reactive streams
• Dependency injection with Hilt
• Comprehensive testing strategies

Installation

1. Clone this repository into your Claude Code skills directory:

   git clone https://github.com/dpconde/claude-android-skill.git
   

2. Claude Code will automatically detect and load the skill when you work on Android projects.

Usage

The skill automatically activates when you request Android-related tasks. Simply ask Claude to:

• "Create a new Android feature module for user settings"
• "Build a Compose screen with MVVM pattern"
• "Set up a Repository with offline-first architecture"
• "Add navigation to my Android app"
• "Configure multi-module Gradle setup"

Claude will follow the patterns and best practices defined in this skill.

Project Structure

claude-android-skill/
├── SKILL.md                    # Main skill definition and quick reference
├── references/                 # Detailed documentation
│   ├── architecture.md         # UI, Domain, Data layers patterns
│   ├── compose-patterns.md     # Jetpack Compose best practices
│   ├── gradle-setup.md         # Build configuration & convention plugins
│   ├── modularization.md       # Multi-module project structure
│   └── testing.md              # Testing strategies and patterns
├── assets/
│   └── templates/              # Project templates
│       ├── libs.versions.toml.template
│       └── settings.gradle.kts.template
└── scripts/
    └── generate_feature.py     # Feature module generator script

Core Principles

This skill teaches Claude to follow these key Android development principles:

1. Offline-first: Local database as source of truth, synchronized with remote data
2. Unidirectional data flow: Events flow down, data flows up (UDF pattern)
3. Reactive streams: Use Kotlin Flow for all data exposure
4. Modular by feature: Each feature is self-contained with clear API boundaries
5. Testable by design: Use interfaces and test doubles, avoid mocking frameworks

Reference Documentation

Quick Navigation

| Topic | File | Description | |-------|------|-------------| | Architecture | architecture.md | MVVM pattern, layers, repositories, use cases | | Compose UI | compose-patterns.md | Screens, state hoisting, side effects, theming | | Build Setup | gradle-setup.md | Convention plugins, version catalogs, configuration | | Modularization | modularization.md | Module types, dependencies, feature structure | | Testing | testing.md | Unit tests, UI tests, test doubles, strategies |

Architecture Overview

┌─────────────────────────────────────────┐
│              UI Layer                    │
│  (Compose Screens + ViewModels)          │
├─────────────────────────────────────────┤
│           Domain Layer                   │
│  (Use Cases - optional, for reuse)       │
├─────────────────────────────────────────┤
│            Data Layer                    │
│  (Repositories + DataSources)            │
└─────────────────────────────────────────┘

Module Types

app/                    # Application module
feature/
  ├── featurename/
  │   ├── api/          # Public navigation contracts
  │   └── impl/         # Internal implementation
core/
  ├── data/             # Repositories
  ├── database/         # Room DAOs & entities
  ├── network/          # Retrofit & API models
  ├── model/            # Domain models
  ├── ui/               # Reusable components
  ├── designsystem/     # Theme & design tokens
  └── testing/          # Test utilities

Features

Code Generation

The skill includes a Python script to generate feature modules:

python scripts/generate_feature.py settings \
  --package com.example.app \
  --path /path/to/project

This creates a complete feature module with:

• API module with navigation definitions
• Implementation module with Screen, ViewModel, UiState
• Gradle build files with proper dependencies
• Hilt dependency injection setup

Templates

Pre-configured templates for common Android project files:

• libs.versions.toml.template - Gradle version catalog
• settings.gradle.kts.template - Project settings

Standard Patterns

ViewModel Pattern

@HiltViewModel
class MyFeatureViewModel @Inject constructor(
    private val repository: MyRepository,
) : ViewModel() {
    val uiState: StateFlow<MyFeatureUiState> = repository
        .getData()
        .map { MyFeatureUiState.Success(it) }
        .stateIn(
            scope = viewModelScope,
            started = SharingStarted.WhileSubscribed(5_000),
            initialValue = MyFeatureUiState.Loading,
        )
}

Screen Pattern

@Composable
internal fun MyFeatureRoute(
    viewModel: MyFeatureViewModel = hiltViewModel(),
) {
    val uiState by viewModel.uiState.collectAsStateWithLifecycle()
    MyFeatureScreen(uiState = uiState)
}

Repository Pattern

interface MyRepository {
    fun getData(): Flow<List<MyModel>>
}

internal class OfflineFirstMyRepository @Inject constructor(
    private val dao: MyDao,
    private val api: MyNetworkApi,
) : MyRepository {
    override fun getData(): Flow<List<MyModel>> =
        dao.getAll().map { it.toModel() }
}

Technology Stack

This skill configures projects with:

• Language: Kotlin
• UI: Jetpack Compose
• Architecture: MVVM with UDF
• DI: Hilt
• Database: Room
• Network: Retrofit + Kotlinx Serialization
• Async: Kotlin Coroutines + Flow
• Testing: JUnit, Turbine, Compose Testing
• Build: Gradle with Convention Plugins

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

Based on patterns and practices from:

• NowInAndroid by Google
• Android Architecture Guidelines
• Jetpack Compose Best Practices

Resources

• Android Developer Documentation
• NowInAndroid Repository
• Kotlin Documentation
• Jetpack Compose Pathway