performance-compose-skills
Performance-first AI agent skills for Jetpack Compose and Compose Multiplatform. Each skill leads with the 3-phase model (Composition → Layout → Drawing) and includes decision trees, critical patterns, and a shared performance toolchain.
Use compose-audit to scan an existing codebase for bad practices, classify findings (critical / warning / suggestion), and route each issue to the right fix skill.
Author: Santiago Mattiauda
License: Apache-2.0
Skills
| Tier | Skill | Focus | CMP |
|---|
| 1 | compose-composition-core | State, recomposition, stability, identity | ✅ |
| 1 | compose-modifier-system | Modifiers, layout/draw phase, ModifierNodeElement | ✅ |
| 2 | compose-effects | Side effects, snapshotFlow, effect keys | ⚠️ |
| 2 | compose-animations | Animations in Drawing phase, graphicsLayer | ✅ |
| 3 | compose-architecture | Clean Architecture, MVVM, UiState | ⚠️ |
| 3 | compose-navigation-nav3 | Navigation 3, NavKey, decorators; CMP Nav3 alpha | ⚠️ |
| 4 | compose-previews-tooling | Previews, Baseline Profiles, profiling | ⚠️ |
| 4 | compose-quality | Accessibility, semantics, UI testing | ⚠️ |
| Audit | compose-audit | Audit Compose/CMP projects; route findings to canonical skills | ✅ |
CMP column: ✅ fully commonMain-safe · ⚠️ partial (version-gated or some Android-only items) · ❌ Android-only.
Full registry: AGENTS.md
Compose Multiplatform
Every skill in this repo carries a ## CMP Applicability table documenting which APIs are commonMain-safe, which are Android-only, and which require version gates.
Canonical CMP rules: skills/_shared/cmp-platform.md — source-set map, forbidden imports, expect/actual patterns, lifecycle version gates (2.8 / 2.10), navigation options (CMP Nav3 alpha), iOS accessibility, tooling matrix, and version pinning.
Quick facts (May 2026):
collectAsStateWithLifecycle in commonMain: requires lifecycle-runtime-compose ≥ 2.8viewModel { MyViewModel() } in commonMain: requires lifecycle-viewmodel-compose 2.10.0 (org.jetbrains.androidx.lifecycle)- CMP Nav3:
org.jetbrains.androidx.navigation3:navigation3-ui 1.0.0-alpha05 (CMP 1.10+)
- iOS accessibility: semantics → VoiceOver automatically; configure
AccessibilitySyncOptions on ComposeUIViewController
- CMP UI tests:
runComposeUiTest from org.jetbrains.compose.ui:ui-test in commonTest
Installation
Supported agents: Claude Code, Cursor, Gemini CLI, Antigravity, OpenCode, and Codex.
Quick install (all agents)
npx skills add santimattius/performance-compose-skills \
--skill '*' \
-a claude-code -a cursor -a gemini-cli -a antigravity -a opencode -a codex \
-y
Or from a local clone:
./scripts/install-skills.sh --local
Full paths, native commands, and troubleshooting: docs/INSTALL.md
Claude Code (marketplace)
/plugin marketplace add santimattius/performance-compose-skills
/plugin install performance-compose-skills@performance-compose-skills
Project registry
Add AGENTS.md to your Android repo (or symlink it) so agents load the skill index and the Composition → Layout → Drawing rule before writing Compose code.
Each skill is self-contained: SKILL.md + references/ (no external doc dependencies). compose-audit also ships assets/ (report template and routing table).
Audit only
npx skills add santimattius/performance-compose-skills \
--skill compose-audit \
-a cursor -y
Triggers: "audit my Compose project", "review CMP code", "find perf issues in Compose".
Structure
