What is the Material Design 3 UI skill?
The Material Design 3 UI skill is an unofficial Agent Skill by skydashnet. Its SKILL.md routes an AI coding agent through 13 reference files covering color roles, components, adaptive layouts, accessibility and M3 Expressive, so the agent picks components by behavior and reviews screens against written anti-patterns.
It is a reusable Agent Skill for designing, reviewing and implementing interfaces with Material Design 3, Material You and optional M3 Expressive. The README calls it a decision system for agents, not a collection of pretty defaults.
SKILL.md stays short and acts as a router. It sends the agent to focused files under references only when the task needs them, so a navigation task loads navigation rules and a form loads form and accessibility rules.
What changes in your agent's output
- Components are chosen by behavior and purpose, not by shape, so a chip is not used as a generic button.
- Screens use semantic color roles such as surface, onSurface and primary instead of scattered hex values.
- Layouts adapt by window width class, from compact under 600dp to extra large at 1600dp and up, instead of stretching a phone screen.
- Accessibility is treated as a release requirement: 48dp touch targets, visible focus, keyboard support and reduced motion.
- Every screen is reviewed against anti-patterns such as cards around every section and a primary color on everything.
Who the Material Design 3 skill is for
Best for
- Android and Jetpack Compose teams planning screens before they write code.
- Web projects that want M3 semantics, tokens and hierarchy without copying Android specifics.
- Design reviews and audits where an agent must name which M3 rule a screen breaks.
- Pairing with a general review skill such as web-design-guidelines.
Not for
- Brands that do not want Google's design language. The skill is built around M3 only.
- Exact API answers. The README says SKILL.md tells agents to check current official docs for dependency versions and newer Expressive APIs.
- Anyone expecting a generated visual style. It supplies rules, not artwork.
Use it with UiChemy
If the approved layout is going onto a WordPress site, UiChemy Composer writes the HTML, CSS and JS inside Elementor or Gutenberg. Review the result against the M3 rules afterwards. Click Get Started on uichemy.com.
How to install Material Design 3 UI Skill for AI Coding Agents
git clone https://github.com/skydashnet/material-design-3-ui-skill.git && cd material-design-3-ui-skill && ./install.shThe README also offers a curl one-line installer; cloning first makes the script easier to inspect.Clone the repository
Run the git clone line, then change into the folder. On Windows use the PowerShell installer, install.ps1, instead of install.sh.
Run the installer
The installer copies SKILL.md plus every referenced file to the global skill folders of supported agents. It does not install or launch any agent.
Pick agents if needed
Use the detect flag to install only for agents it finds, or the agent flag with names such as claude, codex, antigravity, kiro, opencode, hermes or openclaw.
Update later
Re-run the installer with the force flag after reviewing local edits. It never overwrites a different existing skill folder silently.
Check that it loaded
Ask the agent to audit one screen for incorrect Material 3 component usage. It should name the rules it applies and load the matching reference files.
Key features
- Progressive disclosureA compact SKILL.md routes to 13 reference files only when needed, which keeps context small while detailed rules stay available.
- Semantic color and tokensPrefers roles like surface, onSurface, primary, surfaceContainer and errorContainer over raw hex values and one-off radii.
- Behavior-based component choiceCovers buttons, FABs, chips, cards, lists, navigation bars, rails, drawers, tabs, text fields, menus, dialogs, sheets, snackbars and more.
- Adaptive layoutsDefines five width classes, list-detail and supporting-pane layouts, foldables, resizable windows and edge-to-edge behavior.
- Accessibility rulesTouch targets, contrast, focus, keyboard use, accessible names, text scaling, localization and reduced motion are part of the design step.
- M3 Expressive with restraintTreats Expressive as an optional layer, used only when it improves hierarchy, usability or recognition.
- Anti-fake-Material listRejects pill-shaped everything, shadows on every container, multiple competing FABs and tabs used as unrelated top navigation.
- Twelve-step workflowStarts with product and platform, then information architecture, hierarchy, layout, theme, components, states, accessibility and motion.
- Review contractA table of structure, theme, components, states, adaptive behavior, accessibility and expression to verify before approving a UI.
- Regression testsThe repo ships a static validator and behavioral cases for settings, dashboards, adaptive navigation, forms and fake-Material audits.
Frequently asked questions
What is the Material Design 3 UI skill?
It is an unofficial Agent Skill from skydashnet that teaches an AI coding agent to design, review and implement interfaces with Material Design 3. It carries a short SKILL.md and 13 reference files for color, components, adaptive layout, accessibility and motion.
Which agents does the Material Design 3 skill support?
The README lists Claude Code, OpenAI Codex, Google Antigravity, Kiro, OpenCode, Hermes Agent and OpenClaw, with a global install path for each. Every destination receives the same portable package of SKILL.md plus its references.
Does it only work for Android?
No. The guidance is intentionally broader than one framework. For Android and Jetpack Compose it favors current Material 3 Compose guidance, and for web it keeps M3 semantics, hierarchy, tokens and accessibility without copying Android-specific details.
How do I install it?
Clone the repository and run the install script, or use the curl one-liner shown in the README. The installer is filesystem-only, so it copies the skill into agent folders without configuring or launching any agent.
What is M3 Expressive and is it required?
M3 Expressive is Google's more emotive extension of Material 3. The skill supports it as an optional layer and states that expression must improve hierarchy, usability, recognition or emotional clarity rather than add noise.
Is this an official Google skill?
No. The README describes it as an unofficial community project that is not affiliated with, endorsed by or sponsored by Google. It also says the current official Material specification wins whenever the two disagree.
What should I use for general web design review?
Use this skill when you want Material rules specifically. For design-agnostic checks, web-design-guidelines reviews UI code, and accessibility-testing adds a WCAG 2.2 quick reference. tailwind-design-system covers tokens in Tailwind projects.


