Communitygithub.com

Material 3 Expressive

Diseña, implementa, moderniza y revisa interfaces de producción con Material 3 y Material 3 Expressive. Úsalo cuando una tarea mencione Material Design 3, M3 Expressive, Material You, UI expresiva, componentes Material, temas, layouts adaptativos de Material o una revisión de accesibilidad/diseño centrada en Material.

¿Qué es Material 3 Expressive?

Esta skill está diseñada para ayudar a desarrolladores y diseñadores a construir interfaces coherentes con los principios de Material Design 3, pero yendo más allá de la apariencia superficial para lograr un comportamiento de producto verdaderamente integrado. Se basa en Material 3 Expressive, una expansión que añade opciones informadas por investigación para temas, componentes, movimiento, tipografía y expresión visual, sin reemplazar los fundamentos de Material 3. La skill guía al usuario a través de un flujo de trabajo estructurado de 10 pasos: desde inspeccionar el proyecto y comprender el producto, hasta aplicar fundamentos M3, hacer un pase expresivo intencionado, seleccionar componentes, diseñar para el tamaño de ventana disponible, definir interacción y verificar antes de la entrega. Es compatible con plataformas como Android, Wear OS, Flutter y web, e incluye referencias detalladas para principios expresivos, fundamentos de diseño, componentes y patrones, layouts adaptativos, accesibilidad, guía de plataforma y listas de verificación. La skill impone principios no negociables como 'tarea antes que tratamiento', 'semántica antes que espectáculo' y 'accesible por defecto', y requiere verificar APIs reales y versiones de dependencias antes de implementar.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/asimawdah/material-expressive-skill/tree/HEAD

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

¿Qué hace Material 3 Expressive?

Usa esta skill para crear interfaces que se comporten como un producto Material coherente, no pantallas que solo imiten su estilo superficial.

Material 3 Expressive es una expansión de Material 3. Añade opciones informadas por investigación para temas, componentes, movimiento, tipografía y expresión visual. No reemplaza los fundamentos de Material 3. Preserva las semánticas familiares y usa la expresión para que la información importante, las acciones y los estados sean más fáciles de percibir.

Principios no negociables

  • Tarea antes que tratamiento. Comprende al usuario, la tarea, la arquitectura de la información, la prioridad del contenido y la interacción antes de estilizar.
  • Semántica antes que espectáculo. Usa el componente adecuado para el trabajo. Nunca disfraces la navegación, las acciones, la selección o el comportamiento destructivo.
  • Expresión con una razón. Cada elección expresiva debe mejorar la jerarquía, el reconocimiento, la retroalimentación o la claridad emocional.
  • Verdad de la plataforma. No inventes APIs, disponibilidad de componentes, tokens o requisitos de versión. La paridad de características nativas difiere entre Android, Wear OS, Flutter, web y otras plataformas.
  • Comportamiento completo. Especifica estados significativos de carga, vacío, error, éxito, deshabilitado, foco, hover, presionado y seleccionado.
  • Accesible por defecto. Diseña para tecnología de asistencia, contraste suficiente, escalado de texto, entrada de teclado y puntero, movimiento reducido, localización y diseños de derecha a izquierda.
  • Preserva el código base. Inspecciona la arquitectura y las convenciones existentes. No migres frameworks, reemplaces librerías ni actualices dependencias como trabajo de diseño incidental.

Flujo de trabajo

Sigue esta secuencia a menos que el usuario limite explícitamente la tarea.

1. Inspecciona el proyecto y resuelve el objetivo

Identifica el framework, la plataforma, la librería Material existente y su versión, la configuración del tema, la navegación, los componentes reutilizables, el enfoque de gestión de estado, los comandos de compilación/prueba y las convenciones de diseño actuales.

Aclara únicamente las restricciones que cambien materialmente la arquitectura. De lo contrario, asume supuestos conservadores y establécelos brevemente. Nunca asumas que una librería de interfaz de usuario soporta una característica M3 Expressive recién anunciada: verifica primero la API oficial y las notas de la versión.

2. Comprende el producto

Captura:

  • Usuario principal, objetivo y acción de éxito.
  • Límites de la pantalla o flujo y jerarquía de la información.
  • Densidad del contenido, relaciones de datos y decisiones importantes.
  • Restricciones de marca y el grado permitido de cambio visual.
  • Dispositivos compatibles, tamaños de ventana, orientaciones y métodos de entrada.
  • Estados requeridos, rutas de fallo, permisos y acciones destructivas.
  • Restricciones de accesibilidad, localización, privacidad y rendimiento.

Usa el brief de diseño cuando un brief estructurado sea útil.

3. Establece estructura y jerarquía

Agrupa contenido relacionado, distingue la navegación de las acciones e identifica la acción principal. Elige un diseño de información antes de elegir colores, formas de esquinas o animaciones. Prefiere un número pequeño de regiones claras sobre un montón de tarjetas anidadas.

4. Aplica los fundamentos de M3

Define roles de color semánticos, tipografía, forma, elevación, espaciado y uso de iconos como un sistema coherente. Soporta temas claro y oscuro; considera el color dinámico donde la plataforma lo soporte y donde los requisitos del usuario o la marca lo permitan. Lee fundamentos de diseño.

5. Haz un pase expresivo intencionado

Usa una o pocas palancas expresivas cuando refuercen la tarea:

  • Tamaño y flexibilidad de los componentes para establecer prioridad.
  • Forma para distinguir roles, grupos o estados significativos.
  • Color para enfocar la atención y comunicar significado semántico.
  • Tipografía para crear jerarquía y carácter.
  • Contención para aclarar grupos y aislar acciones importantes.
  • Movimiento para explicar causa, continuidad, cambio de estado o relaciones espaciales.

No maximices cada palanca. Los ajustes rutinarios, formularios, datos densos y superficies de lectura larga generalmente necesitan moderación. Lee principios expresivos.

6. Selecciona componentes y patrones

Elige componentes según la intención del usuario y el soporte de la plataforma, no por novedad. Prefiere componentes oficiales cuando cumplan la necesidad. Usa componentes personalizados solo para brechas genuinas y preserva las semánticas, estados y comportamiento de interacción esperados. Lee componentes y patrones.

7. Diseña para la ventana disponible

Adapta la navegación, el número de paneles, la jerarquía y la densidad de la información a la ventana de la aplicación, no meramente a una etiqueta de dispositivo. Soporta redimensionamiento, transiciones de plegar/desplegar, cambios de orientación, uso del teclado y pantallas grandes cuando sea relevante. Lee layouts adaptativos.

8. Define interacción, retroalimentación y movimiento

Especifica transiciones de estado, temporización de retroalimentación, comportamiento de foco, recuperación de errores y cancelación. El movimiento debe comunicar un cambio de estado o una relación espacial; proporciona una alternativa de movimiento reducido. Lee movimiento y retroalimentación.

9. Implementa para la plataforma real

Usa el conjunto más pequeño y correcto de dependencias y APIs estables por defecto. Marca las APIs experimentales claramente y explica la compensación antes de adoptarlas. Aplica las notas específicas de la plataforma en guía de plataforma.

10. Verifica antes de la entrega

Ejecuta las comprobaciones relevantes del proyecto y revisa cada estado requerido, viewport, modo de entrada, tema, dirección de configuración regional y comportamiento de accesibilidad. No reportes comprobaciones que no se ejecutaron. Usa la lista de verificación y el flujo de trabajo de implementación. Proporciona una entrega concisa usando la plantilla.

Enrutamiento de referencias

Carga solo las referencias necesarias para la tarea actual:

TareaLeer
Cualquier decisión de diseño de M3 Expressivereferences/expressive-principles.md
Tema, color, tipografía, forma, elevación, espaciadoreferences/design-foundations.md
Elegir o componer componentesreferences/components-and-patterns.md
Animación, transiciones, carga, retroalimentaciónreferences/motion-and-feedback.md
Adaptación a teléfono, tableta, plegable, escritorio o wearablereferences/adaptive-layouts.md
Accesibilidad, RTL, localización, soporte de entradareferences/accessibility-and-internationalization.md
Implementación específica del frameworkreferences/platform-guidance.md
Entrega y verificación de extremo a extremoreferences/implementation-workflow.md
Auditoría de un diseño completadoreferences/review-checklist.md
API actual, versión o pregunta sobre fuentereferences/official-sources.md

Nivel de calidad

Un resultado está listo solo cuando:

  1. Un usuario puede identificar la tarea principal y la acción sin explicación.
  2. El diseño usa fundamentos semánticos de Material en lugar de decoración arbitraria.
  3. Los tratamientos expresivos tienen un propósito específico y no se aplican de manera uniforme.
  4. La interfaz sigue siendo comprensible y utilizable en los tamaños y modos de entrada compatibles.
  5. Todos los estados significativos y las rutas de fallo están considerados.
  6. La accesibilidad y la localización son parte de la implementación, no un pulido diferido.
  7. Las APIs de la plataforma y las versiones de dependencias están verificadas, y la entrega indica lo que se probó realmente.

Cuando el proyecto no pueda cumplir un requisito, identifica la limitación y proporciona la alternativa más segura y apropiada para la plataforma. Nunca afirmes una paridad completa con Material 3 Expressive donde la plataforma no la proporcione.

Skills relacionados