jetpack-compose-m3

Enforce compatible Wear OS Compose Material3 library and compiler configurations.

174|8|Updated Jan 9, 2024
One-click install
npx skills add https://github.com/klxiaoniu/QQVersionList --skill jetpack-compose-m3-klxiaoniu
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: jetpack-compose-m3
Source: https://github.com/klxiaoniu/QQVersionList/tree/main/.agents/skills/jetpack-compose-m3
Command: npx skills add https://github.com/klxiaoniu/QQVersionList --skill jetpack-compose-m3-klxiaoniu

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill prevents breaking changes when migrating Wear OS apps to Compose Material 3 by enforcing compatible dependency versions, Kotlin/Compose compiler rules, and safe component usage patterns.

Core Features & Use Cases

  • Wear OS Material3 migration guidance: Walks you through moving from Material 2.5 and Horologist to androidx.wear.compose.material3 with correct component mapping and expectations for updated UI defaults.
  • Version-accurate component sample usage: Requires extracting and reading official component samples from the *-samples-sources.jar artifacts before implementing or refactoring UI code.
  • TransformingLazyColumn best-practice checklist: Ensures the correct use of ScreenScaffold + TransformingLazyColumn, including required imports, padding forwarding, transformed height usage, and snapping behavior.
  • Common gotchas and guardrails: Mandates Gradle sync after version updates and prohibits “guessing fixes” via downgrades when unresolved references appear after a successful sync.

Quick Start

Tell the AI: “Migrate my Wear OS Compose code from Material 2.5 (and any Horologist usage) to Material3, using TransformingLazyColumn inside ScreenScaffold, and ensure I first extract and read the official component samples for the latest stable compose-material3 version.”

Frequently Asked Questions about jetpack-compose-m3

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

FAQPage Schema
How do I migrate Wear OS Compose from Material 2.5 to Material3 safely?▼

Migrate Wear OS Compose to Material3 by enforcing compatible library versions, Kotlin/Compose compiler rules, and mapping Horologist components to `androidx.wear.compose.material3` while validating Gradle sync.

What is the correct way to implement TransformingLazyColumn in Wear OS Material3?▼

Implement TransformingLazyColumn by placing it inside ScreenScaffold, forwarding padding correctly, using transformed height, and verifying snapping behavior against the component-specific checklist compliance rules.

Why do I get unresolved reference errors after updating to Compose Material3?▼

Unresolved reference errors after updating to Compose Material3 require a mandatory Gradle sync validation. Prohibit guessing fixes via dependency downgrades if references remain unresolved post-sync.

Where can I find official Wear OS Material3 component samples for AppScaffold?▼

Find official Wear OS Material3 component samples by strictly extracting and reading the version-matched `*-samples-sources.jar` artifacts before implementing or refactoring AppScaffold UI code.

Can I use Horologist components directly with AndroidX Wear Compose Material3?▼

Migrating from Horologist requires mapping to `androidx.wear.compose.material3` components and enforcing compatible library versions to prevent breaking changes and ensure correct UI defaults.