Communitygithub.com

interface-feel

Use quando um aplicativo ou site precisa parecer mais polido, rápido ou premium, ao auditar ou corrigir a sensação da UI, animação, transições ou qualidade de interação, ou ao aplicar leis de UX, princípios de animação ou dicas de UI (Fitts, Hick, Doherty, atualizações otimistas, esqueletos, menu de comandos, toasts de desfazer, hit slop, triângulo seguro, transições de visualização) em um projeto web ou mobile.

O que é interface-feel?

O skill **interface-feel** é um guia abrangente para auditar e refinar a sensação, o movimento e a capacidade de resposta de interfaces de aplicativos web e mobile. Ele conduz um processo em três passos: primeiro, audita o projeto atual contra uma checklist de 40 itens – incluindo doze princípios de animação, oito leis de UX e vinte técnicas de UI – gerando um relatório detalhado; segundo, corrige cada item identificado seguindo padrões específicos descritos em sua documentação; e terceiro, verifica as mudanças para garantir que estão funcionando corretamente. O skill é compatível com qualquer projeto que use HTML, CSS e JavaScript, e depende de ferramentas como ripgrep, scripts de censo e um probe de página ao vivo para inspecionar a UI. Ele é particularmente útil para desenvolvedores que desejam melhorar a qualidade percebida de seus apps, implementar boas práticas de UX e animação, e garantir que a interface seja confiável e responsiva, respeitando sempre o design system e as regras de motion existentes no projeto.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/groseljgal/interface-feel/tree/HEAD

Perguntar na sua IA favorita

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

Documentação

Sensação da interface

O passe mestre para como uma interface se move e responde. Ele audita o que o aplicativo faz hoje contra quarenta itens (doze princípios de animação, oito leis de UX, vinte técnicas de UI) e um sistema de movimento, escreve um relatório e, em seguida, corrige cada descoberta seguindo o padrão daquele item. A maioria dos aplicativos já tem metade da lista; a auditoria afirma isso em vez de adicionar duas vezes. Velocidade, alvos e confiança sempre se aplicam; a decoração é contida em uma ferramenta de trabalho.

O próprio design system do projeto, tokens de movimento e regras prevalecem sobre qualquer coisa aqui. Orçamentos de performance (LCP, INP, tamanho do bundle), acessibilidade e texto são passes próprios além deste.

Arquivos neste skill

ArquivoUso
reference.mdcada um dos 40 itens: como verificar, o padrão de correção, quando pular, o que uma auditoria real encontrou
motion.mdo sistema de movimento: tokens, doze regras, padrões CSS, como auditar movimento
audit/census.shcenso de código: conta os padrões por trás de cada item, com referências de arquivo:linha
audit/probe.jsprobe de página ao vivo: alvos reais, durações, easings, figuras, cabeçalhos, campos de código, placeholders
report-template.mdo relatório de auditoria: uma linha de veredito por item, ordem de trabalho, o que não foi verificado

Passo 1: auditoria (não mude nada)

  1. Leia primeiro o design system do projeto, os tokens de movimento e as regras de UI.
  2. Execute o censo a partir da raiz do projeto: bash <caminho deste skill>/audit/census.sh . --show 5. Ele lê apenas a superfície entregue ao usuário (dependências, builds, cópias vendidas, testes, benchmarks, arquivos gerados e linhas de comentário são deixados de fora; adicione mais com CENSUS_EXCLUDE="dir1,dir2"). Instale ripgrep para uma execução rápida; sem ele, o script usa perl como fallback. Uma contagem é uma pista para abrir, não um veredito.
  3. Execute o aplicativo. Em cada página chave, execute audit/probe.js (cole no console, ou use await no executor JavaScript de uma ferramenta de navegador) a 1440 de largura e a 375, em cada tema do aplicativo. Ele rola a página inteira uma tela de cada vez e restaura a posição. Uma aba oculta não tem largura e não pinta quadros: mostre-a primeiro. Leia a saída com julgamento: um alvo marcado como spaced (sua distância para o próximo controle atinge o mínimo) é de menor gravidade; figuras só precisam de tabular-nums onde mudam; marque janelas mock decorativas como aria-hidden ou ignore suas linhas.
  4. Dirija manualmente o que nenhum script pode ver, com eventos de ponteiro reais (um clique de uma ferramenta de navegador, não um .click() sintético): pressione cada ação paga ou irreversível duas vezes rápido e conte os efeitos no servidor; limite a rede e uma gravação a 600 ms e pressione; abra e feche cada camada rapidamente e reabra-a no meio da saída, amostrando sua opacidade (motion.md, "Medindo uma reabertura"); pressione dentro de um menu que está fechando; digite uma consulta com acento e com maiúsculas/minúsculas diferentes; mova-se diagonalmente em direção a um submenu hover; botão Voltar do Android com uma camada aberta; deslize uma folha do telefone.
  5. Escreva o relatório a partir de report-template.md: todas as 40 linhas, cada uma presente, ausente, errada ou pular com uma razão, evidência como arquivo:linha ou um número, e construir ou escolher. Mostre-o antes de corrigir.

Passo 2: corrigir pela checklist

  1. Confiança primeiro: item 39 e qualquer coisa que possa dobrar uma cobrança ou perder dados, com um teste que falhe antes da correção.
  2. Itens Construir mudam o comportamento sem uma nova aparência (hit slop, triângulo seguro, gesto de voltar, dobra de acento, atalhos, entradas de menu de comandos, gravações otimistas, esqueletos, tokens de movimento, transições reversíveis). Corrija cada um pelo seu padrão em reference.md e motion.md, através dos próprios componentes e tokens do projeto, com um teste para qualquer lógica.
  3. Itens Escolher mudam a aparência ou o produto (cantos, placeholders desfocados, desfazer em vez de confirmar, um batimento de erro, um novo batimento de movimento, uma transição de visualização). Avalie cada um como antes e depois na escala 1 em ambos os temas, numerados e separáveis; construa apenas o que o proprietário escolher.
  4. Nunca troque decoração removida por nova decoração.

Passo 3: verificar

Execute novamente o censo e o probe e compare os números com o relatório. Dirija cada interação corrigida da maneira que um usuário faria, em ambos os temas, e separadamente na largura de telefone. Relate construído, testado, aprovado visualmente e implantado como fatos separados, e nomeie o que não pôde ser medido (sem telefone físico, sem build de produção).

A checklist

Os números correspondem a reference.md e ao relatório.

#ItemFalha quando
APrincípios de animação (motion.md)
1Squash e stretchum badge, ponto ou botão de aterrissagem para morto
2Antecipaçãoum pressionamento não tem estado dentro de um quadro (escala cerca de 0.97, cerca de 100 ms)
3Encenaçãouma camada aberta deixa a coisa primária pouco clara
4Pose para poseum botão ocupado, rótulo ou troca de ícone pula em largura ou conteúdo
5Continuidadeo conteúdo de uma camada chega soldado ao seu contêiner
6Entrada lenta, saída lentalinear ou ease padrão em movimento de UI; mais de três easings
7Arcosalgo viaja longe em linha reta
8Ação secundáriauma ação concluída não tem um segundo batimento de confirmação
9Tempo rápidouma resposta de UI acima de 300 ms; uma superfície fora de seus pares; saídas não mais curtas
10Feedback exageradoum envio inválido mostra apenas um tremor, sem batimento de cor
11Desenho sólidosombras e camadas discordam sobre luz e profundidade
12Apeloum fluxo real, em etapas na escala 1, mostra uma emenda
BLeis de UX
13Fittsum alvo real abaixo de 32 px no desktop ou 44 px em um telefone
14Áreas de clique maioresalvos ampliados aumentando a imagem, ou irmãos sobrepostos
15Hickmais de cinco itens em um bloco de menu
16Millermais de cerca de sete itens de nível superior não agrupados
17Dohertypressionar até a próxima pintura acima de 400 ms sem nada respondendo primeiro
18Posteluma variante de acento, maiúscula/minúscula ou espaçamento de uma consulta não encontra nada
19Jakobum padrão se comporta de maneira diferente de sua plataforma (submenu hover, voltar fecha uma camada)
20Frequência de usouma ação diária está a mais de um passo ou um comando de distância
CVelocidade e feedback
21Carregadores esqueletouma rota pinta em branco ou um spinner no quadro do clique
22Atualizações otimistasuma gravação reversível barata não mostra nada até o servidor responder
23Menu de comandosum destino é alcançável clicando, mas não digitando
24Dicas de atalhoum controle com um atalho não o mostra em sua dica de ferramenta
25Toasts de desfazeruma exclusão restaurável não tem desfazer (o proprietário decide se substitui uma confirmação)
26Stale-while-revalidateuma página revisitada espera em vez de pintar seus últimos dados
27Pré-renderizaçãouma página provável seguinte não é pré-buscada com intenção (julgue em produção)
28Placeholders desfocadosuma imagem carregando é uma caixa cinza
29Transições de visualizaçãouma abertura de grade para detalhes não tem morph de elemento compartilhado
30Deslizar para dispensaruma folha ou gaveta de telefone não pode ser fechada deslizando
31Animações interrompíveisreabrir durante uma saída reproduz a partir de zero
DPlataforma e detalhe
32Volta preditivaVoltar do Android com uma camada aberta sai da página
33Hit slopcontroles de ícone pequenos não têm crescimento de alvo invisível
34Insetos de área segurafloats inferiores ignoram env(safe-area-inset-*) com viewport-fit=cover
35Preenchimento automático de código únicoum campo de código não tem autocomplete="one-time-code" e inputmode="numeric"
36Números tabularesfiguras variáveis tremem (sem tabular-nums)
37Títulos equilibradosum título curto de várias linhas deixa um órfão (sem text-wrap: balance)
38Cantos contínuoscantos squircle não considerados (uma decisão de aparência: avalie)
EConfiança
39Chaves de idempotênciadois pressionamentos rápidos de uma ação paga ou irreversível fazem dois efeitos no servidor
40Triângulo seguroum submenu hover fecha com um movimento diagonal em direção a ele

Erros comuns

  • Adicionar o que já existe: esqueletos, cache e tokens de movimento geralmente já estão; o veredito é presente.
  • Deduplicação no cliente como guardião do dinheiro: dois cliques chegam antes de um re-renderizar desabilitar o botão. Proteja no servidor (atualização condicional, chave determinística, bloqueio) e segure o pressionamento em uma ref.
  • Aumentar a imagem em vez do alvo; verificar alvos apenas na largura do desktop enquanto uma regra de desktop mata o mínimo do telefone.
  • Keyframes para abrir e fechar: eles não podem reverter. Use transições em um atributo de estado, e torne uma camada de saída inert.
  • Tratar desfazer, cantos ou tom de erro como escolhas de engenharia. Eles pertencem ao proprietário.
  • Julgar pré-busca ou tempo em um servidor de desenvolvimento ou em uma aba de segundo plano.

Habilidades Relacionadas