Ir a la guía de uso
material-3por hamen

Material 3 Skill.

Un skill de Claude Code y Codex para diseño de aplicaciones móviles: implementa tokens, componentes y layouts adaptativos de Material Design 3.

  • Mobile Apps
  • Código 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
Encabezados de sección y metadatos leídos del archivo original el 14 de septiembre de 2026 · 31 218 caracteres en total

01 Qué hace

Qué Hace el Skill material-3 en Claude Code y Codex

Resumen, flujo de trabajo y resultados, todo leído del SKILL.md del skill.

Del SKILL.mdLeído 2026-09-14 · no es una ejecución registrada

En los propios términos del Skill

Guía la implementación de Material Design 3 (Material You) de Google con Jetpack Compose Material3 como objetivo principal, además de Flutter y una ruta web limitada mediante @material/web. Cubre el sistema de tokens md.sys para color, escala tipográfica, forma, elevación y movimiento, una referencia rápida a más de 30 componentes con sus variantes, diseño adaptable y navegación, theming y color dinámico, la matriz de plataforma M3 Expressive, y accesibilidad.

Un modo de auditoría califica una app o una página de 0 a 10 en diez categorías y produce un informe de cumplimiento. Está pensado para diseñadores y desarrolladores que necesitan valores predeterminados concretos de MD3: cinco clases de tamaño de ventana, elevación tonal en lugar de sombras, un sistema de espaciado de 8dp y anchos de contenido máximos en ventanas grandes.

Qué produce

  • Un informe de cumplimiento MD3 en markdown con una puntuación general y puntuaciones por categoría, problemas críticos, advertencias, elementos que cumplen y correcciones priorizadas.
  • Un tema de Compose construido a partir de MaterialTheme con un colorScheme provisto por dynamicLightColorScheme, lightColorScheme o código de tema generado.
  • Un bloque de tema CSS de propiedades personalizadas md-sys, incluida una variante de tema oscuro aplicada mediante media query o clase.
Ver el ejemplo de prompt ↗

Cómo funciona

  1. 01
    Empezar por Compose a Menos que la Pila Indique lo Contrario

    El archivo trata Jetpack Compose Material3 como la ruta predeterminada, y el Árbol de Decisión dirige shells de aplicación, componentes individuales, temas, formularios, navegación y visualización de datos a secciones y archivos de referencia específicos antes de escribir cualquier código.

  2. 02
    Aplicar la Capa de Tokens

    Todos los tokens de MD3 viven en el espacio de nombres md.sys; Compose mapea los mismos roles semánticos sobre MaterialTheme.colorScheme, typography y shapes, mientras que web los mapea sobre custom properties de CSS con el prefijo md-sys.

  3. 03
    Elija Components desde la Quick Reference

    La tabla de componentes enumera el nombre del elemento web de cada componente, sus variantes clave y categoría, y marca cuáles no tienen implementación en @material/web para poder construirse a partir de custom properties de CSS con HTML estándar en su lugar.

  4. 04
    Ensamble con los Common Patterns

    Los patrones App Shell, Card Grid y Form Layout se proporcionan en HTML más CSS, incluyendo un breakpoint que convierte el navigation rail en bottom navigation en anchos compactos.

  5. 05
    Audite Cuando se le Solicite

    Al invocarse con audit, el skill inspecciona una URL, archivos fuente o una aplicación en ejecución y puntúa diez categorías de 0 a 10 antes de redactar el informe.

02 Encuentra tu caso de uso

Cuándo usar el skill material-3

Usa el skill material-3 en Claude Code o Codex cuando el trabajo sea diseño de app móvil de este tipo. El alcance y límites se toman del propio archivo del skill.

Buen caso de uso

  • Crear una nueva pantalla o aplicación de Android en Jetpack Compose con composables de androidx.compose.material3 como Scaffold, Button y NavigationBar.
  • Generar un tema a partir del fondo de pantalla del usuario con color dinámico en Android 12 y versiones posteriores, recurriendo a esquemas claros y oscuros estáticos en caso contrario.
  • Un layout que se adapta a teléfono, plegable, escritorio, reloj y XR en lugar de un diseño fijo pensado primero para el teléfono.
  • Auditar una aplicación o página existente frente a MD3 y obtener un informe puntuado con el que trabajar.
  • Aplicar tema a una UI web configurando custom properties de CSS de MD3 en el elemento raíz o en cualquier ancestro.

Conozca los límites

  • Esperar funciones de M3 Expressive en la web, ya que Material Web está solo en mantenimiento y Expressive no está implementado allí.
  • Renderizado del lado del servidor sin una estrategia de hydration, porque los web components son elementos personalizados que necesitan JavaScript.
  • Proyectos que aún mezclan librerías de Material 2 y Material 3, cuyas API y estilos son incompatibles.
  • Layouts solo para teléfono que ignoran pantallas grandes y plegables, incluyendo contenido interactivo colocado a través de una bisagra.

Qué proporcionar

  • Un argumento de tareaEl skill toma un argumento component, theme, layout, scaffold o audit seguido de una breve descripción o una URL, que selecciona qué sección o archivo de referencia seguir.
  • Un objetivo para auditarPara trabajos de audit, proporcione una URL para la inspección en navegador, rutas de archivos desde las que leer el código fuente, o acceso a una aplicación en ejecución.
  • Un color semilla para theming personalizadoUn único color semilla es suficiente para derivar un esquema de color completo; el archivo remite al paquete material-color-utilities para generar los valores.
  • Archivos fuente para auditorías de códigoLas auditorías de Compose leen archivos Kotlin para detectar el uso de MaterialTheme, composables, valores de Color en bruto, Dp fijos y semantics faltantes.

03 Dentro del skill

Reglas que el Skill material-3 Da a Claude Code y Codex

8 instrucciones concretas, valores por defecto y límites que SKILL.md fija para el agente: la parte del archivo que cambia el resultado.

  1. Compose Primero para Nuevo Trabajo con Material

    Para nuevo trabajo en Android, el archivo indica preferir Jetpack Compose Material3 para componentes, API expresivas, scaffolds adaptativos e integración con la Styles API; las Android Views solo son aceptables en aplicaciones existentes.

  2. Nunca Codifique Colores de Forma Fija

    Utilice los tokens md-sys-color en lugar de valores hexadecimales o rgb sin procesar, porque los colores codificados de forma fija rompen el theming dinámico, el modo oscuro y el ajuste de contraste.

  3. Mantenga los Pares Tonales Previstos

    Combine los colores solo como fueron diseñados, por ejemplo primary con on-primary y surface-container con on-surface; las combinaciones arbitrarias rompen el contraste en el color dinámico y en los modos de alto contraste.

  4. Los Divisores Usan outline-variant

    Los divisores se dibujan con outline-variant; outline está reservado para límites importantes como los bordes de los campos de texto.

  5. Importe los Web Components de Forma Individual

    Nunca importe el paquete @material/web como barril; importe únicamente los módulos de componentes en uso, porque importar todo destruye el tamaño del bundle.

  6. Limite el Ancho en Ventanas Grandes

    En ventanas Large (1200dp+) y Extra-large (1600dp+), el contenido se limita a un ancho máximo de 840-1040dp, porque las líneas de texto de ancho infinito son ilegibles.

  7. La Elevación Es Tonal, No una Sombra

    MD3 comunica la elevación mediante el color tonal de la superficie en lugar de sombras; las sombras solo se añaden cuando un elemento necesita separación adicional respecto a un fondo recargado.

  8. Roboto Es Correcto en MD3

    Roboto o Roboto Flex es la tipografía Material predeterminada, y la recomendación de frontend-design de evitar Roboto no aplica aquí; sustitúyala solo cuando se personalice intencionadamente la escala tipográfica.

04 Ponlo a trabajar

Instalar material-3 en Claude Code o Codex

Un comando npx skills add, luego una primera tarea en tu agente y una lista de verificación para el resultado.

Agregar material-3 a Claude Code, Codex o Tu Agente

Ejecútelo en su proyecto; el instalador pregunta a qué agente añadirlo.

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

Forma genérica del CLI skills para skills/material-3/SKILL.md; el repositorio puede documentar su propia ruta.

Dale al skill una primera tarea de diseño de aplicación móvil

Redactado en los términos del propio skill; sustituya las partes entre corchetes por su material.

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.

Fuente: redactado a partir del SKILL.md en los términos del propio skill.

Revisa el primer resultado

Lo que el propio SKILL.md indica que debe ser un resultado correcto:

  • Verifique las relaciones de contraste y las áreas táctiles, no solo el uso de los roles de MD3.
  • Busque en las hojas de estilo web colores hexadecimales codificados de forma fija.
  • Busque en el código fuente de Kotlin valores de Color sin procesar.
  • Busque en JavaScript y TypeScript importaciones sobrantes de Material 2.
  • Redimensione el viewport o use el modo responsivo para comprobar el diseño en cada breakpoint.

En OpenDesign importe material-3 desde su enlace SKILL.md: Plugins → Add → Skill → Import from link, luego selecciónelo en la barra superior.

05 Código abierto, rastreable

Fuente, Licencia y Verificación

De dónde provienen los datos de esta página y cuándo se verificaron por última vez.

Author
hamen
Repository
github.com/hamen/material-3-skill Rama master
Archivo de skill
skills/material-3/SKILL.md Suma de verificación de contenido registrada al momento de verificación; commit 14385f2
License
MIT De LICENSE.
Estrellas del repositorio
1,384 Captura de GitHub tomada el 14-09-2026 para todo el repositorio hamen/material-3-skill. No es una calificación ni un recuento de uso para material-3.
Verificado por OpenDesign
14/09/2026 Se verificaron el archivo fuente, la ruta, el texto de licencia y el recuento de estrellas. No incluido en OpenDesign principal (verificado el 28/08/2026); no se ha registrado una ejecución en vivo en esta página.

Dentro del SKILL.md

  1. FilosofíaTres principios, personal, adaptativo y expresivo, que definen el color dinámico, las clases de tamaño de ventana y el movimiento spring.
  2. Árbol de DecisiónDirige lo que está construyendo y la plataforma correspondiente hacia secciones y archivos de referencia.
  3. Sistema de Design TokensTokens md.sys de color, tipografía, forma, elevación y movimiento, con mapeos a Compose y CSS.
  4. Referencia Rápida de ComponentesTabla de más de 30 componentes con elementos web, variantes clave y categoría.
  5. Jetpack Compose (principal)Configuración de androidx.compose.material3, MaterialTheme, color dinámico, UI adaptable e insets.
  6. Web (limitado): @material/webWeb components en modo de mantenimiento, importaciones individuales, theming con CSS custom properties y tema oscuro.
  7. Patrones comunesFragmentos de app shell, grid de tarjetas y layout de formularios en HTML y CSS.
  8. AntipatronesProhibiciones estrictas que abarcan la mezcla de MD2
La descripción propia del Skill
"Implementa el sistema UI Material Design 3 (Material You) de Google. Primario: Jetpack Compose Material3 (MaterialTheme, componentes, layout adaptativo). También Flutter y web limitado (@material/web, modo mantenimiento). Cubre tokens, más de 30 componentes, layout, theming, M3 Expressive (matriz de plataformas) y accesibilidad. Usa cuando: "material design", "MD3", "material you", "Jetpack Compose", "MaterialTheme", "componente material", "md3 button"."

Descripción del front-matter de SKILL.md. El archivo completo tiene aproximadamente 31,218 caracteres. Lee el archivo completo en GitHub.

Material 3

Ejecuta material-3 en una Tarea Real de Diseño de Aplicación Móvil.

Descarga OpenDesign, importa material-3 desde su enlace SKILL.md, pega el prompt de arriba y lee el plan antes del resultado.

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

OpenDesign Desktop

Un sistema de diseño. Tu marca, coherente en cada resultado

En el Vibe Design Workspace completo, aplica las mismas reglas de marca a sitios web, presentaciones, prototipos interactivos, dashboards, imágenes y vídeo HTML. Conecta Codex, Claude Code, Cursor y otros agentes de código locales y crea gratis.

  • Web, presentaciones, prototipos, dashboards, imágenes y vídeo
  • Más de 140 sistemas de diseño y la biblioteca completa de plantillas y skills
  • Codex local y más de 21 agentes de código · Gratis
Descargar gratis

Disponible para macOS y Windows