Перейти к руководству
material-3автор hamen

Material 3 Skill.

Навык для Claude Code и Codex в области дизайна мобильных приложений: реализует токены, компоненты и адаптивные макеты Material Design 3.

  • Мобильные приложения
  • UI-код
hamen/material-3-skill · skills/material-3/SKILL.mdSKILL.md
--- name: material-3 description: Implement Google's Material Design 3 (Material You) UI system. Primary: Jetpack Compose Material3 (MaterialTheme, components, adaptive layout). Also Flutter and limited web (@material/web, maintenance mode). Covers tokens, 30+ components, layout, theming, M3 Expressive (platform matrix), and accessibility. Use when: "material design", "MD3", "material you", "Jetpack Compose", "MaterialTheme", "material component", … --- ## Philosophy ## Current Updates: Google I/O 2026 ## Decision Tree ## Design Token System ## Jetpack Compose (primary) ## Web (limited): @material/web
Преамбула и заголовки разделов прочитаны из исходного файла 2026-09-14 · 31 218 символов полностью

01 Что делает

Что делает skill material-3 в Claude Code и Codex

Сводка, рабочий процесс и результаты — всё прочитано из SKILL.md этого skill.

Из SKILL.mdПрочитано 14.09.2026 · не запись выполнения

Словами самого skill

Направляет реализацию Material Design 3 (Material You) от Google с Jetpack Compose Material3 как основной целью, а также Flutter и ограниченным веб-путём через @material/web. Охватывает систему токенов md.sys для цвета, шкалы типографики, формы, возвышения и движения, краткий справочник по 30+ компонентам с их вариантами, адаптивную раскладку и навигацию, темизацию и динамический цвет, матрицу платформ M3 Expressive и доступность.

Режим аудита оценивает приложение или страницу от 0 до 10 по десяти категориям и формирует отчёт о соответствии. Он предназначен для дизайнеров и разработчиков, которым нужны конкретные значения по умолчанию MD3: пять классов размера окна, тональное возвышение вместо теней, система интервалов 8dp и максимальная ширина контента на больших окнах.

Что он выдаёт

  • Markdown-отчёт о соответствии MD3 с общей оценкой и оценками по каждой категории, критическими проблемами, предупреждениями, пройденными пунктами и приоритизированными исправлениями.
  • Тема Compose, построенная на MaterialTheme с colorScheme, предоставленной dynamicLightColorScheme, lightColorScheme или сгенерированным кодом темы.
  • Блок CSS-темы из пользовательских свойств md-sys, включая вариант тёмной темы, применяемый через media query или класс.
Смотрите пример запроса ↗

Как это работает

  1. 01
    Начинайте с Compose, если стек не указывает иначе

    Файл рассматривает Jetpack Compose Material3 как путь по умолчанию, и дерево решений направляет оболочки приложений, отдельные компоненты, темы, формы, навигацию и отображение данных к конкретным разделам и справочным файлам ещё до написания кода.

  2. 02
    Примените слой токенов

    Все токены MD3 находятся в пространстве имён md.sys; Compose сопоставляет те же семантические роли с MaterialTheme.colorScheme, typography и shapes, а веб сопоставляет их с CSS custom properties с префиксом md-sys.

  3. 03
    Выберите компоненты в разделе Quick Reference

    Таблица компонентов содержит для каждого компонента имя веб-элемента, ключевые варианты и категорию, а также отмечает те, у которых нет реализации @material/web, чтобы их можно было собрать из CSS custom properties и стандартного HTML.

  4. 04
    Собирайте с помощью Common Patterns

    Паттерны App Shell, Card Grid и Form Layout приведены в виде HTML и CSS, включая breakpoint, который превращает navigation rail в bottom navigation на компактных ширинах.

  5. 05
    Аудит по запросу

    При вызове с параметром audit skill проверяет URL, файлы исходного кода или работающее приложение и оценивает десять категорий по шкале от 0 до 10, прежде чем составить отчёт.

02 Определите своё применение

Когда использовать skill material-3

Используйте скилл material-3 в Claude Code или Codex, когда задача — дизайн мобильного приложения такого рода. Область применения и ограничения приведены из собственного файла скилла.

Хорошо подходит

  • Создание нового экрана или приложения Android в Jetpack Compose с использованием composable-функций androidx.compose.material3, таких как Scaffold, Button и NavigationBar.
  • Генерация темы из обоев пользователя с динамическим цветом на Android 12 и выше, с откатом к статичным светлой и тёмной схемам в остальных случаях.
  • Один layout, который адаптируется под телефон, складное устройство, десктоп, часы и XR, вместо фиксированного дизайна, ориентированного только на телефон.
  • Аудит существующего приложения или страницы по MD3 с получением отчёта с оценками, от которого можно отталкиваться.
  • Оформление веб-UI путём задания CSS custom properties MD3 на корневом или любом родительском элементе.

Знайте границы

  • Ожидание функций M3 Expressive в вебе, поскольку Material Web поддерживается только в режиме сопровождения, а Expressive там не реализован.
  • Server-side rendering без стратегии гидратации, поскольку веб-компоненты — это custom elements, которым нужен JavaScript.
  • Проекты, в которых до сих пор смешаны библиотеки Material 2 и Material 3, чьи API и стилизация несовместимы.
  • Layout только для телефонов, игнорирующий большие экраны и складные устройства, включая интерактивный контент, размещённый через петлю (hinge).

Что предоставить

  • Аргумент задачиSkill принимает аргумент component, theme, layout, scaffold или audit, за которым следует короткое описание или URL, что определяет, какой раздел или файл-справочник использовать.
  • Цель для аудитаДля работы по аудиту укажите URL для проверки в браузере, пути к файлам для чтения исходного кода или доступ к работающему приложению.
  • Исходный цвет для кастомной темыОдного исходного цвета достаточно для получения полной цветовой схемы; файл указывает на пакет material-color-utilities для генерации значений.
  • Исходные файлы для аудита кодаАудиты Compose читают файлы Kotlin, чтобы найти использование MaterialTheme, composable-функции, необработанные значения Color, жёстко заданные Dp и отсутствующую semantics.

03 Внутри скилла

Правила, которые skill material-3 задаёт Claude Code и Codex

8 конкретных инструкций, значений по умолчанию и ограничений, которые SKILL.md задаёт для агента — та часть файла, которая влияет на результат.

  1. Compose First для новой работы с Material

    Для новой работы на Android файл рекомендует предпочитать Jetpack Compose Material3 для компонентов, expressive API, адаптивных scaffold и интеграции со Styles API; Android Views допустимы только в существующих приложениях.

  2. Никогда не задавайте цвета напрямую в коде

    Используйте токены md-sys-color, а не необработанные hex- или rgb-значения, потому что жёстко заданные цвета нарушают динамическое оформление, тёмную тему и корректировку контраста.

  3. Соблюдайте предусмотренные тональные пары

    Сочетайте цвета только так, как задумано, например primary с on-primary и surface-container с on-surface; произвольные сочетания нарушают контраст в динамических цветовых схемах и режимах повышенного контраста.

  4. Разделители используют outline-variant

    Разделители рисуются с помощью outline-variant; outline зарезервирован для важных границ, таких как границы текстовых полей.

  5. Импортируйте веб-компоненты по отдельности

    Никогда не импортируйте пакет @material/web целиком (barrel import); импортируйте только используемые модули компонентов, потому что импорт всего пакета сильно увеличивает размер бандла.

  6. Ограничивайте ширину на больших окнах

    На больших (1200dp+) и очень больших (1600dp+) окнах ширина контента ограничена максимумом 840-1040dp, потому что текстовые строки бесконечной ширины нечитаемы.

  7. Возвышение выражается тоном, а не тенью

    MD3 передаёт возвышение через тональный цвет поверхности, а не через тени; тени добавляются только когда элементу нужно дополнительно выделиться на насыщенном фоне.

  8. Roboto — верный выбор в MD3

    Roboto или Roboto Flex — стандартный шрифт Material, и рекомендация frontend-design избегать Roboto здесь не применяется; заменяйте его только при осознанной настройке типографической шкалы.

04 Применение

Установите material-3 в Claude Code или Codex

Одна команда npx skills add, затем первая задача в вашем агенте и чек-лист для результата.

Добавьте material-3 в Claude Code, Codex или ваш агент

Запустите в своём проекте; установщик спросит, какому агенту его добавить.

Terminal
npx skills add https://github.com/hamen/material-3-skill --skill material-3

Общая форма CLI-команды skills для skills/material-3/SKILL.md; репозиторий может документировать собственный путь.

Дайте скиллу первую задачу по дизайну мобильного приложения

Написано в терминах самого skill; замените части в квадратных скобках своим материалом.

Starter prompt
We're moving our [Android app] from Material 2 to MD3. Set up MaterialTheme with dynamic color on Android 12+ and wire the md.sys color, type and shape tokens, then rebuild [screen name] as a Scaffold with a navigation rail on medium and expanded window size classes. We ship on foldables too, so keep interactive content off the hinge and constrain content width on large windows.

Источник: составлено по SKILL.md в терминах самого skill.

Проверьте первый результат

Что сам SKILL.md считает правильным результатом:

  • Проверяйте коэффициенты контраста и размеры зон касания, а не только использование ролей MD3.
  • Ищите в веб-стилях жёстко заданные hex-цвета.
  • Ищите в исходниках Kotlin необработанные значения Color.
  • Ищите в JavaScript и TypeScript оставшиеся импорты Material 2.
  • Изменяйте размер вьюпорта или используйте режим адаптивности, чтобы проверить макет на каждой контрольной точке.

В OpenDesign импортируйте material-3 по ссылке на его SKILL.md: Plugins → Add → Skill → Import from link, затем выберите его в верхней панели.

05 Открытый исходный код, проверяемость

Источник, лицензия и проверка

Откуда взяты факты на этой странице и когда они были последний раз проверены.

Author
hamen
Repository
github.com/hamen/material-3-skill Ветка master
Файл skill
skills/material-3/SKILL.md Контрольная сумма содержимого записана при верификации; коммит 14385f2
License
MIT Из LICENSE.
Звёзды репозитория
1 384 Снимок GitHub от 14.09.2026 для всего репозитория hamen/material-3-skill. Не является рейтингом или счётчиком использования для material-3.
Проверено OpenDesign
2026-09-14 Исходный файл, путь, текст лицензии и количество звезд были проверены. Не входит в основной комплект OpenDesign (проверено 2026-08-28); живой запуск не был записан на этой странице.

Внутри SKILL.md

  1. ФилософияТри принципа — персональность, адаптивность и выразительность, — определяющие динамический цвет, классы размеров окна и пружинную анимацию.
  2. Дерево решенийНаправляет к разделам и справочным файлам в зависимости от того, что вы создаёте и для какой платформы.
  3. Система design tokenТокены md.sys для цвета, типографики, формы, возвышения и анимации с маппингом на Compose и CSS.
  4. Краткий справочник компонентовТаблица из 30+ компонентов с веб-элементами, ключевыми вариантами и категорией.
  5. Jetpack Compose (основной)Настройка androidx.compose.material3, MaterialTheme, динамический цвет, адаптивный UI и отступы (insets).
  6. Web (ограниченно): @material/webВеб-компоненты в режиме поддержки, отдельные импорты, тема через CSS custom property и тёмная тема.
  7. Типовые паттерныФрагменты app shell, сетки карточек и макета форм на HTML и CSS.
  8. АнтипаттерныЖёсткие запреты, включая смешивание с MD2
Собственное описание skill
«Реализация системы UI Google Material Design 3 (Material You). Основное: Jetpack Compose Material3 (MaterialTheme, компоненты, адаптивная вёрстка). Также Flutter и ограниченная поддержка веба (@material/web, режим поддержки). Охватывает токены, более 30 компонентов, вёрстку, темизацию, M3 Expressive (матрица платформ) и доступность. Используется при: «material design», «MD3», «material you», «Jetpack Compose», «MaterialTheme», «material component», «md3 button».»

Описание из front-matter в SKILL.md. Полный файл составляет около 31 218 символов. Прочитайте полный файл на GitHub.

Material 3

Запустите material-3 на реальной задаче дизайна мобильного приложения.

Скачайте OpenDesign, импортируйте material-3 по ссылке на SKILL.md, вставьте приведённый выше промпт и ознакомьтесь с планом перед результатом.

Терминал
npx skills add https://github.com/hamen/material-3-skill --skill material-3

OpenDesign для компьютера

Одна дизайн-система. Единый образ бренда во всех материалах

В полном Vibe Design Workspace одни и те же правила бренда работают для сайтов, слайдов, интерактивных прототипов, дашбордов, изображений и HTML-видео. Подключите локальные Codex, Claude Code, Cursor и другие кодинг-агенты и создавайте бесплатно.

  • Сайты, слайды, прототипы, дашборды, изображения и видео
  • Более 140 дизайн-систем и полная библиотека шаблонов и навыков
  • Локальный Codex и более 21 кодинг-агента · Бесплатно
Скачать бесплатно

Для macOS и Windows