Skip to content
Get packs

Wear OS Compose Material 3 Guide

Guides an agent to build, update, and migrate Wear OS apps using Wear Compose Material3 components

Source Download skill
Repository
android/skills
Stars
10,278
Licence
Apache-2.0
Files
15 files

What it does

This skill gives an AI coding agent detailed instructions and official sample code for building Wear OS smartwatch apps with the Jetpack Compose Material 3 library for Wear. Once installed, the agent checks the project's library versions, follows the recommended setup (Kotlin, minimum SDK, build tools), uses current Wear components such as AppScaffold, ScreenScaffold and TransformingLazyColumn in place of older Horologist or Material 2.5 ones, and consults canonical samples for components like buttons, dialogs, cards and ambient mode.

Great for

  • Android developers building or upgrading a Wear OS app with Compose
  • Teams migrating from Horologist or Wear Material 2.5 to Material 3
  • Developers who want an AI agent to write Wear components that follow Google's samples

Skip it if

  • Phone-only Android apps or non-Wear Compose projects, since the guidance targets Wear-specific libraries
  • Projects that must keep exact older visual output, because the skill tells the agent to accept changed Material 3 defaults and expect screenshot test failures

Try asking

  • “Migrate my Wear OS app from Horologist ScalingLazyColumn to TransformingLazyColumn”
  • “Add an ambient mode aware screen to my watch app using the Material 3 samples”
  • “Replace my Chip components with Wear Material 3 Buttons and check parameter names”
  • “Set up a new Wear OS Compose project with the current stable Material 3 version”
Step-by-step guide: how to use Wear OS Compose Material 3 GuideInstall, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

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

    wear-compose-m3.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

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

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip wear-compose-m3.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

  • Point the agent at your gradle/libs.versions.toml so it reads your current library version instead of guessing.
  • Ask for one component at a time so the agent can check the matching reference sample before editing.
  • Review the diff and run ./gradlew assembleDebug yourself, since the skill directs the agent to run builds and sync Gradle.

What's inside

  • references/foundation/AmbientModeSample.kt.md
  • references/foundation/CurvedWorldSample.kt.md
  • references/foundation/ExpandableSample.kt.md
  • references/foundation/HierarchicalFocusSample.kt.md
  • references/foundation/PagerSamples.kt.md
  • references/foundation/RotarySamples.kt.md
  • references/foundation/SwipeToDismissBoxSample.kt.md
  • references/foundation/TransformingLazyColumnSample.kt.md
  • references/material3/AlertDialogSample.kt.md
  • references/material3/AnimatedTextSample.kt.md
  • references/material3/ButtonGroupSample.kt.md
  • references/material3/ButtonSample.kt.md
  • references/material3/CardSample.kt.md
  • references/material3/CheckboxButtonSample.kt.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.