Compose Agent Skill
Make your AI coding tool actually understand Compose — Android, Desktop, iOS, and Web.
Backed by real source code from androidx/androidx and compose-multiplatform-core — not vibes.
Install
This skill is distributed as a plugin. See docs/INSTALL.md for per-host instructions:
- Claude Code:
/plugin marketplace add aldefy/compose-skill → /plugin install compose-expert
- Copilot CLI:
copilot plugin install aldefy/compose-skill
- Codex CLI: manual install — see INSTALL.md.
Already installed manually? See docs/MIGRATION.md.
Updates
New versions are published as GitHub Releases with migration notes. Run /plugin update (Claude Code) or copilot plugin update aldefy/compose-skill (Copilot) to pick them up.
The problem
AI coding tools generate Compose code that compiles but gets the details wrong. Incorrect remember usage, unstable recompositions, broken modifier ordering, deprecated navigation patterns, hallucinated APIs that don't exist. They guess at behavior instead of knowing it.
This skill fixes that by giving your AI assistant two things:
- 24 reference guides covering every major Compose topic — including Compose Multiplatform, Android TV, Material 3 motion, atomic design systems, design-to-code workflows, animation recipes, Paging 3 (core / offline-first / MVI + testing), Nav 2 → Nav 3 migration, and production crash patterns
- 6 source code files pulled directly from
androidx/androidx and compose-multiplatform-core so the agent can check how things actually work
What changes when you install it
| Area | Without the skill | With it |
|---|
| State | Uses remember { mutableStateOf() } everywhere, even when derivedStateOf or rememberSaveable is the right call | Picks the right state primitive for each situation |
| Performance | Generates code that recomposes every frame | Applies stability annotations, deferred reads, key {} on lists |
| Navigation | String-based routes (deprecated) | Type-safe routes with @Serializable route classes |
| Modifiers | Random ordering, misses clickable before padding bugs | Correct ordering with reasoning |
| Side effects | Wrong coroutine scope, bad LaunchedEffect keys | Correct effect selection and lifecycle-aware keys |
| APIs | Hallucinates parameters that don't exist | Checks against actual source before suggesting |
| Multiplatform | Uses Android-only APIs in shared code | Uses expect/actual, Res.* resources, platform-correct patterns |
| Design-to-code | Literal Figma node translation, wrong modifier ordering | Semantic M3 components, correct ordering, theme tokens |
| Crash safety | No defensive patterns | Guards against zero-size DrawScope, duplicate keys, stale derivedStateOf |
What's covered