Aller au guide d’utilisation
material-3par hamen

Material 3 Skill.

Un skill Claude Code et Codex pour le design d'applications mobiles : implémente les tokens, composants et mises en page adaptatives de Material Design 3.

  • Applications mobiles
  • Code 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
En-tête et titres de section lus depuis le fichier source le 14/09/2026 · 31 218 caractères au total

01 Ce qu'il fait

Ce que fait le skill material-3 dans Claude Code et Codex

Résumé, workflow et sorties, tous lus dans le SKILL.md du skill.

D'après le SKILL.mdLu le 14-09-2026 · pas une exécution enregistrée

Dans les termes du Skill

Guide l'implémentation du Material Design 3 (Material You) de Google avec Jetpack Compose Material3 comme cible principale, plus Flutter et une voie web limitée via @material/web. Il couvre le système de tokens md.sys pour la couleur, l'échelle typographique, la forme, l'élévation et le mouvement, une référence rapide à plus de 30 composants avec leurs variantes, la mise en page adaptative et la navigation, la théming et la couleur dynamique, la matrice de plateforme M3 Expressive, ainsi que l'accessibilité.

Un mode d'audit note une application ou une page de 0 à 10 sur dix catégories et produit un rapport de conformité. Il s'adresse aux designers et développeurs qui ont besoin de valeurs par défaut MD3 concrètes : cinq classes de taille de fenêtre, une élévation tonale au lieu d'ombres, un système d'espacement de 8dp, et des largeurs de contenu maximales sur grandes fenêtres.

Ce qu'il produit

  • Un rapport de conformité MD3 en markdown avec un score global et des scores par catégorie, les problèmes critiques, les avertissements, les éléments conformes et les corrections prioritaires.
  • Un thème Compose construit à partir de MaterialTheme avec un colorScheme fourni par dynamicLightColorScheme, lightColorScheme ou du code de thème généré.
  • Un bloc de thème CSS de propriétés personnalisées md-sys, incluant une variante de thème sombre appliquée par media query ou classe.
Voir l'exemple de prompt ↗

Fonctionnement

  1. 01
    Partir de Compose sauf indication contraire de la stack

    Le fichier considère Jetpack Compose Material3 comme la voie par défaut, et l'arbre de décision oriente les coquilles d'application, composants uniques, thèmes, formulaires, navigation et affichage de données vers des sections et fichiers de référence spécifiques avant toute écriture de code.

  2. 02
    Appliquer la couche de tokens

    Tous les tokens MD3 vivent dans l'espace de noms md.sys ; Compose associe les mêmes rôles sémantiques à MaterialTheme.colorScheme, typography et shapes, tandis que le web les associe à des propriétés personnalisées CSS préfixées md-sys.

  3. 03
    Choisir les composants avec la Référence rapide

    Le tableau des composants liste le nom de l'élément web de chaque composant, ses variantes clés et sa catégorie, et signale ceux qui n'ont pas d'implémentation @material/web afin qu'ils puissent être construits avec des propriétés personnalisées CSS et du HTML standard à la place.

  4. 04
    Assembler avec les Patterns communs

    Les patterns App Shell, Card Grid et Form Layout sont fournis en HTML et CSS, avec un breakpoint qui transforme le rail de navigation en navigation basse sur les largeurs compactes.

  5. 05
    Auditer sur demande

    Invoqué avec audit, le skill inspecte une URL, des fichiers source ou une application en cours d'exécution et note dix catégories de 0 à 10 avant de rédiger le rapport.

02 Trouvez celui qui vous convient

Quand utiliser le skill material-3

Utilisez le skill material-3 dans Claude Code ou Codex lorsque la tâche concerne le design d'application mobile de ce type. La portée et les limites ci-dessous sont tirées du fichier du skill lui-même.

Bon choix

  • Créer un nouvel écran ou une nouvelle application Android dans Jetpack Compose avec des composables androidx.compose.material3 tels que Scaffold, Button et NavigationBar.
  • Générer un thème à partir du fond d'écran de l'utilisateur avec la couleur dynamique sur Android 12 et supérieur, avec repli sur des schémas clairs et sombres statiques sinon.
  • Une mise en page qui s'adapte au téléphone, au pliable, au bureau, à la montre et à la XR plutôt qu'un design fixe centré sur le téléphone.
  • Auditer une application ou une page existante selon MD3 et obtenir un rapport noté pour travailler.
  • Thématiser une UI web en définissant des propriétés personnalisées CSS MD3 sur la racine ou tout élément ancêtre.

Connaître les limites

  • Attendre des fonctionnalités M3 Expressive sur le web, car Material Web n'est qu'en maintenance et Expressive n'y est pas implémenté.
  • Un rendu côté serveur sans stratégie d'hydratation, car les composants web sont des éléments personnalisés qui nécessitent du JavaScript.
  • Des projets qui mélangent encore des bibliothèques Material 2 et Material 3, dont les API et le style sont incompatibles.
  • Des mises en page uniquement pour téléphone qui ignorent les grands écrans et les pliables, y compris du contenu interactif placé sur une charnière.

Quoi fournir

  • Un argument de tâcheLe skill prend un argument component, theme, layout, scaffold ou audit suivi d'une courte description ou d'une URL, ce qui sélectionne la section ou le fichier de référence à suivre.
  • Une cible à auditerPour le travail d'audit, fournissez une URL pour l'inspection dans le navigateur, des chemins de fichiers pour lire le code source, ou un accès à une application en cours d'exécution.
  • Une couleur de départ pour un thème personnaliséUne seule couleur de départ suffit pour dériver un schéma de couleurs complet ; le fichier renvoie au package material-color-utilities pour générer les valeurs.
  • Fichiers source pour les audits de codeLes audits Compose lisent les fichiers Kotlin pour repérer l'utilisation de MaterialTheme, les composables, les valeurs Color brutes, les Dp codés en dur et l'absence de sémantique.

03 Dans le skill

Les règles que le skill material-3 donne à Claude Code et Codex

8 instructions concrètes, valeurs par défaut et limites que le SKILL.md fixe pour l'agent — la partie du fichier qui change le résultat.

  1. Compose en priorité pour les nouveaux travaux Material

    Pour les nouveaux travaux Android, le fichier indique de privilégier Jetpack Compose Material3 pour les composants, les API expressives, les scaffolds adaptatifs et l'intégration de l'API Styles ; les Android Views ne sont acceptables que dans les applications existantes.

  2. Ne jamais codifier les couleurs en dur

    Utilisez les tokens md-sys-color plutôt que des valeurs hexadécimales ou rgb brutes, car les couleurs codées en dur cassent le theming dynamique, le mode sombre et l'ajustement du contraste.

  3. Respectez les associations tonales prévues

    Combinez les couleurs uniquement comme prévu, par exemple primary avec on-primary et surface-container avec on-surface ; des associations arbitraires cassent le contraste en mode couleur dynamique et en mode contraste élevé.

  4. Les séparateurs utilisent outline-variant

    Les séparateurs sont tracés avec outline-variant ; outline est réservé aux limites importantes comme les bordures de champs de texte.

  5. Importez les Web Components individuellement

    N'importez jamais le package @material/web en bloc ; importez uniquement les modules de composants utilisés, car tout importer détruit la taille du bundle.

  6. Contraignez la largeur sur les grandes fenêtres

    Sur les fenêtres Large (1200dp+) et Extra-large (1600dp+), le contenu est limité à une largeur maximale de 840-1040dp, car des lignes de texte à largeur infinie sont illisibles.

  7. L'élévation est tonale, pas une ombre

    MD3 communique l'élévation par la couleur tonale de surface plutôt que par des ombres ; les ombres ne sont ajoutées que lorsqu'un élément a besoin d'une séparation supplémentaire par rapport à un arrière-plan chargé.

  8. Roboto est correct en MD3

    Roboto ou Roboto Flex est la police Material par défaut, et le conseil frontend-design d'éviter Roboto ne s'applique pas ici ; ne le remplacez que si vous personnalisez intentionnellement l'échelle typographique.

04 Mettez-le en pratique

Installer material-3 dans Claude Code ou Codex

Une commande npx skills add, puis une première tâche dans votre agent et une checklist pour le résultat.

Ajouter material-3 à Claude Code, Codex ou Votre Agent

Exécutez-la dans votre projet ; l'installateur demande à quel agent l'ajouter.

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

Forme générique de la commande CLI skills pour skills/material-3/SKILL.md ; le dépôt peut documenter son propre chemin.

Donner au skill une première tâche de conception d'application mobile

Rédigé dans les termes propres du skill ; remplacez les parties entre crochets par votre contenu.

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.

Source : rédigé à partir du SKILL.md, dans les termes propres du skill.

Vérifiez le premier résultat

Ce que le SKILL.md lui-même présente comme un résultat correct :

  • Vérifiez les ratios de contraste et les zones tactiles, pas seulement l'usage des rôles MD3.
  • Recherchez dans les feuilles de style web des couleurs hexadécimales codées en dur.
  • Recherchez dans les sources Kotlin des valeurs Color brutes.
  • Recherchez dans le JavaScript et le TypeScript des imports Material 2 résiduels.
  • Redimensionnez la fenêtre ou utilisez le mode responsive pour vérifier la mise en page à chaque point de rupture.

Dans OpenDesign, importez material-3 depuis son lien SKILL.md : Plugins → Add → Skill → Import from link, puis sélectionnez-le dans la barre supérieure.

05 Open source, traçable

Source, licence et vérification

D'où proviennent les faits de cette page et quand ils ont été vérifiés pour la dernière fois.

Author
hamen
Repository
github.com/hamen/material-3-skill Branche master
Fichier du skill
skills/material-3/SKILL.md Somme de contrôle du contenu enregistrée lors de la vérification ; commit 14385f2
License
MIT D'après LICENSE.
Étoiles du dépôt
1 384 Instantané GitHub pris le 14/09/2026 pour l'ensemble du dépôt hamen/material-3-skill. Ce n'est ni une note ni un compteur d'utilisation pour material-3.
Vérifié par OpenDesign
2026-09-14 Le fichier source, le chemin, le texte de licence et le nombre d'étoiles ont été vérifiés. Non intégré dans OpenDesign main (vérifié le 2026-08-28) ; aucune exécution en conditions réelles n'a été enregistrée sur cette page.

Dans le SKILL.md

  1. PhilosophieTrois principes, personnel, adaptatif et expressif, qui définissent la couleur dynamique, les classes de taille de fenêtre et le mouvement spring.
  2. Arbre de décisionOriente ce que vous construisez et quelle plateforme vers des sections et fichiers de référence.
  3. Système de tokens de designTokens md.sys de couleur, typographie, forme, élévation et mouvement, avec mappages Compose et CSS.
  4. Référence rapide des composantsTableau de plus de 30 composants avec éléments web, variantes clés et catégorie.
  5. Jetpack Compose (principal)configuration androidx.compose.material3, MaterialTheme, couleur dynamique, UI adaptative et insets.
  6. Web (limité) : @material/webComposants web en mode maintenance, imports individuels, thématisation par propriétés CSS personnalisées et thème sombre.
  7. Motifs courantsExtraits d'app shell, de grille de cartes et de mise en page de formulaire en HTML et CSS.
  8. Anti-patternsInterdictions strictes couvrant le mélange MD2
Description du skill lui-même
« Implémentez le système UI Material Design 3 (Material You) de Google. Principal : Jetpack Compose Material3 (MaterialTheme, composants, mise en page adaptative). Également Flutter et web limité (@material/web, mode maintenance). Couvre tokens, plus de 30 composants, mise en page, thématisation, M3 Expressive (matrice de plateforme) et accessibilité. À utiliser quand : « material design », « MD3 », « material you », « Jetpack Compose », « MaterialTheme », « material component », « md3 button ». »

Description du front-matter de SKILL.md. Le fichier complet fait environ 31 218 caractères. Lire le fichier complet sur GitHub.

Material 3

Exécuter material-3 sur une Vraie Tâche de Design d'Application Mobile.

Téléchargez OpenDesign, importez material-3 depuis son lien SKILL.md, collez le prompt ci-dessus, et lisez le plan avant le résultat.

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

OpenDesign Desktop

Un seul design system. Votre marque, cohérente partout

Dans le Vibe Design Workspace complet, appliquez les mêmes règles de marque aux sites, slides, prototypes interactifs, dashboards, images et vidéos HTML. Connectez Codex, Claude Code, Cursor et vos autres agents de code locaux, puis créez gratuitement.

  • Sites, slides, prototypes, dashboards, images et vidéos
  • Plus de 140 design systems et la bibliothèque complète de modèles et skills
  • Codex local et plus de 21 agents de code · Gratuit
Télécharger gratuitement

Disponible sur macOS et Windows