Communitygithub.com

nival-button-design-skill

Projete ou refine botões e links de navegação com estilo de botão através de prévias interativas e feedback. Abrange aparência, ícones, movimento ao passar o mouse, estados de interação e calibração de cores específica da página.

O que é nival-button-design-skill?

Esta skill é especializada no design e refinamento de botões e links de navegação que se comportam como botões, oferecendo um fluxo de trabalho iterativo baseado em prévias HTML interativas e feedback do usuário. Ela cobre todos os aspectos visuais e funcionais: aparência, ícones, animações de hover, estados de interação (foco, pressionado, desabilitado, carregamento, etc.) e calibração de cores no contexto da página. É útil para desenvolvedores e designers que precisam criar ou ajustar botões de forma precisa, preservando escolhas aceitas enquanto iteram sobre partes específicas, e é compatível com plataformas que aceitam feedback visual e edição incremental, como Claude Code e outras ferramentas de IA agentiva. A skill usa HTML e CSS para prévias em tamanho real e ampliado, garante acessibilidade e contraste, e oferece um checklist de qualidade para verificar significado, geometria, estados, acessibilidade, contraste, movimento e consistência. Ela não deve ser usada para projetar cards, formulários ou menus completos, focando exclusivamente em botões e links de navegação.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Snowbow19/nival-skills/tree/HEAD/skills/nival-button-design-skill

Perguntar na sua IA favorita

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

Documentação

Skill de Design de Botões Nival

Desenvolva o botão com o usuário. Preserve as escolhas aceitas enquanto refina as partes que ele altera. Nenhuma cor, ícone, layout ou estilo de movimento específico é obrigatório.

Entradas

Leia a solicitação atual, feedback relevante, imagens de referência e arquivos de produto existentes primeiro. Determine:

  • Propósito: finalidade do botão, ação do usuário e resultado esperado.
  • Contexto: posicionamento, elementos vizinhos, dispositivos alvo e limites de edição.
  • Aparência: estilo, regras da marca, texto, ícones se necessário e hierarquia visual.
  • Geometria: restrições do contêiner, tamanhos relativos, espaçamento e alinhamento.
  • Comportamento: estados aplicáveis, métodos de entrada, transições e recuperação.
  • Entrega: exploração, prévia, edição de botão existente ou integração ao produto.

Pergunte apenas por informações ausentes que alterariam materialmente o design. Trate uma escolha inferida como uma proposta, não como uma preferência confirmada. Quando o feedback alterar uma escolha, use a direção explícita mais recente.

Resolver Direção Visual Ambígua

Quando um sentimento de estilo tem vários significados plausíveis, use Calibração de estilo e cor. Baseie as propostas na página real e compare-as em contexto. Não transforme palavras de estilo ou paletas de exemplo em padrões fixos.

Fluxo

  1. Entenda o botão. Identifique o que ele faz e o que deve permanecer inalterado. Distinga exploração visual de uma mudança funcional.
  2. Defina estados aplicáveis. Mapeie cada gatilho relevante para seu resultado visível e recuperação. Um botão de ação precisa de um resultado observável; um link de navegação precisa de um destino; um botão de alternância precisa de um valor; um botão de revelação precisa de um estado expandido e um alvo controlado. Preserve a semântica nativa de botão ou link. Não redesenhe a página ou painel de destino a menos que solicitado.
  3. Construa uma prévia HTML. Por padrão, inclua uma visualização em tamanho real e uma visualização ampliada em detalhe. Inclua contexto do produto próximo quando disponível. Use uma implementação de botão e a mesma lógica de estado em ambas as visualizações; amplie sua apresentação em vez de manter um design separado. Mantenha instâncias independentes acessíveis, com IDs únicos.
  4. Revise em contexto. Verifique legibilidade, proporções, significado, layout e interações aplicáveis no tamanho real. Use a visualização ampliada para inspecionar detalhes, não para julgar o tamanho do alvo de toque ou equilíbrio geral.
  5. Itere a partir do feedback. Altere a propriedade solicitada ou grupo relacionado. Preserve outras escolhas aceitas. Explique a mudança brevemente no chat e mantenha a prévia atualizada. Continue edições rotineiras sem uma aprovação formal após cada ação. Pergunte quando o feedback tiver interpretações materialmente diferentes.
  6. Verifique e entregue. Execute as verificações aplicáveis abaixo. Integre apenas dentro do escopo autorizado, usando o design aceito. Autorização existente permanece válida. Verifique o botão novamente em seu ambiente de produto real; o sucesso da prévia por si só não prova o sucesso da integração.

Mantenha o texto visível da interface adequado a um produto finalizado. Coloque raciocínio de design, instruções de revisão, comportamento simulado e limites de verificação no chat, não no botão.

Regras de Decisão

  • Ao editar um produto existente, prefira suas convenções estabelecidas porque o botão deve funcionar com seu ambiente. Quando o usuário solicitar um novo estilo, use essa direção.
  • Quando o comportamento afetar o julgamento, prefira uma prévia interativa porque uma imagem não pode mostrar gatilhos, transições ou recuperação.
  • Quando um ícone for mal interpretado, prefira corrigir seu contorno e estrutura porque decoração não pode reparar o significado errado. Ícones são opcionais.
  • Quando o tamanho ou espaçamento parecer errado, prefira comparar elementos relacionados no tamanho real porque dimensões CSS nominais podem não corresponder aos limites visíveis.
  • Quando o feedback for local, prefira uma mudança delimitada porque torna a comparação clara e protege o trabalho aceito.
  • Quando o valor de ajuste for vago, prefira uma mudança pequena e reversível e declare sua magnitude porque um palpite grande pode errar o equilíbrio pretendido.
  • Quando vários elementos mudam de estado, prefira um gatilho e recuperação coerentes porque seu feedback deve ser lido como uma interação. Não anime elementos não relacionados.
  • Quando o movimento não adicionar feedback útil ou conflitar com o estilo solicitado, prefira uma resposta estática porque movimento é uma escolha, não um requisito.
  • Quando uma ação for essencial, prefira controles utilizáveis pelo teclado, ponteiro e toque aplicáveis porque o hover não pode ser a única maneira de realizá-la.

Lista de Verificação de Qualidade

Verifique cada item relevante. Marque um estado como não aplicável quando o comportamento não o exigir.

  • Significado: rótulos, ícones, semântica e resultados da ação concordam. Use um botão para ações e um link para navegação; defina o tipo de botão deliberadamente dentro de formulários.

  • Geometria: legível no tamanho real; hierarquia e alinhamento pretendidos; sem sobreposição, corte ou deslocamento de layout não intencionais, inclusive com conteúdo longo e contêineres estreitos.

  • Estados: padrão, hover, foco, pressionado, selecionado, expandido, desabilitado, carregando, erro e sucesso conforme aplicável. Verifique entrada, saída, uso repetido e recuperação.

  • Acessibilidade: semântica nativa adequada, nomes e valores de estado acessíveis, ordem de foco lógica, foco visível, comportamento de teclado aplicável e tamanhos de alvo utilizáveis. Não confie apenas em cor.

  • Contraste: meça o texto e indicadores visuais necessários contra seus fundos reais em cada estado relevante; atinja o alvo de acessibilidade aplicável. Não julgue contraste apenas pela aparência.

  • Movimento: não obstrui a entrada; permanece coerente durante mudanças rápidas; respeita preferências de movimento reduzido.

  • Consistência: visualizações em tamanho real e detalhe refletem o mesmo design; integração preserva escolhas aceitas e comportamento do ambiente do produto.

  • Evidência: distinga implementação de verificação observada. Relate interações e limites não testados. Uma compilação bem-sucedida não é uma aprovação visual ou de acessibilidade.

  • Após uma mudança de cor, repita as verificações de contraste e harmonia afetadas. Para gradientes, verifique cores intermediárias e composição final, não apenas pontos finais ou amostras isoladas.

Saída

Forneça:

  1. Uma prévia HTML funcional com visualizações em tamanho real e ampliada, além de um arquivo editável de origem.
  2. Um breve resumo no chat das escolhas atuais e da última mudança.
  3. Verificações realizadas, resultados observados e limites materiais.
  4. Qualquer decisão de design não resolvida, ou o local de integração verificado quando a integração foi autorizada.

Para direção de cor não resolvida, inclua um pequeno conjunto de opções comparáveis, suas propriedades alteradas e a direção selecionada pelo usuário.

Exemplo Opcional

Leia EXEMPLO: link de navegação animado apenas quando um exemplo prático for útil. Suas imagens, valores e tecnologia não são padrões para novos trabalhos.

Leia EXEMPLO: refinamento de cor de portfólio apenas quando o fluxo de trabalho de cor precisar de um exemplo prático. Sua paleta não é um padrão.

Habilidades Relacionadas