wear-widgets

Implement Wear OS widgets using GlanceWearWidget and Remote Compose APIs.

9.3k|601|Updated Mar 16, 2026
Ready to run
npx skills add https://github.com/android/skills --skill wear-widgets-android
💬 Prompt for ChatGPT / Claude Chat▼
Please help me install this Agent Skill.
Skill: wear-widgets
Source: https://github.com/android/skills/tree/main/wear/wear-widgets
Command: npx skills add https://github.com/android/skills --skill wear-widgets-android

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? This Skill addresses the complexity of implementing Wear OS widgets which involve specific APIs like GlanceWearWidget and Remote Compose that differ from mobile development. ## Core Features & Use Cases - Widget Creation: Implement GlanceWearWidget with provideWidgetData returning WearWidgetDocument. - Remote Compose Integration: Build adaptive layouts using RemoteColumn, RemoteRow, and state wrappers. - Manifest and Service Registration: Configure AndroidManifest.xml and provider XML for widget discovery. - Migration: Convert legacy TileService to modern widgets. - Use Case: Create a custom widget for quick actions on a smartwatch. ## Quick Start Extend GlanceWearWidget and implement provideWidgetData to define the widget UI with Remote Compose primitives.

Frequently Asked Questions about wear-widgets

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a Wear OS widget?▼

Extend GlanceWearWidget and override provideWidgetData to return a WearWidgetDocument containing Remote Compose UI primitives.

What is the difference between GlanceWearWidget and GlanceAppWidget?▼

GlanceWearWidget targets Wear OS using Remote Compose while GlanceAppWidget is for mobile home screen widgets.

How do I register a widget in AndroidManifest.xml?▼

Add a service with the BIND_TILE_PROVIDER permission and meta-data pointing to the widget provider XML resource.

Can I migrate legacy TileService to Wear widgets?▼

Yes, replace the service with GlanceWearWidgetService and annotate it with @AssociateWithGlanceWearWidget.

What are the dimensions for widget picker previews?▼

SMALL container previews must be 448x168 px and LARGE must be 464x288 px at 320 dpi in drawable-nodpi.

How do I handle state in Remote Compose widgets?▼

Use rememberMutableRemoteInt to allocate remote state and valueChange to mutate it directly in the host process.