coil-compose

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](https://agentskills.io).

These skills are located in .github/skills/ and are ready for use by compatible agents (like GitHub Copilot Workspace or custom Claude environments).

• [Android Architecture](.github/skills/android-architecture/SKILL.md) (android-architecture)

* Expert guidance on Clean Architecture, Modularization, and Dependency Injection with Hilt.

* Ensures strict separation of UI, Domain, and Data layers.

• [Jetpack Compose UI](.github/skills/compose-ui/SKILL.md) (compose-ui)

* Best practices for building stateless, performant Composables.

* Focuses on State Hoisting, Modifiers order, and Theming.

• [ViewModel & State](.github/skills/android-viewmodel/SKILL.md) (android-viewmodel)

* Proper implementation of ViewModel using StateFlow for UI state and SharedFlow for one-off events.

* Avoids common pitfalls with channel usage and lifecycle collection.

• [Data Layer & Offline-First](.github/skills/android-data-layer/SKILL.md) (android-data-layer)

* Implements the Repository Pattern with Room (local) and Retrofit (remote).

* Guides the agent to build robust Offline-First synchronization logic.

• [Accessibility](.github/skills/android-accessibility/SKILL.md) (android-accessibility)

* A rigorous checklist for auditing Content Descriptions, Touch Targets, and Contrast.

* Ensures your app is usable by everyone.

• [Gradle Build Logic](.github/skills/android-gradle-logic/SKILL.md) (android-gradle-logic)

* Set up Convention Plugins, Version Catalogs, and Composite Builds.

* Configure build-logic like a pro to share configurations across modules.

• [Testing & Screenshots](.github/skills/android-testing/SKILL.md) (android-testing)

* Setup for Unit, Hilt, and Screenshot Testing (Roborazzi).

* Ensures a reliable testing pyramid with standard libraries.

• [Kotlin Concurrency Expert](.github/skills/kotlin-concurrency-expert/SKILL.md) (kotlin-concurrency-expert)

* Review and fix Kotlin Coroutines issues with triage-based workflow.

* Covers structured concurrency, lifecycle safety, and exception handling.

• [Compose Performance Audit](.github/skills/compose-performance-audit/SKILL.md) (compose-performance-audit)

* Audit and optimize Jetpack Compose runtime performance.

* Identifies recomposition storms, unstable keys, and heavy composition work.

• [XML to Compose Migration](.github/skills/xml-to-compose-migration/SKILL.md) (xml-to-compose-migration)

* Convert XML layouts to idiomatic Jetpack Compose.

* Comprehensive mapping tables for layouts, widgets, and attributes.

• [Compose Navigation](.github/skills/compose-navigation/SKILL.md) (compose-navigation)

* Type-safe navigation with Navigation Compose.

* Covers deep links, nested graphs, adaptive navigation, and testing.

• [Retrofit Networking](.github/skills/android-retrofit/SKILL.md) (android-retrofit)

* Expert guidance on Retrofit, OkHttp, and Coroutines for networking.

* Includes configuration for Serialization, Interceptors, and Hilt.

• [Gradle Build Performance](.github/skills/gradle-build-performance/SKILL.md) (gradle-build-performance)

* Debug and optimize Gradle/Android build times.

* 12 optimization patterns including Configuration Cache, KSP migration, and CI/CD caching.

• [Coil for Jetpack Compose](.github/skills/coil-compose/SKILL.md) (coil-compose)

* Expert guidance on Coil for image loading in Jetpack Compose.

* Covers AsyncImage, state management, and performance optimization.

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

Standard Location (VS Code / GitHub Copilot)

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

1. Copy: Copy the .github/skills/ folder from this repository to your project's root.
2. Verify: Ensure your project structure looks like this:

```text

my-android-project/

├── .github/

│ └── skills/

│ ├── android-architecture/

│ │ └── SKILL.md

│ └── compose-ui/

│ └── SKILL.md

├── app/

└── ...

```

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

Other Environments

• 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/.

Creating Custom Skills

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:

```markdown

---

name: my-custom-skill

description: Description of what this skill does

---

# Instructions

...

```

GitHub Copilot

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.

Manual / Other Agents

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.