Guide · Agent skill
How to use the Android Jetpack Compose Expert agent skill
Updated · written with AI from the project's own documentation and checked against our catalogue data
The Android Jetpack Compose Expert skill is a set of written guidance and code examples that an AI agent reads when you ask it about building Android screens with Jetpack Compose, Google's toolkit for defining app UI in Kotlin code instead of XML layouts. This guide shows you how to install it, how to phrase requests so the agent uses it, and what it can and cannot do. By the end you will know how to get help with project setup, ViewModel state, type-safe navigation and recomposition problems.
Android Jetpack Compose Expertsickn33/agentic-awesome-skills · MIT Download the skill Quick start
- 1Download the ZIP. Download the skill ZIP from the page where you found this guide. The skill is licensed under MIT.
- 2Unzip the skill folder. Unzip the file so you have a folder containing SKILL.md.
- 3Place the folder. Move the folder into ~/.claude/skills/ for personal use, or into .claude/skills/ inside your Android project. Alternatively, upload the ZIP in the Claude apps under Settings → Capabilities → Skills.
- 4Check your project. Confirm you have an Android project using Kotlin and Jetpack Compose, plus Hilt, Navigation Compose and Kotlin serialization if your task needs them.
- 5Ask a plain question. Describe your task in natural language and mention Jetpack Compose, for example a ViewModel, navigation or recomposition problem.
- 6Verify current versions. Ask the agent to confirm current library versions from official docs before editing your build files.
- 7Test the output. Apply the suggested code yourself, then build and test it in Android Studio.
What the skill makes the agent do
Once installed, the agent answers Android UI questions using Jetpack Compose patterns. The skill covers project dependencies, ViewModel and StateFlow state patterns, type-safe navigation between screens, and performance tips such as avoiding unnecessary recomposition.
The skill is guidance and code examples only. It does not run anything on your computer, runs no scripts and uses no network access.
- Project setup with a libs.versions.toml file that includes the Compose BOM and libraries
- A ViewModel exposing UI state through StateFlow, without exposing MutableStateFlow
- A Screen composable that passes state and callbacks down to stateless components
- Type-safe navigation with Navigation Compose
- Performance guidance on remember, derivedStateOf, stability and recomposition
How do you install the skill?
You can download the skill as a ZIP from the page where you found this guide, then unzip it. The skill is a folder containing a single file, SKILL.md. Place the unzipped folder in one of these locations:
- Personal skills folder: ~/.claude/skills/
- Project-level skills folder: the .claude/skills/ folder inside your Android project
- Claude apps: upload the ZIP under Settings → Capabilities → Skills
How do you trigger the skill with a natural request?
You do not need a special command. Describe your Android task in plain language and mention Jetpack Compose, so the agent knows which guidance applies. The skill's own list of when to use it covers starting a new Compose project, migrating XML layouts, managing complex UI state and side effects, optimizing recomposition, and setting up type-safe navigation.
Include details about your project, such as whether you use Hilt, which Kotlin serialization setup you have, and what screen or problem you are working on. The more specific the request, the more useful the answer.
- "I'm starting a Jetpack Compose app. Set up libs.versions.toml with the Compose BOM and Material 3."
- "Show me a ViewModel with StateFlow for a user profile screen that handles loading and errors."
- "Help me set up type-safe navigation from a home screen to a profile screen in Navigation Compose."
- "My Compose screen keeps recomposing. Help me find the cause of the state problem."
What do you need before using it?
The skill assumes you are working on an Android project. Its requirements are Android Studio or an Android project using Kotlin and Jetpack Compose. If you use the Hilt ViewModel examples, you need Hilt. Type-safe navigation needs Navigation Compose and Kotlin serialization.
The skill's own examples show dependency versions, but it states that these are historical examples and not a current recommended stack. Ask the agent to check current official documentation for versions before you add anything to your build, since outdated versions could break your build.
- Android Studio or an Android Kotlin project with Jetpack Compose
- Hilt, if you follow the Hilt ViewModel examples
- Navigation Compose and Kotlin serialization, for type-safe navigation
- Current library versions from official documentation, not the examples in the file
Examples of what the agent gives you
A typical answer includes a short explanation and a code block you can adapt. For state, the skill shows a UserUiState data class with isLoading, user and error fields, and a ViewModel that updates it with update and copy. For screens, it shows a UserScreen that collects state with collectAsStateWithLifecycle and passes data into a stateless UserContent composable.
For navigation, the skill defines destinations as @Serializable objects and data classes, then uses composable<Home> and backStackEntry.toRoute() in a NavHost. The skill also notes that initial loading must be triggered deliberately, for example in the ViewModel init block or a keyed effect, because the retry callback alone does not load the first user.
navController.navigate(Profile(userId = id))Safety notes and limits
Because the skill runs no scripts and uses no network, it cannot change your files, install packages or test your app. Every code example is text the agent suggests. You still need to read it, apply it yourself and run your own build and tests.
The skill says to use it only when the task matches its scope, not to treat its output as a replacement for testing or expert review, and to ask for clarification when inputs or success criteria are missing. It also advises against exposing raw server exception messages in the UI.
- Review every code change before you commit it
- Run your own build, tests and Layout Inspector checks
- Do not annotate mutable collections with @Immutable or @Stable just to hide instability
What people use it for
- Setting up libs.versions.toml and the Compose BOM for a new Android app
- Replacing a screen built with XML layouts with a stateless Compose screen
- Designing a ViewModel with StateFlow for loading, success and error states
- Adding type-safe navigation between a home screen and a detail screen
- Finding causes of excess recomposition using a checklist and Layout Inspector
Frequently asked questions
Is the Android Jetpack Compose Expert skill free?
The skill is published under the MIT licence, as stated on its page. Check the licence text on the source repository for the exact terms before you reuse it.
What do I need to use this skill?
You need an Android project using Kotlin and Jetpack Compose, or Android Studio. Hilt is needed for the Hilt ViewModel examples, and Navigation Compose with Kotlin serialization is needed for type-safe navigation.
How do I install an agent skill?
Unzip the downloaded ZIP so it contains SKILL.md, then place the folder in ~/.claude/skills/ or a project's .claude/skills/ folder. In the Claude apps you can instead upload the ZIP under Settings → Capabilities → Skills.
Does the skill run code or access the internet?
No. The skill runs no scripts and uses no network. It only provides guidance and code examples that the agent writes out for you to review.
Can I trust the dependency versions in the examples?
Not without checking. The skill says its dependency versions are historical examples, so ask the agent to check current official documentation before you update your build.
Why does my Compose screen keep recomposing?
The skill's troubleshooting section says new object allocation alone is not an infinite loop. Look for a feedback cycle that updates observed state during composition instead of in a side-effect or callback, and use Layout Inspector to check recomposition counts.
New agent skills, repos and AI tools — every week
The best new skills and open-source projects, the fastest-growing repos, and one free prompt. Five minutes to read. Unsubscribe anytime.
Our verdict
Use this skill if you are building or migrating an Android app with Jetpack Compose and want clear, pattern-based guidance on state, navigation and recomposition. Pick something else if you do not work on Android, or if you need the agent to run builds, change files or verify current library versions for you.
Download the skill