Skip to content
Back to search

material-3-skill

MarketplaceWorks with Claude CodeGitHub

Material Design 3 (Material You) implementation skill for Jetpack Compose, Flutter, and web

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/hamen-material-3-skill/badge.svg)](/listings/hamen-material-3-skill)

HTML

<a href="/listings/hamen-material-3-skill"><img src="/api/listings/hamen-material-3-skill/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Recommended: `npx skills`

npx --yes skills add hamen/material-3-skill --skill material-3 -y

This is the preferred path for Codex, Claude Code, Cursor, and multi-agent setups because the repo follows the direct `skills/<name>/SKILL.md` layout.

Claude Code plugin install

Add this repository as a plugin marketplace, then install the `material-3` plugin from it.

From inside an interactive Claude Code session:

/plugin marketplace add hamen/material-3-skill
/plugin install material-3@material-3-skill

Or from your shell:

claude plugin marketplace add hamen/material-3-skill
claude plugin install material-3@material-3-skill

The root `.claude-plugin/marketplace.json` points at `skills/material-3`, where Claude Code reads `.claude-plugin/plugin.json` and registers `SKILL.md`.

Codex or manual skill install

Clone the repository, then link or copy `skills/material-3` into the skills directory your assistant reads:

git clone https://github.com/hamen/material-3-skill.git
cd material-3-skill

# Codex
mkdir -p ~/.codex/skills
ln -s "$(pwd)/skills/material-3" ~/.codex/skills/material-3

# Other SKILL.md loaders
ln -s "$(pwd)/skills/material-3" /path/to/your/skills/material-3

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 22 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. {
  2. "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
  3. "name": "material-3-skill",
  4. "description": "Material Design 3 (Material You) implementation skill for Jetpack Compose, Flutter, and web",
  5. "owner": {
  6. "name": "Ivan Morgillo"
  7. },
  8. "plugins": [
  9. {
  10. "name": "material-3",
  11. "description": "Implement Google's Material Design 3 (Material You) UI system: design tokens, 30+ components, adaptive layout, dynamic color theming, M3 Expressive, and accessibility. Primary focus Jetpack Compose; also Flutter and limited web (@material/web).",
  12. "author": { "name": "Ivan Morgillo" },
  13. "category": "development",
  14. "source": {
  15. "source": "git-subdir",
  16. "url": "https://github.com/hamen/material-3-skill.git",
  17. "path": "skills/material-3"
  18. },
  19. "tags": ["material-design", "material3", "jetpack-compose", "flutter", "android", "ui", "agent-skill"]
  20. }
  21. ]
  22. }
README.md · README · 230 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Material Design 3 Skill
  2. **Version 1.1.1 · released 2026-06-29** — Fixes Claude Code installation by shipping a plugin marketplace manifest; documents the working install commands.
  3. A comprehensive skill for AI coding assistants that can load `SKILL.md` files, covering Google's [Material Design 3](https://m3.material.io/) (Material You) UI system.
  4. [![Material Design 3](assets/m3-hero.png)](https://m3.material.io/)
  5. ---
  6. ## What's new
  7. ### 1.1.1 — 2026-06-29
  8. **Fixed — Claude Code installation.**
  9. - The repo now ships a plugin **marketplace manifest** at `.claude-plugin/marketplace.json` and moves the plugin manifest to `skills/material-3/.claude-plugin/plugin.json`. Previously the documented `claude plugin install github:hamen/material-3-skill` failed with *"not found in any configured marketplace"* ([#8](https://github.com/hamen/material-3-skill/issues/8)).
  10. - Documented the install paths that actually work — `npx skills` and the Claude Code marketplace flow (see [Installation](#installation)).
  11. - **Migration**: if you installed (or tried to) with the old `claude plugin install github:hamen/material-3-skill` command, reinstall with one of the commands in [Installation](#installation).
  12. Read the full release notes: [v1.1.1](https://github.com/hamen/material-3-skill/releases/tag/v1.1.1).
  13. ### 1.1.0 — 2026-05-20
  14. **Updated — Google I/O 2026 Material guidance.**
  15. - Added notes from [What’s new at Google I/O 2026](https://m3.material.io/blog/whats-new-at-io26): Expressive layout/scaffold, the 8dp spacing system, watch/XR form factors, expressive lists and menus, Compose-first Material Android, and expressive search/search app bar.
  16. Read the full release notes: [v1.1.0](https://github.com/hamen/material-3-skill/releases/tag/v1.1.0).
  17. ### 1.0.0 — 2026-05-20
  18. **Added — portable skill packaging.**
  19. - **Claude Code one-command install**: install directly with `claude plugin install github:hamen/material-3-skill`.
  20. - **Portable skill layout**: the skill now lives at `skills/material-3/SKILL.md`, with references under `skills/material-3/references/`.
  21. - **Plugin manifest**: `.claude-plugin/plugin.json` declares the `material-3` plugin metadata for Claude Code while keeping the skill content usable by other skill-aware assistants.
  22. > **Superseded in 1.1.1.** The `claude plugin install github:…` command above never worked and the plugin manifest has moved — use the current commands in [Installation](#installation).
  23. Read the full release notes: [v1.0.0](https://github.com/hamen/material-3-skill/releases/tag/v1.0.0).
  24. ---
  25. ## Table of contents
  26. - [What's new](#whats-new)
  27. - [What it does](#what-it-does)
  28. - [Platform support](#platform-support)
  29. - [How this skill was built](#how-this-skill-was-built)
  30. - [Sources](#sources)
  31. - [Process](#process)
  32. - [What this means for accuracy](#what-this-means-for-accuracy)
  33. - [Installation](#installation)
  34. - [Usage](#usage)
  35. - [Build MD3 components](#build-md3-components)
  36. - [Generate a theme](#generate-a-theme)
  37. - [Scaffold an app](#scaffold-an-app)
  38. - [Audit MD3 compliance](#audit-md3-compliance)
  39. - [What's included](#whats-included)
  40. - [Contributing](#contributing)
  41. - [License](#license)
  42. ## What it does
  43. - Guides AI coding assistants in generating **MD3-compliant UI** with correct design tokens, components, theming, layout, and accessibility
  44. - **Primary focus: Jetpack Compose** — `MaterialTheme`, Material 3 composables, adaptive layouts, edge-to-edge/insets, and current Compose Material3 patterns
  45. - Also covers **Flutter** (`useMaterial3`, `ColorScheme.fromSeed`, etc.) at a secondary level
  46. - **Web (`@material/web`)** is documented as a **limited** path: [Material Web is in maintenance mode](https://m3.material.io/develop/web) and **M3 Expressive is not implemented on Web**; use tokens and components knowing the ecosystem is not receiving active feature work
  47. - Covers **30+ components** with Compose-oriented mappings plus web element names where applicable, attributes, and examples in `skills/material-3/references/component-catalog.md`
  48. - Includes an **MD3 compliance audit** mode that scores apps across 10 categories (works for Compose/Kotlin, Flutter/Dart, and web/CSS)
  49. - Covers **M3 Expressive** plus the **Google I/O 2026** layout/component updates — see [SKILL.md](skills/material-3/SKILL.md), [layout-and-responsive.md](skills/material-3/references/layout-and-responsive.md), and [typography-and-shape.md](skills/material-3/references/typography-and-shape.md)
  50. ## Platform support
  51. | Platform | Role in this skill | Notes |
  52. |----------|---------------------|--------|
  53. | **Jetpack Compose** | **Primary** | Best match for current Material 3 implementation APIs, Expressive motion where available, adaptive navigation |
  54. | **Flutter** | Secondary | `ThemeData(useMaterial3: true)`, `ColorScheme.fromSeed`, community packages for dynamic color |
  55. | **Web** | Limited | `@material/web` + CSS custom properties; maintenance mode; no full Expressive parity |
  56. ## How this skill was built
  57. This skill was created collaboratively between a human and an AI coding agent. The information in the skill files is **distilled from publicly available sources** — it is not original design system documentation, but a curated reference assembled from official docs, library references, and training data.
  58. ### Sources
  59. Design token values, component specs, layout breakpoints, color roles, typography scales, and implementation patterns were gathered from:
  60. - **[m3.material.io](https://m3.material.io/)** — Google's official Material Design 3 documentation
  61. - **[What’s new at Google I/O 2026](https://m3.material.io/blog/whats-new-at-io26)** — Expressive layout, spacing, lists, menus, search, watch/XR, and Compose-first Android updates
  62. - **[Android Developers — Material Design 3 in Compose](https://developer.android.com/develop/ui/compose/designsystems/material3)** and **AndroidX Compose Material3** API references
  63. - **Model training data** — publicly available Material Design documentation, Flutter and Jetpack Compose documentation, `@material/web` references, and community guides
  64. - **[@material/web](https://github.com/material-components/material-web)** — used to verify web component element names, attributes, and import paths where web guidance is included
  65. ### Process
  66. 1. **Planning phase** — Main `skills/material-3/SKILL.md` plus focused reference files under `skills/material-3/references/`.
  67. 2. **Live site research** — m3.material.io is often a JavaScript-rendered SPA; browser automation helps verify current token values, component lists, and Expressive updates.
  68. 3. **Cross-referencing** — Official Compose and Flutter docs fill in copy-paste APIs; web sections stay secondary.
  69. 4. **Distillation** — Token tables, component templates, and layout examples normalized for consistency.
  70. 5. **Audit system** — 10-category MD3 compliance audit adaptable to Compose, Flutter, or web source trees.
  71. ### What this means for accuracy
  72. The skill is a **best-effort distillation** and may drift as Google updates the spec.
  73. - **Compose** guidance is prioritized for currency; prefer official Android docs for exact API signatures and BOM versions.
  74. - **Web**: Material Web is [in maintenance mode](https://m3.material.io/develop/web); M3 Expressive is **not** on Web. Examples may lag; verify against the [material-web](https://github.com/material-components/material-web) repo.
  75. - **M3 Expressive** (motion, emphasized type, shape morphing, new radii) varies by platform — see the Expressive sections in [SKILL.md](skills/material-3/SKILL.md).
  76. - Contributions and corrections are welcome.
  77. ## Installation
  78. ### Recommended: `npx skills`
  79. ```bash
  80. npx --yes skills add hamen/material-3-skill --skill material-3 -y
  81. ```
  82. This is the preferred path for Codex, Claude Code, Cursor, and multi-agent setups because the repo follows the direct `skills/<name>/SKILL.md` layout.
  83. ### Claude Code plugin install
  84. Add this repository as a plugin marketplace, then install the `material-3` plugin from it.
  85. From inside an interactive Claude Code session:
  86. ```text
  87. /plugin marketplace add hamen/material-3-skill
  88. /plugin install material-3@material-3-skill
  89. ```
  90. Or from your shell:
  91. ```bash
  92. claude plugin marketplace add hamen/material-3-skill
  93. claude plugin install material-3@material-3-skill
  94. ```
  95. The root `.claude-plugin/marketplace.json` points at `skills/material-3`, where Claude Code reads `.claude-plugin/plugin.json` and registers `SKILL.md`.
  96. ### Codex or manual skill install
  97. Clone the repository, then link or copy `skills/material-3` into the skills directory your assistant reads:
  98. ```bash
  99. git clone https://github.com/hamen/material-3-skill.git
  100. cd material-3-skill
  101. # Codex
  102. mkdir -p ~/.codex/skills
  103. ln -s "$(pwd)/skills/material-3" ~/.codex/skills/material-3
  104. # Other SKILL.md loaders
  105. ln -s "$(pwd)/skills/material-3" /path/to/your/skills/material-3
  106. ```
  107. ## Usage
  108. ### Build MD3 components
  109. ```
  110. /material-3 component Create a login form with email and password fields
  111. ```
  112. ### Generate a theme
  113. ```
  114. /material-3 theme Generate a theme from seed color #1A73E8
  115. ```
  116. ### Scaffold an app
  117. ```
  118. /material-3 scaffold Create a responsive app shell with navigation
  119. ```
  120. ### Audit MD3 compliance
  121. ```
  122. /material-3 audit [URL or file path]
  123. ```
  124. The audit scores your app across 10 categories (color tokens, typography, shape, elevation, components, layout, navigation, motion, accessibility, theming) and produces a detailed report with specific fixes. Targets may be **Compose/Kotlin**, **Flutter**, or **web** — see [SKILL.md](skills/material-3/SKILL.md) for per-stack checks.
  125. ## What's included
  126. | File | Description |
  127. |------|-------------|
  128. | `.claude-plugin/marketplace.json` | Claude Code marketplace manifest, points at the `material-3` plugin subdir |
  129. | `skills/material-3/.claude-plugin/plugin.json` | Claude Code plugin manifest for the `material-3` skill |
  130. | `skills/material-3/SKILL.md` | Main skill: philosophy, decision trees, token overview, component table, Compose-first notes, limited web patterns, audit procedure |
  131. | `skills/material-3/references/color-system.md` | Color roles, tonal palettes, dynamic color, baseline schemes (Compose + CSS) |
  132. | `skills/material-3/references/component-catalog.md` | Components with Compose mappings and `@material/web` where applicable |
  133. | `skills/material-3/references/theming-and-dynamic-color.md` | Theme generation, brand colors, dark mode — Compose first, then Flutter and web |
  134. | `skills/material-3/references/typography-and-shape.md` | Type scale, shape, elevation, motion — including Expressive platform notes |
  135. | `skills/material-3/references/navigation-patterns.md` | Nav selection, Compose-first patterns, responsive shell |
  136. | `skills/material-3/references/layout-and-responsive.md` | Breakpoints, canonical layouts, edge-to-edge/insets, foldables |
  137. | `CONTRIBUTING.md` | How to contribute without drifting the Compose-first story |
  138. ## Contributing
  139. See [CONTRIBUTING.md](CONTRIBUTING.md) for platform hierarchy (Compose-first), Expressive rules, and a PR checklist so documentation stays consistent.
  140. ## Made by
  141. I'm **Ivan** — Android dev, creator of this skill. When I'm not writing Compose
  142. tooling, I ship small apps. If this saved you time, take one for a spin:
  143. - 🎯 **[3 Things a Day](https://3things.day/?utm_source=github&utm_medium=readme&utm_campaign=material_3_skill)** — pick 3 things, finish them. That's the app.
  144. - 💪 **[StreakUp](https://streakup.fit/?utm_source=github&utm_medium=readme&utm_campaign=material_3_skill)** — push-up, squat & pull-up streak tracker.
  145. - 🌙 **[Bedtime Stories](https://bedtimestories.click/?utm_source=github&utm_medium=readme&utm_campaign=material_3_skill)** — AI bedtime stories your kid helps build.
  146. - 🃏 **[Blackjack Trainer 21](https://trainblackjack.app/?utm_source=github&utm_medium=readme&utm_campaign=material_3_skill)** — learn perfect basic strategy with spaced repetition.
  147. - 📚 **[Ebooks for Kindle](https://kindlegratis.fun/?utm_source=github&utm_medium=readme&utm_campaign=material_3_skill)** — free Kindle book deals, updated daily.
  148. - 🏊 **[Swimming Lane](https://swimminglane.app/?utm_source=github&utm_medium=readme&utm_campaign=material_3_skill)** — swim lap & workout tracker.
  149. - 🥫 **[No Waste Food](https://nowastefood.app/?utm_source=github&utm_medium=readme&utm_campaign=material_3_skill)** — track your pantry, stop wasting food.
  150. - 📱 **[Brainrot Tax](https://brainrottax.app/?utm_source=github&utm_medium=readme&utm_campaign=material_3_skill)** — a reality check on your screen time.
  151. - 🖼️ **[Epic AI Wallpapers](https://cwti-ltd.github.io/ai-wallpapers/?utm_source=github&utm_medium=readme&utm_campaign=material_3_skill)** — fresh AI wallpapers, every day.
  152. - 🧠 **[MyGoo](https://mygoo.fun/?utm_source=github&utm_medium=readme&utm_campaign=material_3_skill)** — daily trivia quiz game (Italian).
  153. Find me at [ivanmorgillo.com](https://ivanmorgillo.com/?utm_source=github&utm_medium=readme&utm_campaign=material_3_skill) · [@hamen](https://x.com/hamen).
  154. ## License
  155. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.