Communitygithub.com

Material 3 Expressivo

Projete, implemente, modernize e revise interfaces de produção com Material 3 e Material 3 Expressivo. Use quando uma tarefa mencionar Material Design 3, M3 Expressivo, Material You, UI expressiva, componentes ou temas Material, layouts adaptativos Material ou uma revisão de design/ acessibilidade focada em Material.

O que é Material 3 Expressivo?

Esta skill capacita o agente a criar interfaces que se comportam como um produto Material coerente, em vez de apenas imitar seu estilo superficial. Ela expande o Material 3 com opções informadas por pesquisa para temas, componentes, movimento, tipografia e expressão visual, sem substituir seus fundamentos. A skill é adequada para tarefas de design, implementação, modernização e revisão de interfaces que envolvam Material Design 3, M3 Expressivo ou Material You. Ela suporta plataformas como Android, Wear OS, Flutter e web, e segue um fluxo de trabalho rigoroso de 10 etapas, desde a inspeção do projeto até a verificação final, garantindo que princípios como 'tarefa antes do tratamento' e 'semântica antes do espetáculo' sejam seguidos. A skill inclui referências a documentos específicos para cada aspecto do design, como princípios expressivos, fundamentos de design e layouts adaptativos, e exige que o resultado atenda a um alto padrão de qualidade, incluindo acessibilidade, suporte a múltiplos modos de entrada e verificação de APIs reais da plataforma.

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

O que Material 3 Expressivo faz?

Use esta skill para criar interfaces que se comportam como um produto Material coerente, não telas que apenas imitam seu estilo superficial.

Material 3 Expressivo é uma expansão do Material 3. Ele adiciona opções informadas por pesquisa para temas, componentes, movimento, tipografia e expressão visual. Não substitui os fundamentos do Material 3. Preserve a semântica familiar e use a expressão para tornar informações, ações e estados importantes mais fáceis de perceber.

Princípios inegociáveis

  • Tarefa antes do tratamento. Entenda o usuário, a tarefa, a arquitetura da informação, a prioridade do conteúdo e a interação antes de estilizar.
  • Semântica antes do espetáculo. Use o componente certo para o trabalho. Nunca disfarce navegação, ações, seleção ou comportamento destrutivo.
  • Expressão com um motivo. Cada escolha expressiva deve melhorar a hierarquia, o reconhecimento, o feedback ou a clareza emocional.
  • Verdade da plataforma. Não invente APIs, disponibilidade de componentes, tokens ou requisitos de versão. A paridade de funcionalidades nativas difere entre Android, Wear OS, Flutter, web e outras plataformas.
  • Comportamento completo. Especifique estados significativos de carregamento, vazio, erro, sucesso, desabilitado, foco, hover, pressionado e selecionado.
  • Acessível por padrão. Projete para tecnologia assistiva, contraste suficiente, redimensionamento de texto, entrada por teclado e ponteiro, movimento reduzido, localização e layouts da direita para a esquerda.
  • Preserve o código existente. Inspecione a arquitetura e as convenções existentes. Não migre frameworks, substitua bibliotecas ou atualize dependências como trabalho de design incidental.

Fluxo de trabalho

Siga esta sequência, a menos que o usuário limite explicitamente a tarefa.

1. Inspecione o projeto e resolva o alvo

Identifique o framework, a plataforma, a biblioteca Material existente e sua versão, a configuração de tema, a navegação, os componentes reutilizáveis, a abordagem de gerenciamento de estado, os comandos de build/teste e as convenções de design atuais.

Esclareça apenas restrições que alterem materialmente a arquitetura. Caso contrário, faça suposições conservadoras e declare-as brevemente. Nunca presuma que uma biblioteca de UI suporta um recurso M3 Expressivo recém-anunciado: verifique a API oficial e as notas de lançamento primeiro.

2. Entenda o produto

Capture:

  • Usuário principal, objetivo e ação de sucesso.
  • Limites da tela ou fluxo e hierarquia da informação.
  • Densidade do conteúdo, relações de dados e decisões importantes.
  • Restrições de marca e o grau permitido de mudança visual.
  • Dispositivos suportados, tamanhos de janela, orientações e métodos de entrada.
  • Estados necessários, caminhos de falha, permissões e ações destrutivas.
  • Restrições de acessibilidade, localização, privacidade e desempenho.

Use o brief de design quando um brief estruturado ajudar.

3. Estabeleça estrutura e hierarquia

Agrupe conteúdo relacionado, distinga navegação de ações e identifique a ação principal. Escolha um layout de informação antes de escolher cores, formatos de canto ou animação. Prefira um pequeno número de regiões claras a uma pilha de cards aninhados.

4. Aplique os fundamentos do M3

Defina papéis de cores semânticas, tipografia, forma, elevação, espaçamento e uso de ícones como um sistema coerente. Suporte temas claro e escuro; considere cor dinâmica onde a plataforma suportar e onde os requisitos do usuário ou da marca permitirem. Leia fundamentos de design.

5. Faça uma passagem expressiva intencional

Use uma ou algumas alavancas expressivas quando elas reforçarem a tarefa:

  • Tamanho e flexibilidade do componente para estabelecer prioridade.
  • Forma para distinguir papéis, grupos ou estado significativo.
  • Cor para focar a atenção e comunicar significado semântico.
  • Tipografia para criar hierarquia e caráter.
  • Contenção para esclarecer grupos e isolar ações importantes.
  • Movimento para explicar causa, continuidade, mudança de estado ou relações espaciais.

Não maximize todas as alavancas. Configurações rotineiras, formulários, dados densos e superfícies de leitura longa geralmente precisam de moderação. Leia princípios expressivos.

6. Selecione componentes e padrões

Escolha componentes pela intenção do usuário e suporte da plataforma, não pela novidade. Prefira componentes oficiais quando atenderem à necessidade. Use componentes personalizados apenas para lacunas genuínas e preserve a semântica, os estados e o comportamento de interação esperados. Leia componentes e padrões.

7. Projete para a janela disponível

Adapte navegação, contagem de painéis, hierarquia e densidade de informação à janela do aplicativo, não meramente a um rótulo de dispositivo. Suporte redimensionamento, transições de dobrar/desdobrar, mudanças de orientação, uso de teclado e telas grandes quando relevante. Leia layouts adaptativos.

8. Defina interação, feedback e movimento

Especifique transições de estado, tempo de feedback, comportamento de foco, recuperação de erros e cancelamento. O movimento deve comunicar uma mudança de estado ou relação espacial; forneça uma alternativa de movimento reduzido. Leia movimento e feedback.

9. Implemente para a plataforma real

Use o menor conjunto correto de dependências e APIs estáveis por padrão. Marque APIs experimentais claramente e explique a troca antes de adotá-las. Aplique as notas específicas da plataforma em orientação de plataforma.

10. Verifique antes da entrega

Execute as verificações relevantes do projeto e revise todos os estados necessários, viewports, modos de entrada, temas, direção de localidade e comportamento de acessibilidade. Não relate verificações que não foram executadas. Use a lista de verificação de revisão e o fluxo de trabalho de implementação. Forneça uma entrega concisa usando o modelo.

Roteamento de referências

Carregue apenas as referências necessárias para a tarefa atual:

TarefaLeia
Qualquer decisão de design M3 Expressivoreferences/expressive-principles.md
Tema, cor, tipografia, forma, elevação, espaçamentoreferences/design-foundations.md
Escolher ou compor componentesreferences/components-and-patterns.md
Animação, transições, carregamento, feedbackreferences/motion-and-feedback.md
Adaptação para telefone, tablet, dobrável, desktop ou wearablereferences/adaptive-layouts.md
Acessibilidade, RTL, localização, suporte a entradareferences/accessibility-and-internationalization.md
Implementação específica de frameworkreferences/platform-guidance.md
Entrega e verificação de ponta a pontareferences/implementation-workflow.md
Auditoria de um design concluídoreferences/review-checklist.md
Pergunta atual sobre API, versão ou fontereferences/official-sources.md

Padrão de qualidade

Um resultado está pronto apenas quando:

  1. Um usuário pode identificar a tarefa e a ação principais sem explicação.
  2. O design usa fundamentos semânticos do Material em vez de decoração arbitrária.
  3. Os tratamentos expressivos têm um propósito específico e não são aplicados uniformemente.
  4. A interface permanece compreensível e utilizável nos tamanhos e modos de entrada suportados.
  5. Todos os estados significativos e caminhos de falha são considerados.
  6. Acessibilidade e localização fazem parte da implementação, não um polimento adiado.
  7. As APIs da plataforma e as versões de dependência são verificadas, e a entrega declara o que foi realmente testado.

Quando o projeto não puder atender a um requisito, identifique a limitação e forneça a alternativa mais segura e apropriada para a plataforma. Nunca reivindique paridade total com Material 3 Expressivo onde a plataforma não a fornece.

Habilidades Relacionadas