mcpField
A
android-wear

android-wear

github.com/fandhe-aiDevelopment440 installsUpdated 2d ago
Repository

About android-wear

A reference skill covering key official Wear OS APIs for Kotlin developers. Its task map leads to focused documentation for Compose, tiles, widgets, watch faces, health features, and communication between watch and phone.

Key features

  1. 01Wear Compose API references
  2. 02Tile and Wear Widget guidance
  3. 03Watch Face Format references
  4. 04Complication and Health Services guidance
  5. 05Phone-watch communication references
  6. 06Task-based reference navigation

Use cases

  1. 01Building Wear OS Compose screens
  2. 02Implementing tiles or Wear Widgets
  3. 03Creating Watch Face Format watch faces
  4. 04Syncing data between a phone and watch

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/fandhe-ai/agent-reference-skills --skill android-wear

After installing, type/android-wearin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

references/complications-health/
background-body-sensors.md
compatibility.md
complicationdatasourceservice.md
complicationdatasourceupdaterequester.md
complicationtext.md
datapointcontainer.md
datatype.md
debouncedgoal.md
exerciseclient.md
exerciseevent.md
healthservicescapabilities.md
healthservicesclient.md
healthservicespermissions.md
healthservicessimulation.md
longtextcomplicationdata.md
measureclient.md
monochromaticimagecomplicationdata.md
nodatacomplicationdata.md
passivemonitoringclient.md
rangedvaluecomplicationdata.md
README.md
shorttextcomplicationdata.md
smallimagecomplicationdata.md
references/data-layer-communication/
assets.md
capabilityclient.md
channelclient.md
cloud-backup-restore.md
data-layer-overview.md
dataclient.md
messageclient.md

Details

From the project README

Wear OS (Kotlin) リファレンス

Wear OS 公式ドキュメントの主要 API を網羅したスキル。 androidx.wear.compose.* はモバイルの androidx.compose.* とは別 API であり、同名コンポーネントでも取り違えに注意する。 ユーザーのタスクに応じて適切な README.md を読み、そこから個別ファイルへ辿ること。

ディレクトリ構成

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 で目的のページを特定する:

  1. 下記マッピング表でタスクに対応するカテゴリを探す
  2. そのカテゴリの references/{category}/README.md を参照して目的のページを特定する
  3. 該当ページの .md を Read して詳細を確認する

タスク → カテゴリ マッピング

タスクカテゴリ参照 README
Wear Compose でテーマ・画面骨格 (Scaffold/TimeText) を組みたいwear-composereferences/wear-compose/README.md
ScalingLazyColumn / TransformingLazyColumn でリスト表示したいwear-composereferences/wear-compose/README.md
Button / IconButton / SelectionControls / Card / Picker / Dialog を使いたいwear-composereferences/wear-compose/README.md
CurvedLayout / rotary input (クラウン・ベゼル) / ambient mode を実装したいwear-composereferences/wear-compose/README.md
Material 2.5 → Material 3 / Navigation 2 → Navigation 3 へ移行したい、Compose のパフォーマンスを最適化したいwear-composereferences/wear-compose/README.md
One-handed gestures (double pinch / wrist turn, Modifier.oneHandedGesture) を実装したいwear-composereferences/wear-compose/README.md
Wear OS の Compose Preview (@WearPreviewDevices / @WearPreviewFontScales / WearDevices) を設定したいwear-composereferences/wear-compose/README.md
Material3TileService で Tile を作りたい / Tiles 1.5・ProtoLayout 1.3 (Material 3) へ移行したいtilesreferences/tiles/README.md
Tile (TileService) を実装したいtilesreferences/tiles/README.md
ProtoLayout / Material3 タイル部品でレイアウトを組みたいtilesreferences/tiles/README.md
Tile のアクション・更新・プラットフォームデータ連携をしたいtilesreferences/tiles/README.md
Wear Widget (GlanceWearWidgetService) を実装したいwear-widgetsreferences/wear-widgets/README.md
Remote Compose (RemoteBox/RemoteColumn/RemoteText/RemoteButton) でウィジェットのレイアウトを組みたいwear-widgetsreferences/wear-widgets/README.md
Remote Compose の状態・アクション (rememberMutableRemote* / valueChange / pendingIntentAction) を扱いたいwear-widgetsreferences/wear-widgets/README.md
Tile から Wear Widget への移行を検討したいwear-widgetsreferences/wear-widgets/README.md
ComplicationDataSourceService とコンプリケーションデータ型を実装したいcomplications-healthreferences/complications-health/README.md
Health Services (MeasureClient/ExerciseClient/PassiveMonitoringClient) で運動・健康データを扱いたいcomplications-healthreferences/complications-health/README.md
Health Services の権限・シミュレーション・デバイス間互換性・端末機能 (Capabilities) を確認したいcomplications-healthreferences/complications-health/README.md
バックグラウンドで身体センサー (心拍数等) にアクセスする権限フローを実装したいcomplications-healthreferences/complications-health/README.md
Watch Face Format (WFF) の XML 要素・シーン・図形・時刻表示を書きたいwatch-facereferences/watch-face/README.md
WFF の式・データソース・コンプリケーションスロット・ユーザー設定を扱いたいwatch-facereferences/watch-face/README.md
Watch Face Designer (Figma プラグイン) で WFF の文字盤を作成・エクスポート・Google Play に公開したいwatch-facereferences/watch-face/README.md
WFF のビルド・デバッグ・メモリ最適化・バージョン対応を確認したいwatch-facereferences/watch-face/README.md
Data Layer API の全体像・client の選び方・ChannelClient (ストリーム / ファイル転送) を知りたいdata-layer-communicationreferences/data-layer-communication/README.md
クラウドバックアップ・新しいスマートフォンへのデータ移行 (onNodeMigrated)・スタンドアロンのネットワーク通信 (Wi-Fi 要求 / FCM) を扱いたいdata-layer-communicationreferences/data-layer-communication/README.md
DataClient で端末間 (phone/watch) の DataItem・Asset を同期したいdata-layer-communicationreferences/data-layer-communication/README.md
MessageClient で端末間メッセージ (RPC 的な一方向/リクエスト-レスポンス) を送りたいdata-layer-communicationreferences/data-layer-communication/README.md
NodeClient / CapabilityClient でノード・アプリ機能を検出したいdata-layer-communicationreferences/data-layer-communication/README.md
RemoteActivityHelper / RemoteAuthClient / OngoingActivity でフォンとの連携・認証・進行中アクティビティを扱いたいdata-layer-communicationreferences/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 である。

Comments

Markdown supported