Communitygithub.com

coastdigitalgroup/coastai-skills

Projete e implemente um framework sistemático para elementos informacionais que comunicam estado (Badges) e categorização (Tags) com clareza e acessibilidade.

O que é coastai-skills?

Este skill, desenvolvido pela coastdigitalgroup, oferece um framework completo para projetar e implementar sistemas de Badges e Tags em interfaces web. Ele foca em garantir que esses elementos informacionais secundários — como indicadores de status, categorizadores de conteúdo e contadores — sejam instantaneamente escaneáveis, acessíveis e organizados logicamente, sem competir com o conteúdo principal. O skill estabelece diretrizes claras para distinguir Badges (status/counts, geralmente não interativos) de Tags (categorização, frequentemente interativos), define uma anatomia visual consistente (tipografia, raios de borda, tamanhos) e mapeia cores semânticas (Success/Warning/Error/Info) para significados específicos, exigindo sempre o uso combinado de cor e texto/ícone para acessibilidade (WCAG AA). Também cobre estados interativos (hover, focus, remoção com 'X'), regras de posicionamento (overlay, inline, agrupado), padrões comuns de falha (como 'Button Mimic' ou 'Tag Soup'), e critérios de validação, sendo aplicável em qualquer plataforma que utilize HTML/CSS, como sites, dashboards e aplicações SaaS.

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

Perguntar na sua IA favorita

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

Documentação

Sistema de Badge e Tag

Propósito

O Sistema de Badge e Tag fornece uma metodologia para projetar e implementar pequenos componentes informacionais que fornecem contexto rápido, status ou categorização. Esse skill garante que esses elementos permaneçam secundários ao conteúdo principal, sendo instantaneamente escaneáveis, acessíveis e logicamente organizados em todo o site.

Casos de Uso

  • Indicadores de Status: Mostrando o estado de um objeto (ex.: "Ativo", "Pendente", "Esgotado").
  • Categorização: Rotulando conteúdo por tópico, tipo ou coleção (ex.: "Produtividade", "Tutorial", "Novidade").
  • Quantidade/Contagens: Exibindo números associados a um item (ex.: "12 Notificações", "5 Itens no Carrinho").
  • Visibilidade de Filtros: Mostrando filtros ativos que podem ser removidos pelo usuário.
  • Sinalização de Prioridade: Destacando atributos específicos como "Mais Vendido" ou "Urgente".

Quando NÃO Usar

  • Ações Primárias: Não use badges ou tags como a principal Chamada para Ação (CTA); use botões do sistema-de-estados-interativos.
  • Grandes Blocos de Conteúdo: Se a informação exigir mais de 2 a 3 palavras, use um sistema-de-interface-de-cartao ou tipografia padrão.
  • Navegação: Embora tags possam levar a visualizações filtradas, elas não devem substituir o sistema-de-navegacao-do-site principal.
  • Ícones Meramente Decorativos: Se o elemento não tem significado semântico, ele pertence ao sistema-de-iconografia.

Entradas

  1. Intenção do Conteúdo: É um status (estado), uma categoria (metadado) ou uma contagem (número)?
  2. Requisito Interativo: O elemento é estático, ou é removível/clicável?
  3. Contexto de Hierarquia: Qual é o elemento pai? (ex.: um card, um cabeçalho, uma linha de tabela).
  4. Tokens de Cor: Escala de cores semânticas existente (Sucesso, Aviso, Erro, Info).

Saídas

  1. Especificação de Anatomia Visual: Definições para raio de borda (pill vs. arredondado), preenchimento e tipografia.
  2. Matriz de Cores Semânticas: Mapeamento de cores para significados específicos (ex.: Verde = Sucesso).
  3. Especificações Interativas: Tratamentos visuais para hover, focus e ações de "remover" (X).
  4. Regras de Posicionamento: Diretrizes de onde esses elementos se posicionam em relação a títulos e imagens.

Fluxo de Trabalho

1. Distinguir entre Badge e Tag

Defina o papel funcional primeiro:

  • Badges: Geralmente indicam Status (ex.: "Ao Vivo") ou Contagens (ex.: "3"). Eles geralmente são não interativos ou linkam a um único estado.
  • Tags: Geralmente indicam Categorização (ex.: "SaaS"). São frequentemente interativos, permitindo que os usuários filtrem conteúdo ou removam a tag.

2. Estabelecer Anatomia Visual

Defina o estilo base para garantir que eles não se pareçam com botões:

  • Tipografia: Use uma fonte menor, geralmente em maiúsculas ou seminegrito (ex.: 12px/0,75rem).
  • Raio de Borda:
    • Pill (Totalmente Arredondado): Melhor para status e contagens.
    • Arredondado (4-8px): Melhor para categorização e tags removíveis.
  • Tamanho: Mantenha a altura consistente (ex.: 20px-24px) para garantir que se alinhem bem com o texto.

3. Atribuir Lógica Semântica (Cor e Ícones)

Use cor para comunicar significado sem forçar o usuário a ler:

  • Sucesso (Verde): "Completo", "Ativo", "Verificado".
  • Aviso (Amarelo/Laranja): "Pendente", "Estoque Baixo", "Rascunho".
  • Erro (Vermelho): "Falhou", "Crítico", "Fora de Estoque".
  • Info/Neutro (Azul/Cinza): "Novo", "Categoria", "Metadado".

Regra: Sempre combine cor com texto ou um ícone para garantir acessibilidade para usuários daltônicos.

4. Definir Estados Interativos

Se a tag for interativa:

  • Hover/Focus: Aplique uma sutil mudança de fundo ou alteração de borda.
  • Removível: Inclua um ícone "X" claro com uma área mínima de toque de 24x24px (WCAG 2.2 SC 2.5.8), podendo ser ampliada para 44x44px onde o layout permitir para um uso tátil confortável.

5. Determinar Posicionamento e Hierarquia

  • Sobreposição: Colocar um badge "Novo" no canto superior de uma imagem.
  • Em Linha: Colocar um badge de status imediatamente após um título em um sistema-de-cabecalho-de-pagina.
  • Agrupado: Empilhar múltiplas tags abaixo de uma descrição em um sistema-de-interface-de-cartao.

Regras de Decisão

  • O "Teste do Aperto de Olhos": Se um badge é tão brilhante que distrai do H1, reduza sua saturação ou use um estilo de contorno.
  • Limite a Contagem: Nunca use mais de 3 tags em um único cartão para evitar poluição visual.
  • Comprimento do Texto: Mantenha os rótulos em 1-2 palavras. Trunque ou use tooltips se os dados forem dinâmicos e imprevisíveis.
  • Distinção de Botões: Badges devem ter um tratamento visual diferente (ex.: tamanho menor, raio diferente) dos botões primários "Enviar" ou "Comprar".

Restrições

  • Acessibilidade: O texto dentro de badges/tags deve atender ao WCAG AA (4,5:1 de contraste). Tags interativas devem ser navegáveis por teclado.
  • Responsividade: Tags em um grupo devem quebrar para a próxima linha (flex-wrap: wrap) em vez de transbordar o contêiner.
  • Alvos de Toque: Tags removíveis devem ter um alvo grande o suficiente para a ação de "fechar" (mín. 24x24px conforme WCAG 2.2 SC 2.5.8; 44x44px preferido).

Padrões Comuns de Falha

  • O "Imitador de Botão": Fazer tags parecerem exatamente com botões, levando os usuários a esperar uma ação primária.
  • Dependência Excessiva de Cor: Usar vermelho/verde/amarelo sem rótulos de texto, tornando impossível para usuários daltônicos ou de leitores de tela entenderem o status.
  • Sopa de Tags: Aglomerar um cartão com 10+ tags, tornando nenhuma delas útil.
  • Raio Inconsistente: Misturar badges em forma de pílula e tags de cantos quadrados na mesma interface.

Critérios de Validação

  • Badges e tags são visualmente distintos dos botões.
  • Cores semânticas são usadas de forma consistente (ex.: Verde sempre significa Sucesso).
  • As taxas de contraste atendem ao WCAG AA (4,5:1) para todas as variações de cor.
  • Tags interativas incluem estados de foco e alvos de toque de pelo menos 24x24px (WCAG 2.2 SC 2.5.8).
  • Os elementos quebram graciosamente em viewports móveis.
  • Ícones são usados junto com a cor para indicadores de status críticos.

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 progressive disclosure using accordions, ensuring structural integrity, visual affordances, and accessibility across different content densities and devices.

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 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 color palette that ensures WCAG 2.2 accessibility compliance. Trigger this skill when asked to define brand colors, create UI themes, or establish a visual system for a website.

Habilidades Relacionadas