A skill covering the main APIs of the official Wear OS documentation.
androidx.wear.compose.* is mobile's androidx.compose.* This is a different API, and care should be taken not to confuse it with same-named components.
Read the appropriate README.md according to the user's task, and from there follow it to the individual files.
Directory structure
skills/android-wear/
SKILL.md
references/
wear-compose/
README.md
theme.md
scaffold.md
time-text.md
lists.md
expandable.md
button.md
button-group.md
edge-button.md
icon-button.md
selection-controls.md
split-selection-controls.md
card.md
list-header.md
animated-text-placeholder.md
picker.md
dialogs.md
dynamic-color-scheme.md
progress-indicators.md
slider-stepper.md
pager.md
curved-layout.md
swipe-to-reveal.md
rotary-input.md
hierarchical-focus.md
ambient-mode.md
swipe-dismissable-nav-host.md
navigation3.md
screen-sizes.md
migrate-to-material3.md
migrate-to-navigation3.md
performance.md
tiles/
README.md
tile-service.md
tile-builders.md
dimensions.md
color-and-type.md
layout-elements.md
modifiers.md
material3-layout.md
material3-buttons.md
material3-cards-progress.md
animations.md
actions-and-interactivity.md
updating-tiles.md
platform-data.md
tile-preview-debugging.md
versioning.md
wear-widgets/
README.md
glance-wear-widget-service.md
migrate-from-tiles.md
remote-compose-layout.md
remote-state-and-actions.md
complications-health/
README.md
background-body-sensors.md
complicationdatasourceservice.md
shorttextcomplicationdata.md
longtextcomplicationdata.md
rangedvaluecomplicationdata.md
monochromaticimagecomplicationdata.md
smallimagecomplicationdata.md
nodatacomplicationdata.md
complicationtext.md
complicationdatasourceupdaterequester.md
compatibility.md
healthservicesclient.md
measureclient.md
exerciseclient.md
exerciseevent.md
passivemonitoringclient.md
datatype.md
debouncedgoal.md
datapointcontainer.md
healthservicescapabilities.md
healthservicespermissions.md
healthservicessimulation.md
watch-face/
README.md
overview.md
setup.md
root-element.md
scene-and-parts.md
shapes.md
transform.md
time.md
text.md
images.md
expressions.md
weather.md
complications.md
user-configurations.md
personalization-and-photos.md
ambient-mode.md
effects.md
versions.md
memory-optimization.md
build-and-debug.md
watch-face-push.md
data-layer-communication/
README.md
assets.md
capabilityclient.md
dataclient.md
messageclient.md
nodeclient.md
ongoingactivity.md
remoteactivityhelper.md
remoteauthclient.md
wearablelistenerservice.md
Exploration procedure
Derive the category from the task, and identify the target page in the category's README.md:
- Find the category corresponding to the task in the mapping table below
- that category's
references/{category}/README.mdRefer to this to identify the target page - For the relevant page,
.mdRead this to check the details
Task → Category Mapping
| Task | Category | Reference README |
|---|---|---|
| Want to build themes and screen skeletons (Scaffold/TimeText) with Wear Compose | wear-compose | references/wear-compose/README.md |
| Want to display lists with ScalingLazyColumn / TransformingLazyColumn | wear-compose | references/wear-compose/README.md |
| Want to use Button / IconButton / SelectionControls / Card / Picker / Dialog | wear-compose | references/wear-compose/README.md |
| Want to implement CurvedLayout / rotary input (crown/bezel) / ambient mode | wear-compose | references/wear-compose/README.md |
| Want to migrate from Material 2.5 to Material 3 / from Navigation 2 to Navigation 3, and optimize Compose performance | wear-compose | references/wear-compose/README.md |
| Want to implement Tile (TileService) | tiles | references/tiles/README.md |
| Want to build layouts with ProtoLayout / Material3 tile components | tiles | references/tiles/README.md |
| Want to do Tile actions, updates, and platform data integration | tiles | references/tiles/README.md |
| Want to implement Wear Widget (GlanceWearWidgetService) | wear-widgets | references/wear-widgets/README.md |
| Want to build widget layouts with Remote Compose (RemoteBox/RemoteColumn/RemoteText/RemoteButton) | wear-widgets | references/wear-widgets/README.md |
| Want to handle Remote Compose state and actions (rememberMutableRemote* / valueChange / pendingIntentAction) | wear-widgets | references/wear-widgets/README.md |
| Want to consider migrating from Tile to Wear Widget | wear-widgets | references/wear-widgets/README.md |
| Want to implement ComplicationDataSourceService and complication data types | complications-health | references/complications-health/README.md |
| Want to handle exercise and health data with Health Services (MeasureClient/ExerciseClient/PassiveMonitoringClient) | complications-health | references/complications-health/README.md |
| Want to check Health Services permissions, simulation, cross-device compatibility, and device capabilities (Capabilities) | complications-health | references/complications-health/README.md |
| Want to implement a permission flow to access body sensors (heart rate, etc.) in the background | complications-health | references/complications-health/README.md |
| Want to write Watch Face Format (WFF) XML elements, scenes, shapes, and time display | watch-face | references/watch-face/README.md |
| Want to handle WFF expressions, data sources, complication slots, and user settings | watch-face | references/watch-face/README.md |
| Want to check WFF build, debug, memory optimization, and version compatibility | watch-face | references/watch-face/README.md |
| Want to synchronize DataItem and Asset between devices (phone/watch) with DataClient | data-layer-communication | references/data-layer-communication/README.md |
| Want to send messages between devices (RPC-like one-way/request-response) with MessageClient | data-layer-communication | references/data-layer-communication/README.md |
| Want to detect nodes and app capabilities with NodeClient / CapabilityClient | data-layer-communication | references/data-layer-communication/README.md |
| Want to handle phone integration, authentication, and ongoing activities with RemoteActivityHelper / RemoteAuthClient / OngoingActivity | data-layer-communication | references/data-layer-communication/README.md |
Mobile's Jetpack Compose is android-compose-ui / android-compose-components is handled by (out of scope for this skill). Mobile home screen widgets (androidx.glance.appwidget / RemoteViews）は android-platform-core is handled by, but this skill's wear-widgets handles widgets on Wear OS based on Remote Compose (successors to full-screen tiles, carousel display), and is a separate API from these.