android-wear
Wear OS (Kotlin) の androidx.wear API・Watch Face Format (WFF) リファレンス。 Wear Compose の CurvedLayout, rotary input, ambient mode, ScalingLazyColumn。 Tiles / Material3TileService / ProtoLayout, ComplicationDataSourceService, ComplicationData, Health Services (MeasureClient, ExerciseClient, PassiveMonitoringClient), Data Layer (ChannelClient), WFF の XML 要素・式・コンプリケーション・Watch Face Designer。
How do I install this agent skill?
npx skills add https://github.com/fandhe-ai/agent-reference-skills --skill android-wearIs this agent skill safe to install?
- Gen Agent Trust Hubpass
This skill is a comprehensive documentation and API reference for Wear OS development, covering Kotlin-based APIs, Wear Compose, Tiles, and Watch Face Format. It contains no executable code and poses no security risks.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
Wear OS (Kotlin) リファレンス
Wear OS 公式ドキュメントの主要 API を網羅したスキル。
androidx.wear.compose.* はモバイルの androidx.compose.* とは別 API であり、同名コンポーネントでも取り違えに注意する。
ユーザーのタスクに応じて適切な README.md を読み、そこから個別ファイルへ辿ること。
対象バージョン
- 取得日 2026-11-14 時点の AndroidX stable:
androidx.wear.compose:compose-material31.7.1、androidx.wear.tiles:tiles1.6.2、androidx.wear.protolayout:protolayout1.4.2。 - Wear Compose 1.8.0-alpha(alpha03 まで)、
glance.wear/wear.compose.remote/compose.remoteの alpha は stable 基調のため大半が未収録(wear-widgets は alpha を各ページに明記)。 health-services-clientと Watch Face Format の最新版は未確認。
ディレクトリ構成
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
one-handed-gestures.md
previews.md
migrate-to-material3.md
migrate-to-navigation3.md
performance.md
tiles/
README.md
tile-service.md
material3-tile-service.md
migrate-tiles.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
watch-face-designer.md
watch-face-designer-advanced.md
watch-face-designer-export.md
data-layer-communication/
README.md
data-layer-overview.md
assets.md
capabilityclient.md
channelclient.md
cloud-backup-restore.md
dataclient.md
messageclient.md
network-access.md
nodeclient.md
ongoingactivity.md
remoteactivityhelper.md
remoteauthclient.md
transfer-to-new-mobile.md
wearablelistenerservice.md
探索手順
タスクからカテゴリを引き、カテゴリの README.md で目的のページを特定する:
- 下記マッピング表でタスクに対応するカテゴリを探す
- そのカテゴリの
references/{category}/README.mdを参照して目的のページを特定する - 該当ページの
.mdを Read して詳細を確認する
タスク → カテゴリ マッピング
| タスク | カテゴリ | 参照 README |
|---|---|---|
| Wear Compose でテーマ・画面骨格 (Scaffold/TimeText) を組みたい | wear-compose | references/wear-compose/README.md |
| ScalingLazyColumn / TransformingLazyColumn でリスト表示したい | wear-compose | references/wear-compose/README.md |
| Button / IconButton / SelectionControls / Card / Picker / Dialog を使いたい | wear-compose | references/wear-compose/README.md |
| CurvedLayout / rotary input (クラウン・ベゼル) / ambient mode を実装したい | wear-compose | references/wear-compose/README.md |
| Material 2.5 → Material 3 / Navigation 2 → Navigation 3 へ移行したい、Compose のパフォーマンスを最適化したい | wear-compose | references/wear-compose/README.md |
| One-handed gestures (double pinch / wrist turn, Modifier.oneHandedGesture) を実装したい | wear-compose | references/wear-compose/README.md |
| Wear OS の Compose Preview (@WearPreviewDevices / @WearPreviewFontScales / WearDevices) を設定したい | wear-compose | references/wear-compose/README.md |
| Material3TileService で Tile を作りたい / Tiles 1.5・ProtoLayout 1.3 (Material 3) へ移行したい | tiles | references/tiles/README.md |
| Tile (TileService) を実装したい | tiles | references/tiles/README.md |
| ProtoLayout / Material3 タイル部品でレイアウトを組みたい | tiles | references/tiles/README.md |
| Tile のアクション・更新・プラットフォームデータ連携をしたい | tiles | references/tiles/README.md |
| Wear Widget (GlanceWearWidgetService) を実装したい | wear-widgets | references/wear-widgets/README.md |
| Remote Compose (RemoteBox/RemoteColumn/RemoteText/RemoteButton) でウィジェットのレイアウトを組みたい | wear-widgets | references/wear-widgets/README.md |
| Remote Compose の状態・アクション (rememberMutableRemote* / valueChange / pendingIntentAction) を扱いたい | wear-widgets | references/wear-widgets/README.md |
| Tile から Wear Widget への移行を検討したい | wear-widgets | references/wear-widgets/README.md |
| ComplicationDataSourceService とコンプリケーションデータ型を実装したい | complications-health | references/complications-health/README.md |
| Health Services (MeasureClient/ExerciseClient/PassiveMonitoringClient) で運動・健康データを扱いたい | complications-health | references/complications-health/README.md |
| Health Services の権限・シミュレーション・デバイス間互換性・端末機能 (Capabilities) を確認したい | complications-health | references/complications-health/README.md |
| バックグラウンドで身体センサー (心拍数等) にアクセスする権限フローを実装したい | complications-health | references/complications-health/README.md |
| Watch Face Format (WFF) の XML 要素・シーン・図形・時刻表示を書きたい | watch-face | references/watch-face/README.md |
| WFF の式・データソース・コンプリケーションスロット・ユーザー設定を扱いたい | watch-face | references/watch-face/README.md |
| Watch Face Designer (Figma プラグイン) で WFF の文字盤を作成・エクスポート・Google Play に公開したい | watch-face | references/watch-face/README.md |
| WFF のビルド・デバッグ・メモリ最適化・バージョン対応を確認したい | watch-face | references/watch-face/README.md |
| Data Layer API の全体像・client の選び方・ChannelClient (ストリーム / ファイル転送) を知りたい | data-layer-communication | references/data-layer-communication/README.md |
| クラウドバックアップ・新しいスマートフォンへのデータ移行 (onNodeMigrated)・スタンドアロンのネットワーク通信 (Wi-Fi 要求 / FCM) を扱いたい | data-layer-communication | references/data-layer-communication/README.md |
| DataClient で端末間 (phone/watch) の DataItem・Asset を同期したい | data-layer-communication | references/data-layer-communication/README.md |
| MessageClient で端末間メッセージ (RPC 的な一方向/リクエスト-レスポンス) を送りたい | data-layer-communication | references/data-layer-communication/README.md |
| NodeClient / CapabilityClient でノード・アプリ機能を検出したい | data-layer-communication | references/data-layer-communication/README.md |
| RemoteActivityHelper / RemoteAuthClient / OngoingActivity でフォンとの連携・認証・進行中アクティビティを扱いたい | data-layer-communication | references/data-layer-communication/README.md |
モバイルの Jetpack Compose は android-compose-ui / android-compose-components が担当する(本スキルの対象外)。モバイルのホーム画面ウィジェット(androidx.glance.appwidget / RemoteViews)は android-platform-core が担当するが、本スキルの wear-widgets は Remote Compose ベースの Wear OS 上のウィジェット(フルスクリーンタイルの後継、カルーセル表示)を扱い、これらとは別 API である。
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/fandhe-ai/agent-reference-skills/android-wear">View android-wear on skillZs</a>