Skip to content

Wear OS Widgets

Build, migrate and verify Wear OS widgets using Glance Wear and Remote Compose.

Repository
android/skills
Stars
10,278
Licence
Apache-2.0
Files
5 files

What it does

When installed, the agent knows how to create Wear OS watch widgets in an Android project using Google's Glance Wear and Remote Compose libraries. It walks through registering the widget service and provider XML in the manifest, writing the widget UI and local state, adding click actions, and creating picker preview images. It can also help migrate older ProtoLayout TileService tiles to widgets.

Great for

  • Android developers building or migrating Wear OS widgets
  • Teams moving legacy Wear OS tiles to the newer widget API

Skip it if

  • Mobile home screen widgets, which use AppWidgetProvider or GlanceAppWidget and are explicitly out of scope
  • Watch face complications or full-screen Wear OS activities, which the skill says it should not be used for

Try asking

  • “Create a Wear OS widget with a small and large container that shows today's step count”
  • “Migrate our existing TileService tile to a Wear OS widget”
  • “Add a counter to my watch widget using rememberMutableRemoteInt and a click action”
  • “Create rectangular PNG preview images for the widget picker”
Step-by-step guide: how to use Wear OS WidgetsInstall, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

    The ZIP contains the 5 original files, the Apache-2.0 licence and an attribution note.

    wear-widgets.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

    mkdir -p ~/.claude/skills && unzip wear-widgets.zip -d ~/.claude/skills/

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip wear-widgets.zip -d .claude/skills/

    Claude apps (web/desktop): Settings → Capabilities → Skills → Upload skill, and choose the ZIP.

  3. 3

    Ask for the task

    No special command needed — the agent reads the skill's description and loads it when your request matches. Try one of the prompts above.

Get better results

  • Ask the agent to create the widget in a specific module so it can check existing TileService and manifest entries first.
  • Review any Gradle changes yourself, since the skill asks permission before editing repo-wide Gradle files unless you requested widget or dependency setup.
  • Have the agent build the project and check previews, since the skill suggests running assembleDebug to confirm build health.

What's inside

  • references/previews-and-testing.md
  • references/remote-compose-layouts.md
  • references/state-and-actions.md
  • references/widget-service-and-manifest.md
  • SKILL.md

Redistributed unmodified from android/skills under the Apache-2.0 licence. The assessment was drafted with AI from the skill's files on 2026-10-29. Skills can instruct your agent to run code — read SKILL.md and any scripts before installing.