- name
SKILL.md
The skill file stays in the publisher's repository.
Paste the copied command in a terminal. It installs this SKILL.md into that agent.
npx skills add aldefy/compose-skill --skill compose-expert -a cursor -yPaste the copied command in a terminal. It installs this SKILL.md into that agent.
npx skills add aldefy/compose-skill --skill compose-expert -a claude-code -yPaste the copied command in a terminal. It installs this SKILL.md into that agent.
npx skills add aldefy/compose-skill --skill compose-expert -a codex -yPaste the copied command in a terminal. It installs this SKILL.md into that agent.
npx skills add aldefy/compose-skill --skill compose-expert -a grok -ySend the copied message in a Grok Bot chat. The Bot fetches this SKILL.md from GitHub and adds it to the skills all your Bots share.
Install this skill: https://github.com/aldefy/compose-skill/tree/HEAD/skills/compose-expertFrom the publisher
Installation notice: This skill is now distributed as a plugin. If you copied files into
~/.claude/skills/manually, you are on an unmaintained install path and will not receive updates. Migrate via:/plugin marketplace add aldefy/compose-skill /plugin install compose-expertSee MIGRATION.md for Codex and Copilot CLI instructions. This banner will remain through v2.x and escalate in v3.0.
The frontmatter description: is intentionally short to satisfy Codex / Copilot
CLI's 1024-character cap on that field (see issue #12). The full trigger surface
lives here so it stays available to Claude after the skill loads.
@Composable, remember, mutableStateOf, derivedStateOf, rememberSaveable,
LaunchedEffect, DisposableEffect, SideEffect, rememberCoroutineScope,
Scaffold, NavHost, NavController, MaterialTheme, ColorScheme,
Typography, LazyColumn, LazyRow, LazyVerticalGrid, HorizontalPager,
Modifier, Modifier.Node, recomposition, CompositionLocal, Style,
styleable, MutableStyleState, Material 3 Expressive, M3 Expressive,
MaterialExpressiveTheme, ButtonGroup, SplitButton,
FloatingActionButtonMenu, LoadingIndicator, HorizontalFloatingToolbar,
NavDisplay, NavKey, rememberNavBackStack, NavigableListDetailPaneScaffold,
TextFieldState, InputTransformation, OutputTransformation, computedStateOf,
MediaQuery, Grid, FlexBox, A2uiSurface, StateStore, RemoteCompose,
MeshGradientPainter, PolygonShape, MorphPolygonShape, AGSL, RuntimeShader,
ShaderBrush, RenderEffect, AgentRunner, AgentSession, GenerativeModel,
Gemini Nano, ML Kit Agentic API, androidx.tracing, traceCoroutine,
tracing-wire, InProgressStrokesView, androidx.ink, Jetpack Ink,
CarAppService, androidx.car.app, Android Auto, Android Automotive OS,
parked apps, Jetpack Keep, UsesReflectionToConstruct, Engine Hub, android/skills.
Compose Multiplatform, CMP, KMP, commonMain, expect, actual,
ComposeUIViewController, Window composable, UIKitView, ComposeViewport,
Res.drawable, Res.string, SkikoMain, Compose Hot Reload, WindowState v2,
native text input, awaitPendingResourceStateLoads.
A2UI, Agent-to-UI, material3-a2ui, A2uiCatalog, generative UI,
Remote Compose, RemoteComposable, Wear Widget, MediaQuery, FlexBox,
adaptive layout, trackpad, indirect input, Compose Glimmer, Subspace,
Android XR, projected activity, Jetpack AppState, StateStore, Transform,
AppFunctions, @AppFunctionDeclaration, AppFunctionService,
AppFunctionManager, Android MCP, EXECUTE_APP_FUNCTIONS.
tv-material, tv-foundation, Carousel, NavigationDrawer (TV),
D-pad, focus indication, FocusRequester on TV, 10-foot UI,
living room, tv compose, Android TV, Google TV, leanback migration.
PagingSource, Pager, PagingConfig, PagingData, LazyPagingItems,
collectAsLazyPagingItems, RemoteMediator, LoadState,
asSnapshot, TestPager, cachedIn.
atomic design, atoms, molecules, organisms, templates,
design tokens, design system, component library, reusable component,
Figma to Compose, design to compose, build this UI, implement this design,
spec to code, redline.
"my compose screen is slow", "my recomposition is broken", "how do I pass data between screens", "how do I build a TV app", "Android UI", "Kotlin UI", "compose layout", "compose navigation", "compose animation", "compose styles", "desktop compose", "iOS compose", "compose web".
Any GitHub PR URL matching github.com/.*/pull/\d+, or phrases:
"review this PR", "review this diff", "review this code",
"check this code", "check this diff", "what's wrong with this".
On match, follow references/pr-review.md for the review workflow and report, and also read the
topic reference(s) from Quick Routing for any dimension the request names (performance, lists,
shaders, navigation…).
Auto-detect Compose projects on session_start — see references/auto-init.md.
Use this table first. Match the user's signal to one reference file and read it before
answering. source-code/ files are supporting evidence — load a references/*.md file
first, then cite source-code/ for implementation proof when receipts matter.
remember, rememberSaveable, mutableStateOf vs mutableIntStateOf, state hoisting → references/state-management.mdderivedStateOf, snapshotFlow, StateFlow in UI, recomposition scope boundaries → references/state-management.md (secondary: references/performance.md)LaunchedEffect, SideEffect, DisposableEffect, rememberUpdatedState, rememberCoroutineScope → references/side-effects.md@Stable/@Immutable, Compose compiler metrics, baseline profiles, strong skipping, androidx.tracing, traceCoroutine, Perfetto app traces, Jetpack Keep / @UsesReflectionTo* keep annotations, custom draw cost, drawWithContent, saveLayer, offscreen layers, drawWithCache, rememberGraphicsLayer → references/performance.mdCompositionLocal, ambient values, theming propagation, LocalContext misuse, custom locals → references/composition-locals.mdTransform, listener, StateStore, Jetpack AppState persistence (not the DataStore library itself) → references/appstate.mdanimate*AsState, AnimatedVisibility, Crossfade, updateTransition, Animatable, rememberInfiniteTransition → references/animation.mdModifier.graphicsLayer, custom motion spec → references/animation.md (secondary: references/modifiers.md for graphicsLayer; Canvas/custom drawing cost → references/performance.md)MotionTokens, MotionScheme, animation duration tokens, M3 easing curves → references/material3-motion.mdMeshGradientPainter, wide gamut, polygon/morph shapes, PolygonShape, MorphPolygonShape, progressive or backdrop blur, modern draw effects → references/graphics-modern.mdRuntimeShader, ShaderBrush, shader brushes, RenderEffect, GPU effects → references/agsl-shaders.mdLazyColumn, LazyRow, LazyVerticalGrid, LazyHorizontalGrid, key/itemKey, contentType, LazyListState, scroll state, sticky headers, key {} for forEach/repeat children in non-lazy layouts → references/lists-scrolling.mdHorizontalPager, VerticalPager, PagerState → references/lists-scrolling.mdLayout, SubcomposeLayout, layout modifier, draw modifier, Painter, Modifier.Node → references/modifiers.mdMediaQuery, Grid, FlexBox, keyboard/mouse/trackpad, indirect input, input testing → references/adaptive-layout-input.mdTextFieldState, TextFieldBuffer, InputTransformation, OutputTransformation, rich text editing → references/text-editing.mdA2uiSurface, agent-generated Compose UI → references/agentic-ui-a2ui.md@RemoteComposable, remote documents/players, Glance or Wear remote surfaces → references/remote-compose.md@AppFunctionDeclaration, AppFunctionService, on-device tool calling → references/appfunctions.mdAgentRunner, AgentSession, GenerativeModel, Gemini Nano, on-device agent workflows → references/ml-kit-agentic.mdNavHost, NavController, back stack, deep links, type-safe @Serializable routes, navigation graph, nested graphs → references/navigation.mdNavDisplay, NavKey, rememberNavBackStack, NavBackStackEntry changes → references/navigation-migration.mdreferences/navigation-migration.md (secondary: references/navigation.md)NavDisplay, adaptive list-detail (NavigableListDetailPaneScaffold), multiple/per-tab back stacks → references/navigation-migration.mdPagingSource, PagingData, Pager setup, PagingConfig, pagingDataFlow, invalidation → references/paging.mdLazyPagingItems, collectAsLazyPagingItems, itemKey, itemContentType, LoadState in UI, retry/refresh → references/paging.mdRemoteMediator, offline-first paging, network + cache paging, loadState.source.refresh → references/paging-offline.mdasSnapshot, TestPager), CombinedLoadStates, paging anti-patterns → references/paging-mvi-testing.mdMaterialTheme, ColorScheme, Typography, Shapes, dynamic color, M3 tokens, color roles → references/theming-material3.mdMaterialExpressiveTheme, ButtonGroup, SplitButton, FloatingActionButtonMenu, LoadingIndicator (wavy), HorizontalFloatingToolbar, @ExperimentalMaterial3ExpressiveApi → references/theming-material3.md (motion: references/material3-motion.md)references/atomic-design.mdreferences/design-to-compose.mdStyle {}, MutableStyleState, Modifier.styleable() (experimental Foundation Styles API) → references/styles-experimental.mdexpect/actual, commonMain, Res.drawable, Res.string, platform-specific composables, DataStore on KMP (createWithPath), viewModel { } in commonMain → references/multiplatform.mdComposeUIViewController (iOS), Window/Tray/MenuBar (Desktop), UIKitView, ComposeViewport (Web), platform interop → references/platform-specifics.mdandroidx.tv, D-pad focus, FocusRequester on TV, Carousel, NavigationDrawer (TV), 10-foot UI, leanback migration → references/tv-compose.mdTransformingLazyColumn, Wear Widgets, notification bridging → references/wear-compose.mdreferences/xr-compose.mdreferences/media3-compose.mdandroidx.ink, stylus/pen drawing, InProgressStrokesView, brushes, stroke erasing → references/ink.mdCarAppService, androidx.car.app, in-car templates, parked apps (video/games/browsers in the car) → references/car-compose.mdAndroidView, ComposeView, AbstractComposeView, hybrid migration, View → Compose interop → references/view-composition.mdModifier.semantics, TalkBack, touch target size, contentDescription, WCAG, traversal order → references/accessibility.mdremember leak, zero-size DrawScope, duplicate keys, stale derivedStateOf → references/production-crash-playbook.mdreferences/pr-review.mdreferences/deprecated-patterns.md@OptIn, @ExperimentalFoundationStyleApi, unstable API usage → references/styles-experimental.md (for Styles); for general guidance, the relevant topic filereferences/auto-init.mdandroid/skills skill covers, "is there an official skill for…" → references/official-android-skills.mdreferences/source-code/*.md file:
references/source-code/runtime-source.mdreferences/source-code/ui-source.mdreferences/source-code/foundation-source.mdreferences/source-code/material3-source.mdreferences/source-code/navigation-source.mdreferences/source-code/cmp-source.mdNon-opinionated, practical guidance for writing correct, performant Compose code —
across Android, Desktop, iOS, and Web. Covers Jetpack Compose and Compose Multiplatform.
Backed by analysis of actual source code from androidx/androidx and
JetBrains/compose-multiplatform-core.
Activate when the input contains a GitHub PR URL (github.com/.+/pull/\d+) or
explicit review phrases: "review this PR", "review this diff", "check this code",
"what's wrong with this".
When Review Mode activates:
references/pr-review.md and follow its workflow and report format. For a local
file (no PR URL), skip the gh fetch steps and review the file directly.lists-scrolling.md and performance.md; a shader file →
agsl-shaders.md). The checklist alone does not cover draw cost, state phases, or shaders.When helping with Compose code, follow this checklist:
references/design-to-compose.mdreferences/animation.md for recipesRead the relevant reference file(s) from references/ before answering:
When the request involves building a component (composable that renders UI):
references/atomic-design.mdWhen referencing Compose internals, point to the exact source file:
// See: compose/runtime/runtime/src/commonMain/kotlin/androidx/compose/runtime/Composer.kt
Compose thinks in three phases: Composition → Layout → Drawing. State reads in each phase only trigger work for that phase and later ones.
Recomposition is frequent and cheap — but only if you help the compiler skip unchanged scopes. Use stable types, avoid allocations in composable bodies.
Modifier order matters. Modifier.padding(16.dp).background(Color.Red) is visually
different from Modifier.background(Color.Red).padding(16.dp).
State should live as low as possible and be hoisted only as high as needed. Don't put everything in a ViewModel just because you can.
Side effects exist to bridge Compose's declarative world with imperative APIs. Use the right one for the job — misusing them causes bugs that are hard to trace.
Compose Multiplatform shares the runtime but not the platform. UI code in
commonMain is portable. Platform-specific APIs (LocalContext, BackHandler,
Window) require expect/actual or conditional source sets.
Beyond the guidance docs, this skill bundles the actual source code from
androidx/androidx (branch: androidx-main) and JetBrains/compose-multiplatform-core
(branch: jb-main). When you need to verify how something works internally, or the
user asks "show me the actual implementation", read the raw source from
references/source-code/:
references/state-management.md)references/source-code/androidx/androidx (branch: androidx-main)
├── compose/runtime/runtime/src/commonMain/kotlin/androidx/compose/runtime/
├── compose/ui/ui/src/androidMain/kotlin/androidx/compose/ui/platform/
├── compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/
├── compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/
├── compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/
├── compose/navigation/navigation-compose/src/commonMain/kotlin/androidx/navigation/compose/
├── tv/tv-material/src/main/java/androidx/tv/material3/
└── tv/tv-foundation/src/main/java/androidx/tv/foundation/
compose-multiplatform-core (branch: jb-main)
├── compose/ui/ui/src/desktopMain/kotlin/androidx/compose/ui/window/
├── compose/ui/ui/src/iosMain/kotlin/androidx/compose/ui/window/
├── compose/ui/ui/src/webMain/kotlin/androidx/compose/ui/window/
├── compose/ui/ui/src/skikoMain/kotlin/androidx/compose/ui/
└── compose/foundation/foundation/src/skikoMain/kotlin/androidx/compose/foundation/
compose-multiplatform (resources library)
└── components/resources/library/src/commonMain/
>
---name: compose-expertdescription: >---# skills/compose-expert/SKILL.mdFAQ
Download skills/compose-expert/SKILL.md from the publisher, or copy the path and open the repository. PlugMCP lists the skill and does not host the file.
The publisher keeps it at https://github.com/aldefy/compose-skill.
Claude, Cursor, Codex, and Grok Build can read a SKILL.md you add from the publisher's repository. Grok Bot installs it when you send the skill's GitHub folder link in a chat.
references/performance.md |
| Semantics, content descriptions, traversal order, testing | references/accessibility.md |
| Removed/replaced APIs, migration paths from older Compose versions | references/deprecated-patterns.md |
Styles API (experimental): Style {}, MutableStyleState, Modifier.styleable() | references/styles-experimental.md |
| Figma/screenshot decomposition, design tokens, spacing, modifier ordering | references/design-to-compose.md |
| Production crash patterns, defensive coding, state/performance rules | references/production-crash-playbook.md |
Compose Multiplatform, expect/actual, resources (Res.*), migration | references/multiplatform.md |
| Desktop (Window, Tray, MenuBar), iOS (UIKitView), Web (ComposeViewport) | references/platform-specifics.md |
Adaptive MediaQuery/Grid/FlexBox, keyboard, mouse, trackpad, indirect input | references/adaptive-layout-input.md |
| A2UI and agent-generated native UI | references/agentic-ui-a2ui.md |
| AppFunctions, agent tool calling, Android MCP | references/appfunctions.md |
| Remote Compose and remote documents/players | references/remote-compose.md |
| Modern graphics, mesh gradients, polygon shapes, blur | references/graphics-modern.md |
| AGSL shaders, RuntimeShader, ShaderBrush, RenderEffect | references/agsl-shaders.md |
| ML Kit Agentic API, Gemini Nano, AgentRunner, AgentSession | references/ml-kit-agentic.md |
| Android XR and Compose Glimmer | references/xr-compose.md |
| Wear OS Compose and Wear Widgets | references/wear-compose.md |
| Media3 UI Compose | references/media3-compose.md |
| Jetpack Ink, stylus drawing, brushes, strokes | references/ink.md |
| Android Auto, Android Automotive OS, Car App Library, parked apps | references/car-compose.md |
Official android/skills cross-links, when to defer | references/official-android-skills.md |
| TV Compose: Surface, Carousel, NavigationDrawer, Cards, focus, D-pad | references/tv-compose.md |
M3 motion tokens, MotionTokens, MotionScheme, animation duration, easing | references/material3-motion.md |
| PR URL, code review, "review this PR", "what's wrong with this" | references/pr-review.md |
| Session start, project detection | references/auto-init.md |
| Atomic design, design system, reusable component, component library, design tokens | references/atomic-design.md |