Agent skill

Android Material Guidelines

by zoonk in zoonk/zoonk

A skill your agent uses when designing, reviewing, or implementing Android UI or features for phones, tablets, foldables, ChromeOS, desktop windowing, Wear OS, Android TV, Android for Cars, Android…

MITAuto-check passedMobile

Install Android Material Guidelines

skills CLI
$ npx skills add zoonk/zoonk --skill android-material-guidelines -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install zoonk/zoonk android-material-guidelines --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/zoonk/zoonk.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/android-material-guidelines .claude/skills/android-material-guidelines && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
android-material-guidelines
GitHub stars
157
Token cost
~1.1k tokens
SKILL.md length
448 words
Files
2 (incl. references)
Skills in repo
12
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when designing, reviewing, or implementing Android UI or features for phones, tablets, foldables, ChromeOS, desktop windowing, Wear OS, Android TV, Android for Cars, Android…

  • Works in 5 steps: Identify every target surface: phone,… → Read the current official Android and… → If a Material page requires JavaScript,… → …
  • Implementing Android UI
  • SKILL.md covers Required Workflow, Product Rule, Design Defaults and Official Starting Points
  • Reaches m3.material.io

What it does

Android Material Guidelines is an agent skill from zoonk/zoonk. Use when designing, reviewing, or implementing Android UI or features for phones, tablets, foldables, ChromeOS, desktop windowing, Wear OS, Android TV, Android for Cars, Android XR, widgets, Jetpack Compose, Material 3, Material Design, adaptive layouts, dynamic color, icons, dark theme, edge-to-edge UI, accessibility, or when porting web or iOS features to Android. Ensures current official Android Developers and Material Design guidance is checked and Android conventions are preferred over copying other platforms.

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including reference files (for example `references/official-links.md`).

It sits in Mobile, covering Android development and Responsive design. It works with Android, iOS and Jetpack Compose. The repository describes itself as: Turn any topic into clear, structured lessons. The licence is MIT.

When your agent uses it

  • Implementing Android UI
  • Features for phones
  • Desktop windowing
  • Android for Cars

Example prompts

  • “/android-material-guidelines”

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Identify every target surface: phone, tablet, foldable, ChromeOS, desktop windowing, Wear OS, Android TV, Android for Cars, Android XR…
  2. Read the current official Android and Material pages that match the feature, component, interaction, and form factor. Start with…
  3. If a Material page requires JavaScript, use the official Material sitemap to find the current page
  4. Prefer Android and Material conventions first. Use custom UI only when Material components, Android system patterns, or form-factor…
  5. Before finishing, review the work against the relevant Android form-factor page, Material foundation pages, and component pages.

What it can do on your machine

Read from SKILL.md and the folder at commit e0fe2d6. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • m3.material.io

    Also links to:

    • developer.android.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Android Material Guidelines loads about 1.1k tokens when it runs, and up to ~2.8k if it reads all its reference files. Until then it costs about 137 tokens; SKILL.md has 448 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~137
When it runs · the whole SKILL.md, loaded when a task matches
~1.1k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~2.8k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from zoonk/zoonk at commit e0fe2d6, republished under its MIT licence (© zoonk). 448 words, ~1,069 tokens.

Download SKILL.mdSave it as .claude/skills/android-material-guidelines/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
android-material-guidelines
description
Use when designing, reviewing, or implementing Android UI or features for phones, tablets, foldables, ChromeOS, desktop windowing, Wear OS, Android TV, Android for Cars, Android XR, widgets, Jetpack Compose, Material 3, Material Design, adaptive layouts, dynamic color, icons, dark theme, edge-to-edge UI, accessibility, or when porting web or iOS features to Android. Ensures current official Android Developers and Material Design guidance is checked and Android conventions are preferred over copying other platforms.
license
MIT
metadata.author
zoonk
metadata.version
1.0.0

Android Material Guidelines

This skill is a workflow, not a frozen copy of Google's Android or Material Design docs. Google's official Android Developers and Material Design docs are the source of truth.

Required Workflow

  1. Identify every target surface: phone, tablet, foldable, ChromeOS, desktop windowing, Wear OS, Android TV, Android for Cars, Android XR, widgets, or other Android device categories.
  2. Read the current official Android and Material pages that match the feature, component, interaction, and form factor. Start with references/official-links.md.
  3. If a Material page requires JavaScript, use the official Material sitemap to find the current page:
    • https://m3.material.io/sitemap.xml
  4. Prefer Android and Material conventions first. Use custom UI only when Material components, Android system patterns, or form-factor guidance do not fit the product need.
  5. Before finishing, review the work against the relevant Android form-factor page, Material foundation pages, and component pages.

Product Rule

Preserve product intent, not web or iOS implementation details. Zoonk's main app is a web app, and Apple apps have their own conventions. When porting a feature to Android, do not map the same layout, navigation, density, controls, or visual treatment by default. Design the native version for the Android surface, screen size, and input method in front of you.

Examples:

  • Mobile Android should use Material 3, Android navigation patterns, edge-to-edge layout, system bars, touch targets, and adaptive layouts.
  • Tablets, foldables, ChromeOS, and desktop windowing should use window size classes, canonical layouts, panes, keyboard and pointer behavior, and resizable layouts.
  • Wear OS should favor glanceable, low-friction, wrist-sized interactions.
  • Android TV should optimize for focus, D-pad/remote input, distance from the screen, and clear selected states.
  • Android for Cars should follow car templates and driver-distraction constraints.
  • Android XR should use XR-specific spatial guidance instead of flattening a phone UI into a headset.
Show full SKILL.md (153 more words)Show less

Design Defaults

  • Prefer Jetpack Compose with Material 3 components for new native Android UI unless the local app architecture requires Views.
  • Prefer Material color schemes, dynamic color where appropriate, semantic roles, typography, shape, motion, and design tokens.
  • Prefer Material Symbols or platform-standard icons for standard actions and objects. Use custom icons only when no official symbol communicates the concept.
  • Support dark theme, accessibility, font scaling, contrast, reduced motion, system gestures, edge-to-edge behavior, and proper system bar handling.
  • Use platform-provided components and AndroidX libraries before custom controls.
  • Keep platform differences intentional. A feature can share the same domain model and product goal across Android, Apple, and web while using different native UI on each platform.

Official Starting Points

© zoonk, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file (references) in .agents/skills/android-material-guidelines of zoonk/zoonk.

  • SKILL.md
  • references/official-links.md

Open the folder on GitHubat commit e0fe2d6

Compare with similar skills

Android Material Guidelines next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Android Material Guidelines compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Android Material Guidelines this skillzoonk/zoonk157—~1.1kAutomated safety check: PassMIT
Android Designhashgraph-online/awesome-codex-plugins1.2k—~2.5kAutomated safety check: PassApache-2.0
Jetpack Compose and Multiplatform Expertrcosteira79/android-skills150—~2.6kAutomated safety check: PassMIT
Android Compose Patternsmakifbaysal/tasktrooper109—~1.9kAutomated safety check: PassApache-2.0
Accessible Mobile DeveloperFerroxLabs/wayland608—~3.6kAutomated safety check: PassApache-2.0
Jetpack Compose Expertaldefy/compose-skill596—~4.8kAutomated safety check: PassCustom licence

Similar skills

  • Android Design

    hashgraph-online/awesome-codex-plugins

    A skill your agent uses when the user asks for an Android app, Compose UI, Material 3, Material You, Material 3 Expressive, Pixel-style app, foldable/adaptive layout, Play Store deliverable, React…

    1.2k GitHub stars~2.5k tokensUpdated yesterday
    MobileAuto-check passed
  • Guides writing correct, performant Compose and Compose Multiplatform UI across Android, desktop, iOS and web, from state and animation to design-to-code and crash fixes.

    150 GitHub stars~2.6k tokensUpdated 18 days ago
    MobileAuto-check passed
  • Android Compose Patterns

    makifbaysal/tasktrooper

    A skill your agent uses when building native Android with Jetpack Compose - stateless composables, state hoisting, ViewModel-owned state, edge-to-edge, predictive back, adaptive layout, atomic…

    109 GitHub stars~1.9k tokensUpdated 2 days ago
    MobileAuto-check passed
  • Accessible Mobile Developer

    FerroxLabs/wayland

    Mobile accessibility development expertise covering iOS VoiceOver and Android TalkBack integration, accessibility APIs for SwiftUI and Jetpack Compose, touch target sizing, gesture alternatives…

    608 GitHub stars~3.6k tokensUpdated yesterday
    MobileAuto-check passed
  • Jetpack Compose Expert

    aldefy/compose-skill

    Guides Jetpack Compose and Compose Multiplatform work across Android, Desktop, iOS and web, plus Android TV, Material 3 motion, paging, navigation and design-to-code.

    596 GitHub stars~4.8k tokensUpdated 2 mo ago
    MobileAuto-check passed
  • Jetpack Compose

    darriousliu/PiPixiv

    Jetpack Compose expert skill for Android UI development. An agent skill from darriousliu/PiPixiv.

    262 GitHub stars~1.5k tokensUpdated yesterday
    MobileAuto-check passed

More from zoonk/zoonk

All 12 skills in this repo
  • Workflow

    zoonk/zoonk

    Creates durable, resumable workflows using Vercel's Workflow DevKit.

    157 GitHub stars~3.1k tokensUpdated 5 days ago
    Auto-check passed
  • A skill your agent uses when designing, reviewing, or implementing any Apple-platform UI or feature for iOS, iPadOS, macOS, visionOS, tvOS, watchOS, SwiftUI, UIKit, AppKit, WatchKit, app icons, Dark…

    157 GitHub stars~942 tokensUpdated 5 days ago
    Auto-check passed
  • Create or update problem-focused Zoonk GitHub issues and their requested metadata or relationships.

    157 GitHub stars~632 tokensUpdated 5 days ago
    Auto-check passed
  • Turn on Partial Prefetching in a Next.js app and work through the insights it surfaces.

    157 GitHub stars~6.8k tokensUpdated 5 days ago
    Auto-check passed
  • Zoonk Commit

    zoonk/zoonk

    Write Zoonk commit messages and PR titles or descriptions when preparing a commit or pull request.

    157 GitHub stars~578 tokensUpdated 5 days ago
    Auto-check passed
  • Create or refactor reusable Zoonk React UI primitives using flat compound components.

    157 GitHub stars~583 tokensUpdated 5 days ago
    Auto-check passed

Questions about Android Material Guidelines

What does Android Material Guidelines do?

A skill your agent uses when designing, reviewing, or implementing Android UI or features for phones, tablets, foldables, ChromeOS, desktop windowing, Wear OS, Android TV, Android for Cars, Android…. Android Material Guidelines is an agent skill from zoonk/zoonk. Use when designing, reviewing, or implementing Android UI or features for phones, tablets, foldables, ChromeOS, desktop windowing, Wear OS, Android TV, Android for Cars, Android XR, widgets, Jetpack Compose, Material 3, Material Design, adaptive layouts, dynamic color, icons, dark theme, edge-to-edge UI, accessibility, or when porting web or iOS features to Android.

When should I use Android Material Guidelines?

Android Material Guidelines fits situations like: implementing Android UI; features for phones; desktop windowing; android for Cars.

How do I install Android Material Guidelines in Claude Code?

Run `npx skills add zoonk/zoonk --skill android-material-guidelines -a claude-code`. Or copy the skill folder (.agents/skills/android-material-guidelines in zoonk/zoonk) into .claude/skills/android-material-guidelines in your project. Claude Code loads it when a task matches its description.

How do I install Android Material Guidelines in Codex?

Run `npx skills add zoonk/zoonk --skill android-material-guidelines -a codex`. Or copy the skill folder (.agents/skills/android-material-guidelines in zoonk/zoonk) into .agents/skills/android-material-guidelines in your project. Codex loads it when a task matches its description.

Can I use Android Material Guidelines in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add zoonk/zoonk --skill android-material-guidelines -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/android-material-guidelines, .gemini/skills/android-material-guidelines, .github/skills/android-material-guidelines and .opencode/skills/android-material-guidelines in your project.

What does Android Material Guidelines need to run?

SKILL.md names no scripts, command-line tools or credentials: Android Material Guidelines is instructions for the agent only.

Does Android Material Guidelines access the network?

SKILL.md names 2 domains. In commands or code: m3.material.io; the agent is likely to contact it when it follows the instructions. As links in the text: developer.android.com. This is read from the text; nothing was executed.

Is Android Material Guidelines safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Android Material Guidelines use?

Android Material Guidelines is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Android Material Guidelines use?

About 1.1k tokens (SKILL.md is roughly 4.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.7k tokens, read only when the agent opens those files.

What are the alternatives to Android Material Guidelines?

Skills that share tags, products or a category with Android Material Guidelines: Android Design (hashgraph-online/awesome-codex-plugins, 1.2k stars), Jetpack Compose and Multiplatform Expert (rcosteira79/android-skills, 150 stars), Android Compose Patterns (makifbaysal/tasktrooper, 109 stars) and Accessible Mobile Developer (FerroxLabs/wayland, 608 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Android Material Guidelines?

zoonk (a GitHub organization) maintains it in zoonk/zoonk, which has 157 GitHub stars. The repository holds 12 skills in this directory. The repository was last updated on October 2, 2026.

Source: zoonk/zoonk on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.