Android / KMP Architecture Skills (philipp-android-skills)
This package is a router for the specialized skills in its subdirectories. Do not treat this file as a replacement for their detailed conventions.
Workflow
- Identify the requested layers or concerns.
- Read the matching child
SKILL.mdfile or files before responding or editing code. - Apply every relevant skill together. For example, a new feature commonly needs module structure, presentation MVI, navigation, DI, data layer, error handling, and unit testing.
- Follow the child skills' guidance if it conflicts with a generic Android convention.
Skill selection
| Concern | Read |
|---|---|
| Project setup, Gradle conventions, module boundaries, feature layout | android-module-structure/SKILL.md |
| Repository/data-source design, DTOs, Room, Ktor, mappers, offline-first | android-data-layer/SKILL.md |
Typed Result values, DataError, mapping success or failure |
android-error-handling/SKILL.md |
Screen state, ViewModels, actions, events, Root/Screen composables, SavedStateHandle |
android-presentation-mvi/SKILL.md |
| Reusable or extracted Compose components, design-system UI, previews | android-compose-components/SKILL.md |
| Type-safe Compose routes, feature graphs, cross-feature navigation | android-navigation/SKILL.md |
| Koin modules, dependency scopes, ViewModel injection, app wiring | android-di-koin/SKILL.md |
| In-process tests for ViewModels, use cases, reducers, validators, mappers, or formatters | android-unit-testing/SKILL.md |
| Adding or maintaining a reviewer quiz for a GitHub pull request | pr-quiz/SKILL.md |
Common combinations
- New feature:
android-module-structure,android-presentation-mvi,android-navigation,android-di-koin, andandroid-unit-testing; addandroid-data-layerandandroid-error-handlingwhen the feature persists or fetches data. - New screen:
android-presentation-mvi,android-navigation,android-compose-components, andandroid-unit-testingas applicable. - New repository or API/Room integration:
android-data-layer,android-error-handling,android-di-koin, andandroid-unit-testing. - Shared Compose control:
android-compose-components; also readandroid-presentation-mvionly when the work affects a Root or Screen composable.
Package layout
Keep this root SKILL.md beside the child skill folders. Install or copy the entire philipp-android-skills directory as one skill package so the relative paths above remain valid.
