← all repositories
hamen/material-3-skill

Google’s design spec, compressed for LLM consumption

It distills Google’s sprawling Material 3 spec into a structured cheat sheet so AI assistants stop hallucinating design tokens.

1.1k stars Shell Coding Assistants
material-3-skill
Collecting fresh signals — velocity needs a few days of history.
collecting data…
star history

What it does

This repository is not a UI library; it is a curated knowledge pack formatted for SKILL.md-compatible AI assistants like Claude Code, Codex, and Cursor. It encodes Google’s Material Design 3 guidelines—components, color roles, typography, responsive layouts, and theming—into a reference the assistant can query while generating code. The primary target is Jetpack Compose, with secondary coverage for Flutter and limited, caveat-heavy notes for the web.

The interesting bit

The most practical feature is an MD3 compliance audit that scores an existing codebase across ten categories—color, typography, motion, accessibility—and suggests specific fixes. The entire skill is also a frank admission of platform inequality: it ranks Compose first, Flutter second, and essentially tells the web to fend for itself because Material Web is in maintenance mode and lacks M3 Expressive support.

Key highlights

  • Covers 30+ components with Compose-first mappings and token tables distilled from official Google docs and I/O 2026 updates.
  • Includes a 10-category compliance audit applicable to Compose/Kotlin, Flutter/Dart, or web/CSS projects.
  • Ships as a portable skills/material-3/SKILL.md bundle with a Claude Code plugin manifest, though the install path has already been revised once after the initial marketplace setup failed.
  • Explicitly flags itself as a “best-effort distillation” that may drift behind Google’s live spec.

Caveats

  • The web section is deliberately limited; the README notes Material Web is in maintenance mode and M3 Expressive is not implemented there.
  • Version 1.0.0 advertised a one-command Claude Code install that, by the author’s own admission in the 1.1.1 release notes, “never worked” and required a manifest shuffle to fix.
  • Because it is assembled from public documentation and training data rather than original specs, currency gaps are expected; the authors direct users to official Android docs for exact API signatures.

Verdict

Worth a look if you are building Android apps in Compose and want your AI assistant to stop inventing Material 3 color roles. Skip it if you are looking for a drop-in UI component library or authoritative source of truth that updates automatically with Google’s spec.

Frequently asked

What is hamen/material-3-skill?
It distills Google’s sprawling Material 3 spec into a structured cheat sheet so AI assistants stop hallucinating design tokens.
Is material-3-skill open source?
Yes — hamen/material-3-skill is open source, released under the MIT license.
What language is material-3-skill written in?
hamen/material-3-skill is primarily written in Shell.
How popular is material-3-skill?
hamen/material-3-skill has 1.1k stars on GitHub.
Where can I find material-3-skill?
hamen/material-3-skill is on GitHub at https://github.com/hamen/material-3-skill.

heatdrop uses Google Analytics to see which pages get read — nothing else. Your call. How we handle data.