Vai alla guida all’uso
material-3di hamen

Material 3 Skill.

Uno skill per Claude Code e Codex per il design di app mobile: implementa token, componenti e layout adattivi di Material Design 3.

  • Mobile Apps
  • Codice 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
Intestazione e intestazioni di sezione lette dal file upstream il 14/09/2026 · 31.218 caratteri in totale

01 Cosa fa

Cosa Fa la Skill material-3 in Claude Code e Codex

Sintesi, workflow e output, tutto letto dal SKILL.md della skill.

Dal SKILL.mdLetto il 14-09-2026 · non è un'esecuzione registrata

Nelle parole della skill

Guida all’implementazione del Material Design 3 (Material You) di Google, con Jetpack Compose Material3 come target principale, oltre a Flutter e a un percorso web limitato tramite @material/web. Copre il sistema di token md.sys per colore, typescale, forma, elevazione e movimento, un riferimento rapido a oltre 30 componenti con le loro varianti, layout adattivo e navigazione, theming e colore dinamico, la matrice della piattaforma M3 Expressive, e l’accessibilità.

Una modalità di audit valuta un’app o una pagina da 0 a 10 su dieci categorie e produce un report di conformità. È pensata per designer e sviluppatori che necessitano di valori predefiniti MD3 concreti: cinque classi di dimensione della finestra, elevazione tonale invece delle ombre, un sistema di spaziatura a 8dp e larghezze massime del contenuto sulle finestre grandi.

Che cosa produce

  • Un report di conformità MD3 in markdown con un punteggio complessivo e punteggi per categoria, problemi critici, avvisi, elementi conformi e correzioni prioritarie.
  • Un tema Compose costruito a partire da MaterialTheme con un colorScheme fornito da dynamicLightColorScheme, lightColorScheme o da codice di tema generato.
  • Un blocco di tema CSS di proprietà personalizzate md-sys, inclusa una variante di tema scuro applicata tramite media query o classe.
Vedi l'esempio di prompt ↗

Come funziona

  1. 01
    Partire da Compose a Meno che lo Stack non Indichi Altrimenti

    Il file considera Jetpack Compose Material3 come il percorso predefinito e l’Albero Decisionale indirizza shell dell’app, singoli componenti, temi, form, navigazione e visualizzazione dei dati verso sezioni specifiche e file di riferimento prima di scrivere qualsiasi codice.

  2. 02
    Applicare lo Strato di Token

    Tutti i token MD3 vivono nel namespace md.sys; Compose mappa gli stessi ruoli semantici su MaterialTheme.colorScheme, typography e shapes, mentre il web li mappa su custom properties CSS con prefisso md-sys.

  3. 03
    Scegliere i componenti dal Quick Reference

    La tabella dei componenti elenca per ciascun componente il nome dell'elemento web, le varianti principali e la categoria, e segnala quali non hanno un'implementazione @material/web, così da poterli costruire con custom properties CSS e HTML standard.

  4. 04
    Assemblare con i Common Patterns

    I pattern App Shell, Card Grid e Form Layout sono forniti come HTML più CSS, incluso un breakpoint che trasforma la navigation rail in bottom navigation alle larghezze compatte.

  5. 05
    Eseguire l'audit quando richiesto

    Invocata con audit, la skill esamina un URL, i file sorgente o un'app in esecuzione e assegna un punteggio da 0 a 10 a dieci categorie prima di scrivere il report.

02 Trova la tua applicazione

Quando usare lo skill material-3

Usa la skill material-3 in Claude Code o Codex quando il lavoro riguarda la progettazione di app mobile di questo tipo. Capacità e limiti indicati di seguito sono presi dal file della skill.

Buona applicazione

  • Costruire una nuova schermata o app Android in Jetpack Compose con composable androidx.compose.material3 come Scaffold, Button e NavigationBar.
  • Generare un tema dallo sfondo dell'utente con dynamic color su Android 12 e versioni successive, ricorrendo altrimenti a schemi chiari e scuri statici.
  • Un unico layout che si adatta tra telefono, dispositivo pieghevole, desktop, orologio e XR invece di un design fisso pensato prima per il telefono.
  • Verificare un'app o una pagina esistente rispetto a MD3 e ottenere un report con punteggio da cui partire.
  • Applicare un tema a una UI web impostando le custom properties CSS di MD3 sulla radice o su qualsiasi elemento antenato.

Conosci i limiti

  • Aspettarsi le funzionalità M3 Expressive sul web, poiché Material Web è in sola manutenzione ed Expressive non è implementato lì.
  • Il rendering lato server senza una strategia di hydration, perché i web component sono elementi personalizzati che richiedono JavaScript.
  • Progetti che mescolano ancora librerie Material 2 e Material 3, le cui API e styling sono incompatibili.
  • Layout pensati solo per telefono che ignorano schermi grandi e dispositivi pieghevoli, incluso contenuto interattivo posizionato attraverso una cerniera.

Cosa fornire

  • Un argomento del taskLa skill accetta un argomento component, theme, layout, scaffold o audit seguito da una breve descrizione o da un URL, che seleziona quale sezione o file di riferimento seguire.
  • Un target da sottoporre ad auditPer il lavoro di audit, fornire un URL per l'ispezione via browser, percorsi di file da cui leggere il codice sorgente, oppure l'accesso a un'app in esecuzione.
  • Un colore seme per la personalizzazione del temaUn singolo colore seme è sufficiente per derivare un intero schema colori; il file rimanda al package material-color-utilities per generare i valori.
  • File sorgente per gli audit del codiceGli audit su Compose leggono i file Kotlin per individuare l'uso di MaterialTheme, i composable, i valori Color grezzi, i Dp hard-coded e la semantica mancante.

03 Dentro la skill

Le regole che la skill material-3 dà a Claude Code e Codex

8 istruzioni concrete, valori predefiniti e limiti che il SKILL.md imposta per l'agente — la parte del file che cambia il risultato.

  1. Compose come priorità per i nuovi lavori Material

    Per i nuovi lavori Android il file indica di preferire Jetpack Compose Material3 per componenti, API espressive, scaffold adattivi e integrazione con la Styles API; le Android View sono accettabili solo nelle app esistenti.

  2. Non hard-codificare mai i colori

    Utilizzi i token md-sys-color piuttosto che valori hex o rgb grezzi, perché i colori hardcoded compromettono il theming dinamico, la modalità scura e la regolazione del contrasto.

  3. Mantenga le coppie tonali previste

    Combini i colori solo come previsto, ad esempio primary con on-primary e surface-container con on-surface; accoppiamenti arbitrari compromettono il contrasto in modalità colore dinamico e alto contrasto.

  4. I separatori usano outline-variant

    I separatori sono disegnati con outline-variant; outline è riservato ai confini importanti come i bordi dei campi di testo.

  5. Importi i Web Components individualmente

    Non importi mai in blocco il pacchetto @material/web; importi solo i moduli dei componenti utilizzati, perché importare tutto compromette le dimensioni del bundle.

  6. Limiti la larghezza sulle finestre grandi

    Sulle finestre Large (1200dp+) e Extra-large (1600dp+) il contenuto è limitato a una larghezza massima di 840-1040dp, perché righe di testo a larghezza infinita non sono leggibili.

  7. L'elevazione è tonale, non un'ombra

    MD3 comunica l'elevazione tramite il colore tonale della superficie piuttosto che con le ombre; le ombre vengono aggiunte solo quando un elemento necessita di una separazione extra da uno sfondo affollato.

  8. Roboto è corretto in MD3

    Roboto o Roboto Flex è il tipo di carattere Material predefinito e il consiglio di frontend-design di evitare Roboto non si applica; lo sostituisca solo quando personalizza intenzionalmente la scala tipografica.

04 Mettila al lavoro

Installa material-3 in Claude Code o Codex

Un comando npx skills add, poi un primo task nel tuo agente e una checklist per il risultato.

Aggiungi material-3 a Claude Code, Codex o al tuo agente

Eseguitelo nel Suo progetto; l'installer chiede a quale agente aggiungerlo.

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

Forma generica del CLI skills per skills/material-3/SKILL.md; il repository può documentare un proprio percorso.

Dai Allo Skill Un Primo Task Di Design Di App Mobile

Redatto nei termini propri della skill; sostituisca le parti tra parentesi con il suo materiale.

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.

Fonte: redatto a partire dal SKILL.md, nei termini propri della skill.

Verifica il primo risultato

Ciò che il SKILL.md stesso indica come risultato corretto:

  • Verifichi i rapporti di contrasto e le aree di tocco, non solo l'uso dei ruoli MD3.
  • Cerchi nei fogli di stile web i colori hex hardcoded.
  • Cerchi nei sorgenti Kotlin valori Color grezzi.
  • Cerchi in JavaScript e TypeScript importazioni residue di Material 2.
  • Ridimensioni il viewport o usi la modalità responsive per verificare il layout a ogni breakpoint.

In OpenDesign importi material-3 dal suo link SKILL.md: Plugins → Add → Skill → Import from link, poi lo selezioni nella barra superiore.

05 Open source, tracciabile

Sorgente, licenza e verifica

Da dove provengono i dati di questa pagina e quando sono stati verificati l'ultima volta.

Author
hamen
Repository
github.com/hamen/material-3-skill Branch master
File della skill
skills/material-3/SKILL.md Checksum del contenuto registrato alla verifica; commit 14385f2
License
MIT Da LICENSE.
Stelle del repository
1.384 Snapshot GitHub scattata il 14/09/2026 per l'intero repository hamen/material-3-skill. Non è una valutazione o un conteggio di utilizzo per material-3.
Verificato da OpenDesign
14/09/2026 File sorgente, percorso, testo della licenza e conteggio delle stelle sono stati verificati. Non inclusa in OpenDesign main (verificato il 28/08/2026); un'esecuzione live non è stata registrata in questa pagina.

All'interno di SKILL.md

  1. FilosofiaTre principi, personale, adattivo ed espressivo, che definiscono il colore dinamico, le classi di dimensione delle finestre e il motion a molla.
  2. Albero decisionaleIndirizza ciò che sta costruendo e la piattaforma verso sezioni e file di riferimento.
  3. Sistema di design tokenToken md.sys per colore, tipografia, forma, elevazione e motion, con mappature Compose e CSS.
  4. Riferimento rapido componentiTabella di oltre 30 componenti con elementi web, varianti principali e categoria.
  5. Jetpack Compose (principale)Configurazione di androidx.compose.material3, MaterialTheme, colore dinamico, UI adattiva e insets.
  6. Web (limitato): @material/webWeb components in modalità manutenzione, import individuali, theming tramite CSS custom property e tema scuro.
  7. Pattern comuniSnippet di app shell, card grid e layout dei form in HTML e CSS.
  8. Anti-patternDivieti categorici relativi al mix con MD2
Descrizione della skill
Implementa il sistema UI Material Design 3 (Material You) di Google. Primario: Jetpack Compose Material3 (MaterialTheme, componenti, layout adattivo). Anche Flutter e web limitato (@material/web, modalità manutenzione). Copre token, oltre 30 componenti, layout, tematizzazione, M3 Expressive (matrice piattaforma) e accessibilità. Usa quando: "material design", "MD3", "material you", "Jetpack Compose", "MaterialTheme", "componente material", "pulsante md3".

Descrizione del front-matter da SKILL.md. Il file completo è di circa 31.218 caratteri. Leggi il file completo su GitHub.

Material 3

Esegui material-3 su un task reale di design per app mobile.

Scarica OpenDesign, importa material-3 dal suo link SKILL.md, incolla il prompt qui sopra e leggi il piano prima del risultato.

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

OpenDesign Desktop

Un solo design system. Il tuo brand, coerente ovunque

Nel Vibe Design Workspace completo, applica le stesse regole di brand a siti, presentazioni, prototipi interattivi, dashboard, immagini e video HTML. Collega Codex, Claude Code, Cursor e gli altri agenti di coding locali e crea gratis.

  • Siti, presentazioni, prototipi, dashboard, immagini e video
  • Oltre 140 design system e la libreria completa di template e skill
  • Codex locale e oltre 21 agenti di coding · Gratis
Scarica gratis

Disponibile per macOS e Windows