Compose Skill

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:

1. 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
2. 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