android-clean-architecture

Implement Clean Architecture patterns for Android and Kotlin Multiplatform projects.

Updated Jul 27, 2026
One-click install
npx skills add https://github.com/kouiso/designdiff --skill android-clean-architecture-kouiso
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: android-clean-architecture
Source: https://github.com/kouiso/designdiff/tree/main/.claude/skills/android-clean-architecture
Command: npx skills add https://github.com/kouiso/designdiff --skill android-clean-architecture-kouiso

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides a robust framework for structuring Android and Kotlin Multiplatform (KMP) projects, ensuring maintainability, testability, and scalability through Clean Architecture principles.

Core Features & Use Cases

  • Modular Project Structure: Defines clear boundaries and dependency rules for modules like domain, data, presentation, and core.
  • Layered Architecture Implementation: Guides the implementation of UseCases, Repositories, DataSources, and domain models.
  • Data Layer Integration: Demonstrates integration with Room (Android), SQLDelight (KMP), and Ktor (KMP) for data persistence and networking.
  • Dependency Injection: Shows setup with Koin and Hilt.
  • Use Case: Structuring a new Android app from scratch, refactoring an existing project to follow Clean Architecture, or implementing specific layers like the domain or data layer.

Quick Start

Apply the recommended module structure and dependency rules to your Android or KMP project.

Frequently Asked Questions about android-clean-architecture

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I structure an Android app using Clean Architecture?

Structure an Android app using Clean Architecture by dividing it into domain, data, presentation, and core modules with strict dependency rules. This framework defines clear boundaries for UseCases, Repositories, and DataSources to ensure maintainability and testability.

What is the best way to implement Clean Architecture in Kotlin Multiplatform projects?

The best way to implement Clean Architecture in KMP projects is by defining module structures and dependency rules that separate domain logic from platform-specific code. This approach uses SQLDelight for data persistence and Ktor for networking across shared modules.

Can I use Hilt and Koin for dependency injection in a Clean Architecture Android app?

Yes, you can use Hilt and Koin for dependency injection in a Clean Architecture Android app. This framework demonstrates setup with both Koin and Hilt to manage dependencies across your layered modules effectively.

How should I handle errors in UseCases and Repositories with Clean Architecture?

Handle errors in UseCases and Repositories using Result or Try patterns. This approach encapsulates exceptions and failures within the domain and data layers, ensuring predictable error propagation without crashing the application.

Does this Clean Architecture framework support both Room and SQLDelight for local data persistence?

Yes, this Clean Architecture framework supports both Room and SQLDelight for local data persistence. It demonstrates data layer integration using Room for standard Android projects and SQLDelight for Kotlin Multiplatform projects.