This repository provides standardized "Agent Skills" to enhance AI coding assistants like GitHub Copilot, Claude, and Gemini with expert knowledge in modern Android development. It addresses the challenge of consistently applying best practices in complex projects by packaging instructions and capabilities into reusable modules. Developers benefit from improved accuracy, efficiency, and adherence to architectural standards without repetitive prompt engineering.

How It Works

Agent Skills are packaged as SKILL.md files, containing instructions and best practices for specific development tasks. Compatible AI agents automatically detect and load these skills from designated project directories (e.g., .github/skills/). This mechanism ensures AI assistants consistently apply predefined architectures (like Clean Architecture, Hilt) and coding standards (Compose, Room, Retrofit) directly within the development workflow, streamlining complex tasks and reducing context-stuffing.

Quick Start & Requirements

To integrate these skills, copy the .github/skills/ folder from this repository into your project's root directory. AI extensions may require a window reload to index the new skills. For alternative environments, skills can be placed in .claude/skills/ or .opencode/skill/. Further details are available at agentskills.io.

Highlighted Details

• Android Architecture: Expertise in Clean Architecture, Modularization, and Hilt for strict layer separation.
• Jetpack Compose: Best practices for UI development, state management, theming, and performance.
• Data Layer: Implements Repository Pattern with Room/Retrofit for robust offline-first synchronization.
• Accessibility: Rigorous checklist for Content Descriptions, Touch Targets, and Contrast.
• Build Systems: Guidance on Gradle Convention Plugins, Version Catalogs, and build performance optimization.
• Testing: Support for Unit, Hilt, and Screenshot Testing (Roborazzi).
• Concurrency & Networking: Expert handling of Kotlin Coroutines and Retrofit/OkHttp.
• Migration: Tools for converting XML layouts to Jetpack Compose.
• Navigation: Type-safe navigation with Navigation Compose.

Maintenance & Community

The provided README does not detail specific maintainers, community channels (e.g., Discord, Slack), sponsorships, or a public roadmap, limiting visibility into project health and support structures.

Licensing & Compatibility

Crucially, the project's license is not explicitly stated in the README. This omission presents a significant adoption blocker, creating uncertainty regarding commercial use, derivative works, and integration compatibility with closed-source projects.

Limitations & Caveats

The core functionality relies heavily on the AI agent's compatibility and ability to correctly interpret and apply the SKILL.md files. The absence of a stated license is a major caveat for adoption. The project also supersedes older prompt-based resources, indicating a potential shift in recommended AI interaction patterns.