Jetpack Compose Glimmer for display glasses: agent skill guide

What the skill makes the agent do

Once the skill is loaded, the agent follows Glimmer design principles, workflows, and interaction models for the glasses form factor. It steers you away from Material 3 styling and toward Glimmer components, GlimmerTheme, focus handling, and text sizes that stay readable on additive (see-through) displays.

The skill also covers setup: Gradle dependencies, the projected activity manifest entry, and the Google Sans Flex font configuration.

• Uses GlimmerTheme and androidx.xr.glimmer components instead of MaterialTheme or Material 3
• Sets the projected activity entry in AndroidManifest.xml
• Configures Google Sans Flex typography with createGoogleSansFlexTypography()
• Keeps text at or above the minimum readable size of 18sp (0.6 degrees)

How to install the display glasses Glimmer skill

Download the ZIP for this skill from this page. Unzip it so the folder is named display-glasses-with-jetpack-compose-glimmer and sits in one of two places: ~/.claude/skills/ to make it available across your projects, or the .claude/skills/ folder inside a single project to limit it to that project.

You can also upload the skill in the Claude apps. Open Settings, go to Capabilities, then Skills, and upload the ZIP there.

• Personal install: ~/.claude/skills/
• Project install: .claude/skills/ inside your project folder
• Claude apps: Settings → Capabilities → Skills

How to trigger the skill with natural requests

You do not need a special command. Describe the glasses app you want in ordinary language and mention display glasses, Glimmer, or a projected Android XR app. The skill is written to load for requests to build an Android XR Augmented Experience app with Jetpack Compose Glimmer.

Requests that match the skill's scope work best. Be specific about the screen and the action the user takes.

• Build a projected Android XR app with a home screen and a list of cards for display glasses using Jetpack Compose Glimmer.
• Convert this phone Material 3 screen into a glanceable Glimmer layout for XR glasses.
• Add a Launch on Glasses button to my phone app that is disabled when the glasses are disconnected.
• Set up the manifest and Gradle dependencies for a projected activity on display glasses.

What you need before you start

The skill assumes you already work with Android Studio and a Gradle build. Your project must target a compileSdk at or above the level listed in SKILL.md, and it must use the minimum Glimmer, Google Fonts, and Projected artifact versions that file names. Check gradle/libs.versions.toml first. If catalog entries exist, the agent should use them and confirm they meet those minimums.

To run the app you need compatible Android XR display glasses paired to an Android phone.

• Android Studio and a Gradle build setup
• compileSdk at or above the level in SKILL.md
• androidx.xr.glimmer:glimmer and androidx.xr.glimmer:glimmer-google-fonts at the minimum alpha versions in SKILL.md
• androidx.xr.projected:projected at the minimum alpha version in SKILL.md
• Compatible Android XR display glasses paired to an Android phone

What the setup looks like

The projected activity must declare android:requiredDisplayCategory set to android.hardware.display.category.XR_PROJECTED. The launcher intent uses the XR_PROJECTED_LAUNCHER category, as in this manifest entry.

On the phone side, the skill has the agent observe ProjectedContext.isProjectedDeviceConnected to disable a Launch on Glasses button when no glasses are connected. The glasses activity is started with ProjectedContext.createProjectedActivityOptions(context).toBundle().

Design rules the agent will follow

On additive displays, pure black renders as fully transparent, so the skill has the agent apply a black background to the root container with Color.Black or GlimmerTheme.colors.background. Material 3 shadow and elevation modifiers are not supported; the skill points to ShadowScope or Depth tokens from Glimmer instead.

The skill also avoids Thin and Hairline font weights, which shimmer on additive lenses. Initial focus is set on focusable content during onCreate so input works from the start.

• Use GlimmerTheme and androidx.xr.glimmer.* components only
• Always pass createGoogleSansFlexTypography() as the typography in GlimmerTheme
• Keep text at 18sp or larger
• Avoid Thin and Hairline weights
• Use ShadowScope or Depth tokens instead of Material 3 elevation

Safety notes: scripts and network

This skill runs no scripts and uses no network access, according to its listing. It contains guidance and reference files that the agent reads while it writes your code.

The agent will still edit your project files and dependency declarations, so review its changes in Git or your normal code review before you build and install the app on glasses.

• Runs scripts: no
• Uses network: no
• Review Gradle and manifest changes before building

Tips for getting better results

Tell the agent which screen you are building and what the wearer should see at a glance. Glasses UI is limited, so short text and few choices work better than a phone layout squeezed onto a small display.

Know what the system handles. The glasses hardware controls such as the camera button, touchpad, and swipe down for back are handled by the system, so your app should not try to replace them.

• Name the screen and the one task it supports
• Ask for focus handling and button states explicitly
• Let the agent check gradle/libs.versions.toml before adding dependencies
• Do not ask for audio-only AI glasses support, which this skill excludes