compose-skill

<p align="center">
  <img src="https://raw.githubusercontent.com/devicons/devicon/master/icons/jetpackcompose/jetpackcompose-original.svg" width="80" alt="Jetpack Compose logo"/>
</p>

<h1 align="center">Compose Agent Skill</h1>

<p align="center">
  Make your AI coding tool actually understand Compose — Android, Desktop, iOS, and Web.<br/>
  Backed by real source code from <code>androidx/androidx</code> and <code>compose-multiplatform-core</code> — not vibes.
</p>

<p align="center">
  <a href="#setup"><img src="https://img.shields.io/badge/setup-5%20min-brightgreen" alt="Setup time"/></a>
  <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue" alt="License"/></a>
  <a href="https://developer.android.com/jetpack/compose"><img src="https://img.shields.io/badge/Jetpack%20Compose-1.7+-4285F4" alt="Compose version"/></a>
  <a href="https://www.jetbrains.com/lp/compose-multiplatform/"><img src="https://img.shields.io/badge/Compose%20Multiplatform-1.8+-7F52FF" alt="CMP version"/></a>
  <a href="https://kotlinlang.org"><img src="https://img.shields.io/badge/Kotlin-2.0+-7F52FF" alt="Kotlin version"/></a>
</p>

---

## Install

This skill is distributed as a plugin. See **[docs/INSTALL.md](docs/INSTALL.md)** for per-host instructions:

- **Claude Code:** `/plugin marketplace add aldefy/compose-skill` → `/plugin install compose-expert`
- **Cursor CLI:** `cursor plugin install aldefy/compose-skill`
- **Codex CLI:** manual install — see INSTALL.md.

Already installed manually? See **[docs/MIGRATION.md](docs/MIGRATION.md)**.

## Updates

New versions are published as [GitHub Releases](https://github.com/aldefy/compose-skill/releases) with migration notes. Run `/plugin update` (Claude Code) or `cursor plugin update aldefy/compose-skill` (Cursor) 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 nav