Communitygithub.com

Sistema de Cores Acessível

Projete e implemente uma paleta de cores sistemática que garanta conformidade com a acessibilidade WCAG 2.2. Ative esta skill quando solicitado a definir cores de marca, criar temas de UI ou estabelecer um sistema visual para um site.

O que é Sistema de Cores Acessível?

A skill 'Sistema de Cores Acessível' fornece uma metodologia para criar paletas de cores visualmente coesas e funcionalmente acessíveis. Ela vai além da escolha estética de cores, estabelecendo um sistema estruturado de escalas tonais, pares com contraste seguro e aplicação semântica. É útil para definir a presença digital de uma nova marca, auditar e corrigir problemas de acessibilidade em sites existentes, projetar temas claro/escuro e definir cores semânticas para feedback (sucesso, erro, aviso). A skill suporta plataformas de desenvolvimento web e ferramentas de design UI, gerando saídas prontas para produção, como variáveis CSS e uma matriz de contraste. Ela opera no espaço de cores OKLCH para previsibilidade perceptual e inclui regras de decisão que priorizam a legibilidade, evitam o uso exclusivo de cor para transmitir informações e mantêm consistência de luminosidade entre matizes. O workflow guia o usuário através da geração de escalas tonais, definição de neutros, estabelecimento de papéis semânticos, validação de contraste com fórmulas WCAG e criação de regras de pareamento de cores.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/coastdigitalgroup/coastai-skills/tree/HEAD/website-design/accessible-color-system

Perguntar na sua IA favorita

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

Documentação

O que Sistema de Cores Acessível faz?

Propósito

A skill Sistema de Cores Acessível fornece uma metodologia para criar paletas de cores que são visualmente coesas e funcionalmente acessíveis. Ela vai além da escolha estética de cores para um sistema estruturado de escalas, pares com contraste seguro e aplicação semântica, garantindo que o conteúdo seja perceptível por todos os usuários, incluindo aqueles com deficiências visuais.

Casos de Uso

  • Estabelecer a presença digital de uma nova marca.
  • Auditar e corrigir problemas de acessibilidade relacionados a cores em um site existente.
  • Projetar temas claro/escuro.
  • Definir cores semânticas para feedback (sucesso, erro, aviso).

Quando NÃO Usar

  • Experiências Orientadas pela Arte: Onde a cor é usada puramente para expressão e não carrega informação funcional (embora a acessibilidade ainda seja encorajada).
  • Aplicações Legadas com Código Fixo: Onde a dívida técnica torna impossível implementar um sistema de variáveis (concentre-se em correções pontuais).
  • Elementos Puramente Decorativos: Elementos como padrões de fundo que não contêm texto ou componentes interativos (WCAG 1.4.3 não se aplica aqui).

Entradas

Para gerar um sistema de cores acessível, você precisa:

  1. Cor Primária da Marca: A cor central que identifica a marca (ex.: #0055FF).
  2. Base Neutra: Um ponto de partida para cinzas/pretos (ex.: #1A1A1A ou um neutro matizado).
  3. Alvo de Acessibilidade: Nível AA (padrão) ou AAA (aprimorado) do WCAG.
  4. Contexto de Uso: É para um dashboard de alta densidade, uma página de destino de marketing ou uma aplicação focada em utilidade?

Saídas

  1. Escalas Tonais: Paletas tonais para cores Primárias, Secundárias, Neutras e Semânticas (geralmente escalas de 10 etapas).
  2. Matriz de Contraste: Um mapa de quais cores de primeiro plano são seguras para usar em quais cores de fundo.
  3. Mapeamento Semântico: Funções definidas para cores (ex.: --color-action-primary, --color-surface-muted).
  4. Propriedades Personalizadas CSS: Um bloco de variáveis CSS pronto para produção, opcionalmente usando color-mix() para derivar tons de hover/ativo a partir de um único token base, em vez de escolher manualmente cada cor de estado.

Fluxo de Trabalho

1. Gerar Escalas Tonais

Expanda as cores base em escalas (ex.: 50 a 900). Use uma ferramenta ou fórmula que mantenha etapas de luminosidade consistentes. Trabalhar no espaço de cores OKLCH (em vez de HSL) produz etapas de luminosidade perceptual mais uniformes entre matizes, o que torna o contraste mais fácil de prever antes do teste. Dica: Certifique-se de que seu Primário 500 ou 600 seja a versão "da marca".

2. Definir Neutros

Crie uma escala neutra. Considere "matizar" os neutros com uma pequena quantidade da cor primária (ex.: 2-5%) para criar uma aparência mais coesa.

3. Estabelecer Funções Semânticas

Atribua cores a funções funcionais:

  • Ação: Cor primária para botões, links e estados ativos.
  • Superfície: Fundos, cartões e divisores (Neutros).
  • Conteúdo: Texto e ícones (Neutros de alto contraste).
  • Status: Sucesso (Verde), Aviso (Amarelo/Laranja), Erro (Vermelho), Informação (Azul).

4. Realizar Validação de Contraste

Teste pares usando as fórmulas WCAG (1.4.3, 1.4.11):

  • Texto Normal: 4,5:1 para AA, 7:1 para AAA.
  • Texto Grande (>18pt): 3:1 para AA, 4,5:1 para AAA.
  • Componentes de UI/Ícones: 3:1 para AA (contraste não textual, 1.4.11).
  • Indicadores de Foco: 3:1 contra as cores adjacentes, e o indicador não deve ser ocultado por cabeçalhos fixos ou outro conteúdo (WCAG 2.2 SC 2.4.11, Foco Não Obscurecido).

5. Criar Regras de Pareamento

Documente quais cores de texto podem ser usadas em quais fundos. Exemplo: Texto branco (#FFFFFF) só é seguro em Primário 600 ou superior.

Regras de Decisão

  • Legibilidade Primeiro: A função (legibilidade) sempre substitui a estética. Se uma cor da marca é muito clara para texto, use uma variante mais escura para o texto enquanto mantém a cor da marca para elementos decorativos.
  • Evitar Cor Sozinha: Nunca confie na cor como a única maneira de transmitir informações (ex.: inclua um ícone ou rótulo de texto com uma mensagem de erro).
  • Luminosidade Consistente: Mantenha os valores de luminosidade semelhantes entre diferentes matizes no mesmo nível de escala (ex.: Vermelho 500 e Azul 500 devem ter brilho percebido semelhante).

Restrições

  • Responsividade: As cores devem manter o contraste em telas móveis onde o brilho ou telas de baixa qualidade podem reduzir a visibilidade.
  • Acessibilidade: Deve atender pelo menos aos padrões WCAG 2.2 AA para todos os elementos funcionais, incluindo o requisito 2.4.11 de que os indicadores de foco permaneçam visíveis e não obscurecidos.
  • Hierarquia: Use saturação de cor e contraste para guiar o olho; elementos mais importantes (CTAs) devem ter maior peso visual.

Padrões Comuns de Falha

  • Contraste Insuficiente: Usar texto cinza claro em fundo branco ou texto branco em uma cor de marca clara.
  • Cores Vibrantes: Parear cores de alta saturação (como vermelho e verde) que causam cansaço visual.
  • Muitas Cores: Criar um efeito "arco-íris" que dilui a identidade da marca e confunde a hierarquia.
  • Uso Semântico Incorreto: Usar "Vermelho de Erro" para um elemento decorativo, causando ansiedade no usuário.

Critérios de Validação

  • Cada elemento de texto funcional tem uma taxa de contraste de pelo menos 4,5:1 contra seu fundo.
  • Componentes de UI (bordas, ícones) têm pelo menos 3:1 de contraste.
  • O sistema inclui uma escala clara para cores primárias e neutras.
  • A informação nunca é transmitida apenas através da cor.
  • O sistema é documentado usando propriedades personalizadas CSS para portabilidade.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for long-form content, managing readability, vertical rhythm, and information density to ensure a superior reading experience.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for informational elements that communicate state (Badges) and categorization (Tags) with clarity and accessibility.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for non-overlay notifications, managing global announcements and contextual inline alerts to communicate system states without interrupting the user's flow.

coastdigitalgroup/coastai-skills

Design and implement a systematic, asymmetrical bento-grid layout framework to organize diverse content types cohesively while maintaining strict visual hierarchy, logical focus order, and responsive flexibility.

coastdigitalgroup/coastai-skills

Design a responsive, mobile-first bottom navigation bar and persistent action dock system for mobile websites and web applications, establishing spatial anchors, tab bar anatomy, badge indicators, thumb-zone ergonomics, safe area inset handling, active/inactive state contrast, and desktop responsive adaptation rules.

coastdigitalgroup/coastai-skills

Design a mobile-first bottom sheet overlay system with configurable detents, drag affordances, safe area padding, responsive desktop modal/popover adaptation, and WCAG AA accessibility compliance.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for secondary navigation trails that provide orientation, context, and one-click access to parent levels in deep information architectures.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for buttons and interactive triggers, managing visual hierarchy, variant logic, and action grouping to ensure clear intent and accessible interaction.

coastdigitalgroup/coastai-skills

Design a systematic framework for date and time selection, managing calendar grids, range pickers, and scheduling interfaces to ensure precision and accessibility.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for modular content containers that maintain hierarchy, structural integrity, and action alignment across variable content and responsive viewports.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for horizontal discovery components, managing navigation affordances, scroll behavior, and accessibility to ensure effective content density without compromising usability.

coastdigitalgroup/coastai-skills

Design a systematic, highly accessible, and developer-friendly UI layout framework for code blocks, snippet showcases, multi-file code tabs, line-highlighting, diff views, and syntax token contrast in technical documentation and developer platforms.

coastdigitalgroup/coastai-skills

Design a systematic framework for global command menus (Cmd+K panels) that combines keyboard-driven navigation, command execution, and shortcut discovery into an accessible, responsive overlay.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for threaded conversations, managing nesting depths, action hierarchies, and community signaling to foster engagement and readability.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for side-by-side comparison interfaces, managing high attribute density and responsive complexity to support informed decision-making.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for user privacy, managing consent banners, preference centers, and persistent privacy controls to balance legal compliance with user trust.

coastdigitalgroup/coastai-skills

Design and implement a systematic, highly accessible, and responsive visual layout framework for conversational chat widgets, live chat boxes, and chatbot panels that ensures clear message scannability, native focus flow, and seamless mobile keyboard adaptation.

coastdigitalgroup/coastai-skills

Design a systematic, accessible, and high-conversion framework for custom select dropdowns and comboboxes, defining anatomy, states, search-filtering, and responsive mobile-adaptive patterns.

coastdigitalgroup/coastai-skills

Design and specify a systematic dark theme framework, establishing rules for elevation-based surface colors, desaturated brand accents, text legibility, and media adaptation to ensure an accessible, low-fatigue experience.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for progressive disclosure using accordions, ensuring structural integrity, visual affordances, and accessibility across different content densities and devices.

Habilidades Relacionadas