Awesome Android Agent Skills

Welcome to Awesome Android Agent Skills, a repository of specialized "brains" for your AI coding assistants. This project provides a suite of Agent Skills designed to supercharge GitHub Copilot, Claude, Google Gemini, Cursor and other agentic AI tools with expert knowledge of modern Android development.

Agent Skills are a standardized way to package capabilities, instructions, and best practices for AI agents. Instead of pasting the same prompt repeatedly ("How do I implement MVVM?", "Check this for accessibility"), you install these skills into your agent's environment.

When an agent detects you are working on a relevant task (e.g., "Create a verified repository"), it automatically loads the expert instructions from the corresponding SKILL.md file. This ensures:

• Consistency: The agent always follows your defined architecture.
• Accuracy: It uses the latest 2025 best practices (Compose, Hilt, Room).
• Efficiency: No need for long context-stuffing prompts.

Learn more at agentskills.io.

Skills reference each other and build on shared context. The Agent.md file is the foundation — every AI agent interacting with your project reads it implicitly to understand your project's architecture, minimum SDK, and testing philosophy before executing any specific tasks.

       ┌───────────────────────────────────────────┐
       │                  Agent.md                 │
       │     (read by all AI agents implicitly)    │
       └─────────────────────┬─────────────────────┘
                             │
     ┌───────────────┬───────┴───────┬───────────────┐
     ▼               ▼               ▼               ▼
┌──────────┐   ┌───────────┐   ┌────────────┐  ┌────────────┐
│ Architect│   │ UI & Nav  │   │ Migration  │  │ Automation │
├──────────┤   ├───────────┤   ├────────────┤  ├────────────┤
│viewmodel │   │compose-ui │   │rx-to-corout│  │testing     │
│data-layer│   │navigation │   │xml2compose │  │emulator    │
│clean-arch│   │coil-image │   │            │  │            │
└──────────┘   └───────────┘   └────────────┘  └────────────┘

These skills are categorized into domains in .github/skills/ to provide specialized instructions for compatible agents.

• Android Architecture - Expert guidance on Clean Architecture, Modularization, and Dependency Injection with Hilt.
• ViewModel & State - Proper implementation using StateFlow and SharedFlow.
• Data Layer & Offline-First - Repository Pattern with Room and Retrofit.

• Jetpack Compose UI - Best practices for stateless, performant Composables.
• Compose Navigation - Type-safe navigation, deep links, and nested graphs.
• Coil for Jetpack Compose - Expert guidance on image loading in Compose.
• Accessibility - Auditing content descriptions, touch targets, and contrast.

• XML to Compose Migration - Converting XML layouts to idiomatic Jetpack Compose.
• RxJava to Coroutines Migration - Migrating asynchronous code from RxJava to Coroutines and Flow.

• Compose Performance Audit - Identify recomposition storms and unstable keys.
• Gradle Build Performance - Debug and optimize Gradle/Android build times.

• Kotlin Concurrency Expert - Review and fix Kotlin Coroutines issues.
• Android Coroutines - Best practices for Coroutines execution and scopes.
• Retrofit Networking - Guidance on Retrofit, OkHttp, and Coroutines networking.

• Testing & Screenshots - Setup for Unit, Hilt, and Screenshot Testing.
• Android Emulator Automation - Essential production scripts for automation and semantic navigation.

• Gradle Build Logic - Setup Convention Plugins, Version Catalogs, and Composite Builds.

To equip your AI agent with these skills, you must place them in a location where the agent can discover them.

The industry standard location for agent skills is the .github/skills/ directory at the root of your workspace.

1. Copy Skills: Copy the .github/skills/ folder from this repository to your project's root.
2. Copy Context: Copy the Agent.md file from this repository to your project's root. This file ensures the agent always abides by your architecture and testing standards.
3. Verify: Ensure your project structure looks like this:

   my-android-project/
   ├── Agent.md
   ├── .github/
   │   └── skills/
   │       ├── architecture/
   │       │   ├── android-architecture/
   │       │   │   └── SKILL.md
   │       │   └── ...
   ├── app/
   └── ...
   

4. Restart: specific extensions (like Copilot) may need a window reload to index the new skills.

• Claude / Anthropic: Legacy or direct Claude usage often looks for .claude/skills/. You can copy or symlink .github/skills to .claude/skills.
• OpenCode: Supports .opencode/skill/ (note singular skill) and .claude/skills/. Global skills can be placed in ~/.config/opencode/skill/.

To add your own skill:

1. Create a new folder in .github/skills/ (e.g., my-custom-skill).
2. Add a SKILL.md file with the required frontmatter:

   ---
   name: my-custom-skill
   description: Description of what this skill does
   ---
   # Instructions
   ...

If this repository is part of your workspace, you can simply ask Copilot:

"How should I structure the new User Profile feature?" "Create a repository for fetching News with offline support."

Copilot will detect the relevant skill (e.g., android-architecture or android-data-layer) and apply the rules defined in the SKILL.md files.

You can also point any context-aware LLM (like ChatGPT or Claude) to the specific SKILL.md file you need help with.

"Read .github/skills/compose-ui/SKILL.md and then refactor this screen."

Android Development, Agent Skills, AI Coding Assistants, Jetpack Compose, Clean Architecture, MVVM, MVI, Hilt Dependency Injection, Room Database, Retrofit, Offline-First, Kotlin Coroutines, StateFlow, SharedFlow, Android Accessibility, Semantic Trees, Modularization, Mobile DevOps, GenAI for Mobile.

Original "Studio-Bot-Prompts-Handbook" content has been superseded by these executable Agent Skills.