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)

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.

---

Target Platform