jetpack-compose-skills
Agent skill for modern Android development with Jetpack Compose — best practices for code generation and review
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/anhvt52--jetpack-compose-skills)HTML
<a href="/listings/anhvt52--jetpack-compose-skills"><img src="/api/listings/anhvt52--jetpack-compose-skills/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
Recommended — npx (Claude Code, Cursor, Codex, Gemini)
npx skills add https://github.com/anhvt52/jetpack-compose-skills
This installs the skill for all detected agents on your machine. You can also scope it:
# Project-level only npx skills add https://github.com/anhvt52/jetpack-compose-skills # Global (all your projects) npx skills add https://github.com/anhvt52/jetpack-compose-skills -g
If `npx` is unavailable, install Node.js first:
brew install node
Manual — Claude Code
Clone the repo and add to your project's `CLAUDE.md`:
Use the skill at: path/to/modern-jetpack-compose/SKILL.md
Manual — Cursor / Codex / OpenAI-compatible platforms
Use the config at `modern-jetpack-compose/agents/openai.yaml`.
---
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 142 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- # Modern Jetpack Compose — Agent Skill
- An agent skill for writing, reviewing, and reasoning about modern Android UI code
- using Jetpack Compose. Compatible with Claude Code, Cursor, Codex, and any platform
- that supports the Agent Skills format.
- 
- 
- 
- 
- ---
- ## Why This Skill?
- LLMs frequently generate outdated or incorrect Jetpack Compose code. Common problems:
- - **Wrong state collection** — using `collectAsState()` instead of `collectAsStateWithLifecycle()`
- - **Unstable recomposition** — passing unstable lambdas or undecorated data classes that cause unnecessary redraws
- - **Ignored Scaffold padding** — forgetting to apply `paddingValues` from `Scaffold`'s content lambda, causing content to render under system bars
- - **Stale APIs** — referencing accompanist libraries that have since been upstreamed into Compose, or Material 2 APIs that have Material 3 equivalents
- - **Architecture drift** — mixing state hoisting patterns or bypassing the UDF model
- This skill gives your AI agent a curated, up-to-date reference for all of these areas so it generates correct, idiomatic Compose code from the start.
- ---
- ## What It Does
- Load this skill to give your AI agent deep knowledge of modern Jetpack Compose best
- practices. It helps agents:
- - **Generate** idiomatic Compose code from scratch
- - **Review** existing code for deprecated APIs, anti-patterns, and accessibility gaps
- - **Guide** architecture decisions around state management, navigation, and performance
- ---
- ## Skill Coverage
- | Reference File | Topics Covered |
- |---|---|
- | `api.md` | Deprecated APIs → modern replacements, Material 2 → 3, accompanist migrations |
- | `composables.md` | Naming conventions, state hoisting, slot APIs, `@Preview`, modifier contract |
- | `state.md` | MVVM + UDF, ViewModel + StateFlow, `remember` vs `rememberSaveable`, `derivedStateOf` |
- | `effects.md` | `LaunchedEffect`, `DisposableEffect`, `SideEffect`, `rememberCoroutineScope` |
- | `recomposition.md` | `@Stable`/`@Immutable`, unstable collections, `key()` in lazy lists, lambda stability |
- | `navigation.md` | Type-safe Navigation Compose, nested graphs, BackStack-scoped ViewModels, deep links |
- | `design.md` | Material 3 theming, dynamic color, adaptive layouts, Material Expressive (BOM 2025.x) |
- | `accessibility.md` | TalkBack, semantics, `mergeDescendants`, touch targets, color contrast |
- | `performance.md` | LazyList optimization, `remember`, deferred state reads, `graphicsLayer` |
- | `kotlin.md` | Sealed interfaces, coroutines, `stateIn`, null safety, `when` expressions |
- | `hygiene.md` | Testing with `ComposeTestRule`, lint/detekt, secrets, resource naming |
- ---
- ## Installation
- ### Recommended — npx (Claude Code, Cursor, Codex, Gemini)
- ```bash
- npx skills add https://github.com/anhvt52/jetpack-compose-skills
- ```
- This installs the skill for all detected agents on your machine. You can also scope it:
- ```bash
- # Project-level only
- npx skills add https://github.com/anhvt52/jetpack-compose-skills
- # Global (all your projects)
- npx skills add https://github.com/anhvt52/jetpack-compose-skills -g
- ```
- If `npx` is unavailable, install Node.js first:
- ```bash
- brew install node
- ```
- ### Manual — Claude Code
- Clone the repo and add to your project's `CLAUDE.md`:
- ```
- Use the skill at: path/to/modern-jetpack-compose/SKILL.md
- ```
- ### Manual — Cursor / Codex / OpenAI-compatible platforms
- Use the config at `modern-jetpack-compose/agents/openai.yaml`.
- ---
- ## Target Platform
- - **Compose BOM:** 2024.x (stable default), with notes for 2025.x (Material Expressive)
- - **Material Design:** Material 3
- - **Architecture:** MVVM + Unidirectional Data Flow (UDF)
- - **Language:** Kotlin with coroutines, Flow, and sealed interfaces
- ---
- ## Example Usage
- **Reviewing code:**
- > "Using the modern-jetpack-compose skill, review the files in `feature/home/` for
- > best practices issues."
- **Generating code:**
- > "Using the modern-jetpack-compose skill, write a `BookListScreen` with a LazyColumn,
- > search bar, and empty state, backed by a ViewModel."
- **Targeted check:**
- > "Using `references/accessibility.md` from the modern-jetpack-compose skill, check
- > all composables in `components/` for accessibility issues."
- ---
- ## Output Format
- The skill organizes findings by file. Each issue includes:
- 1. File and line number
- 2. Rule being violated
- 3. Before/after Kotlin snippet
- Results end with a prioritized summary of the most impactful changes.
- ---
- ## License
- MIT — see [LICENSE](LICENSE).
- ## Author
- Anh Vu — [anhvt52@gmail.com](mailto:anhvt52@gmail.com)
- ## Contributing
- See [CONTRIBUTING.md](CONTRIBUTING.md).
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.