Skip to content
Back to search

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.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/anhvt52--jetpack-compose-skills/badge.svg)](/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

i

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)

  1. # Modern Jetpack Compose — Agent Skill
  2. An agent skill for writing, reviewing, and reasoning about modern Android UI code
  3. using Jetpack Compose. Compatible with Claude Code, Cursor, Codex, and any platform
  4. that supports the Agent Skills format.
  5. ![Claude Code](https://img.shields.io/badge/Claude_Code-supported-blueviolet?logo=anthropic)
  6. ![Cursor](https://img.shields.io/badge/Cursor-supported-blue?logo=cursor)
  7. ![Codex](https://img.shields.io/badge/Codex-supported-green?logo=openai)
  8. ![Gemini](https://img.shields.io/badge/Gemini-supported-orange?logo=google)
  9. ---
  10. ## Why This Skill?
  11. LLMs frequently generate outdated or incorrect Jetpack Compose code. Common problems:
  12. - **Wrong state collection** — using `collectAsState()` instead of `collectAsStateWithLifecycle()`
  13. - **Unstable recomposition** — passing unstable lambdas or undecorated data classes that cause unnecessary redraws
  14. - **Ignored Scaffold padding** — forgetting to apply `paddingValues` from `Scaffold`'s content lambda, causing content to render under system bars
  15. - **Stale APIs** — referencing accompanist libraries that have since been upstreamed into Compose, or Material 2 APIs that have Material 3 equivalents
  16. - **Architecture drift** — mixing state hoisting patterns or bypassing the UDF model
  17. 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.
  18. ---
  19. ## What It Does
  20. Load this skill to give your AI agent deep knowledge of modern Jetpack Compose best
  21. practices. It helps agents:
  22. - **Generate** idiomatic Compose code from scratch
  23. - **Review** existing code for deprecated APIs, anti-patterns, and accessibility gaps
  24. - **Guide** architecture decisions around state management, navigation, and performance
  25. ---
  26. ## Skill Coverage
  27. | Reference File | Topics Covered |
  28. |---|---|
  29. | `api.md` | Deprecated APIs → modern replacements, Material 2 → 3, accompanist migrations |
  30. | `composables.md` | Naming conventions, state hoisting, slot APIs, `@Preview`, modifier contract |
  31. | `state.md` | MVVM + UDF, ViewModel + StateFlow, `remember` vs `rememberSaveable`, `derivedStateOf` |
  32. | `effects.md` | `LaunchedEffect`, `DisposableEffect`, `SideEffect`, `rememberCoroutineScope` |
  33. | `recomposition.md` | `@Stable`/`@Immutable`, unstable collections, `key()` in lazy lists, lambda stability |
  34. | `navigation.md` | Type-safe Navigation Compose, nested graphs, BackStack-scoped ViewModels, deep links |
  35. | `design.md` | Material 3 theming, dynamic color, adaptive layouts, Material Expressive (BOM 2025.x) |
  36. | `accessibility.md` | TalkBack, semantics, `mergeDescendants`, touch targets, color contrast |
  37. | `performance.md` | LazyList optimization, `remember`, deferred state reads, `graphicsLayer` |
  38. | `kotlin.md` | Sealed interfaces, coroutines, `stateIn`, null safety, `when` expressions |
  39. | `hygiene.md` | Testing with `ComposeTestRule`, lint/detekt, secrets, resource naming |
  40. ---
  41. ## Installation
  42. ### Recommended — npx (Claude Code, Cursor, Codex, Gemini)
  43. ```bash
  44. npx skills add https://github.com/anhvt52/jetpack-compose-skills
  45. ```
  46. This installs the skill for all detected agents on your machine. You can also scope it:
  47. ```bash
  48. # Project-level only
  49. npx skills add https://github.com/anhvt52/jetpack-compose-skills
  50. # Global (all your projects)
  51. npx skills add https://github.com/anhvt52/jetpack-compose-skills -g
  52. ```
  53. If `npx` is unavailable, install Node.js first:
  54. ```bash
  55. brew install node
  56. ```
  57. ### Manual — Claude Code
  58. Clone the repo and add to your project's `CLAUDE.md`:
  59. ```
  60. Use the skill at: path/to/modern-jetpack-compose/SKILL.md
  61. ```
  62. ### Manual — Cursor / Codex / OpenAI-compatible platforms
  63. Use the config at `modern-jetpack-compose/agents/openai.yaml`.
  64. ---
  65. ## Target Platform
  66. - **Compose BOM:** 2024.x (stable default), with notes for 2025.x (Material Expressive)
  67. - **Material Design:** Material 3
  68. - **Architecture:** MVVM + Unidirectional Data Flow (UDF)
  69. - **Language:** Kotlin with coroutines, Flow, and sealed interfaces
  70. ---
  71. ## Example Usage
  72. **Reviewing code:**
  73. > "Using the modern-jetpack-compose skill, review the files in `feature/home/` for
  74. > best practices issues."
  75. **Generating code:**
  76. > "Using the modern-jetpack-compose skill, write a `BookListScreen` with a LazyColumn,
  77. > search bar, and empty state, backed by a ViewModel."
  78. **Targeted check:**
  79. > "Using `references/accessibility.md` from the modern-jetpack-compose skill, check
  80. > all composables in `components/` for accessibility issues."
  81. ---
  82. ## Output Format
  83. The skill organizes findings by file. Each issue includes:
  84. 1. File and line number
  85. 2. Rule being violated
  86. 3. Before/after Kotlin snippet
  87. Results end with a prioritized summary of the most impactful changes.
  88. ---
  89. ## License
  90. MIT — see [LICENSE](LICENSE).
  91. ## Author
  92. Anh Vu — [anhvt52@gmail.com](mailto:anhvt52@gmail.com)
  93. ## Contributing
  94. See [CONTRIBUTING.md](CONTRIBUTING.md).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.