Claude MD Example for Android Kotlin Project

# Skill Name

## Description
Brief description of what this skill does.

## When to Use
Situations where this skill applies.

## Guidelines
- Specific instruction 1
- Specific instruction 2

# android-kotlin

## Description
Guides Claude through Android Kotlin development following Clean Architecture and MVVM patterns.

## When to Use
- Creating new screens or features
- Implementing ViewModels and UI state management
- Setting up dependency injection with Hilt
- Working with Room database
- Implementing Compose UI components

## Guidelines

### Project Structure
- Follow Clean Architecture: ui → domain → data layers
- Place ViewModels in ui layer with state hoisting
- Use repository pattern for data access
- Keep domain layer free of Android dependencies

### Kotlin Conventions
- Use data classes for DTOs and models
- Implement sealed classes for UI state and events
- Prefer immutable state with Kotlin Flow
- Use coroutines for async operations with proper scope management

### Jetpack Compose
- Use remember and mutableStateOf for local UI state
- Implement unidirectional data flow
- Create reusable composable functions
- Follow Material Design 3 guidelines

### Dependency Injection
- Use Hilt for dependency injection
- Inject repositories into ViewModels
- Provide use cases through Hilt modules
- Avoid manual dependency creation

### Testing
- Use the tdd skill for test-first development
- Write unit tests for ViewModels using Turbine
- Test use cases with mock repositories
- Use composeUITest for UI testing

# compose-ui

## Description
Guides Jetpack Compose UI development with Material Design 3 and state management best practices.

## When to Use
- Building new Compose screens
- Creating reusable UI components
- Implementing navigation with Compose Navigation
- Handling user input and form validation

## Guidelines

### UI Components
- Create small, focused composable functions
- Use modifiers consistently for styling and layout
- Follow single responsibility principle for components
- Extract repeated patterns into shared components

### State Management
- Use remember and mutableStateOf for local state
- Hoist state to the lowest common ancestor
- Use collectAsState with Flow in ViewModels
- Implement rememberSaveable for UI state survival

### Material Design 3
- Use M3 color schemes and typography
- Implement proper accessibility with contentDescription
- Use appropriate touch targets (48dp minimum)
- Follow spacing and padding guidelines

### Navigation
- Use Compose Navigation for screen transitions
- Define type-safe arguments
- Handle deep links properly
- Pass data through navigation arguments or ViewModel

# android-room

## Description
Guides Room database operations with migrations and query optimization.

## When to Use
- Creating new entities and DAOs
- Writing complex queries
- Handling database migrations
- Implementing repository pattern with Room

## Guidelines

### Entities
- Use @Entity annotations with proper column names
- Define primary keys appropriately
- Use TypeConverters for complex types
- Implement relation annotations for relationships

### DAOs
- Write type-safe queries with @Query annotation
- Use suspend functions for async operations
- Return Flow for reactive data updates
- Implement proper transaction handling

### Migrations
- Always create migration scripts for schema changes
- Test migrations on copy of production data
- Use destructive migrations only in development
- Keep migration files versioned

### Repository Pattern
- Abstract data sources through repositories
- Handle offline-first scenarios
- Implement proper error handling
- Use WorkManager for background sync