Impeccable — Habilidade de Design Frontend
Projeta e itera interfaces frontend de nível de produção. Código real e funcional, escolhas de design comprometidas, excepcional artefato.
Baseado em pbakaus/impeccable (Apache 2.0), que por sua vez se baseia na habilidade de design frontend da Anthropic.
Configuração
Antes de qualquer trabalho de design ou edição de arquivos:
- Leia o contexto — Verifique se existem os arquivos PRODUCT.md / DESIGN.md na raiz do projeto. Se PRODUCT.md estiver ausente ou for um espaço reservado (<200 caracteres), sugira que o usuário execute
impeccable:teachprimeiro. - Identifique o registro — Cada tarefa de design é marca (marketing, landing, campanha, portfólio: o design É o produto) ou produto (UI de aplicativo, admin, dashboard, ferramenta: o design SERVE ao produto). Identifique antes de projetar.
- Carregue a referência do registro — Use a referência de marca ou produto dos arquivos de referência desta habilidade, dependendo do registro.
Comandos
Quando o usuário invocar um comando específico do impeccável (por exemplo, "audite esta página", "polir o checkout"), siga o padrão: impeccable:<comando> [alvo]. Cada comando tem um arquivo de referência no diretório de referência desta habilidade.
| Comando | Categoria | Descrição |
|---|---|---|
impeccable:craft [feature] | Construir | Fluxo completo de modelagem seguida de construção com iteração visual |
impeccable:teach | Construir | Configuração única: reunir contexto de design, escrever PRODUCT.md e DESIGN.md |
impeccable:document | Construir | Gerar DESIGN.md a partir do código do projeto existente |
impeccable:extract [target] | Construir | Extrair componentes e tokens reutilizáveis para o sistema de design |
impeccable:shape [feature] | Construir | Planejar UX/UI antes de escrever código |
impeccable:critique [target] | Avaliar | Revisão de design de UX: hierarquia, clareza, ressonância emocional |
impeccable:audit [target] | Avaliar | Executar verificações de qualidade técnica (a11y, desempenho, responsividade) |
impeccable:polish [target] | Refinar | Passada final, alinhamento com o sistema de design e prontidão para entrega |
impeccable:bolder [target] | Refinar | Amplificar designs monótonos |
impeccable:quieter [target] | Refinar | Suavizar designs excessivamente ousados |
impeccable:distill [target] | Refinar | Reduzir à essência |
impeccable:harden [target] | Refinar | Tratamento de erros, i18n, estouro de texto, casos extremos |
impeccable:onboard [target] | Refinar | Fluxos de primeira execução, estados vazios, caminhos de ativação |
impeccable:animate [target] | Aprimorar | Adicionar movimentos propositais |
impeccable:colorize [target] | Aprimorar | Introduzir cor estratégica |
impeccable:typeset [target] | Aprimorar | Corrigir escolhas de fonte, hierarquia, dimensionamento |
impeccable:layout [target] | Aprimorar | Corrigir layout, espaçamento, ritmo visual |
impeccable:delight [target] | Aprimorar | Adicionar momentos de encanto |
impeccable:overdrive [target] | Aprimorar | Adicionar efeitos tecnicamente extraordinários |
impeccable:clarify [target] | Corrigir | Melhorar UX copy pouco clara |
impeccable:adapt [target] | Corrigir | Adaptar para diferentes dispositivos |
impeccable:optimize [target] | Corrigir | Melhorias de desempenho |
impeccable:live | Iterar | Modo de variante visual: iterar nos elementos no navegador |
Roteamento
- Nenhum alvo especificado: Renderize a tabela de comandos agrupada por categoria, pergunte o que desejam fazer.
- Comando corresponde: Carregue seu arquivo de referência do diretório reference/ desta habilidade e siga suas instruções.
- Nenhuma correspondência, mas relacionado a design: Aplique as leis de design compartilhadas e a referência do registro diretamente.
Leis de Design Compartilhadas
Aplique a cada design, ambos os registros. Combine a complexidade da implementação com a visão estética. Varie entre projetos; nunca convirja para as mesmas escolhas.
Cor
- Use OKLCH. Reduza o croma conforme a luminosidade se aproxima de 0 ou 100; croma alto nos extremos parece berrante.
- Nunca use
#000ou#fff. Matize cada neutro em direção ao matiz da marca (croma 0.005–0.01 é suficiente). - Escolha uma estratégia de cor antes de escolher as cores. Quatro etapas no eixo de comprometimento:
- Contida: neutros matizados + um acento ≤10%. Padrão de produto; minimalismo de marca.
- Comprometida: uma cor saturada cobre 30–60% da superfície. Padrão de marca para páginas orientadas por identidade.
- Paleta completa: 3–4 funções nomeadas, cada uma usada deliberadamente. Campanhas de marca; visualização de dados de produto.
- Envolvente: a superfície É a cor. Heroínas de marca, páginas de campanha.
- A regra "um acento ≤10%" é apenas para Contida. Comprometida / Paleta completa / Envolvente a excedem propositalmente.
Tema
Escuro vs. claro nunca é um padrão. Não escuro "porque ferramentas parecem legais escuras." Não claro "para estar seguro."
Antes de escolher, escreva uma frase da cena física: quem usa isso, onde, sob que luz ambiente, com que humor. Se a frase não forçar a resposta, não é concreta o suficiente. Adicione detalhes até que force.
"Painel de observabilidade" não força uma resposta. "SRE olhando para a gravidade de um incidente em um monitor de 27 polegadas às 2h da manhã em uma sala escura" força.
Tipografia
- Limite o comprimento da linha do corpo a 65–75 caracteres.
- Hierarquia por meio de contraste de escala + peso (proporção ≥1.25 entre os níveis). Evite escalas planas.
Layout
- Varie o espaçamento para ritmo. O mesmo preenchimento em todos os lugares é monotonia.
- Cartões são a resposta preguiçosa. Use-os apenas quando forem realmente a melhor metáfora. Cartões aninhados estão sempre errados.
- Não envolva tudo em um container. A maioria das coisas não precisa de um.
Movimento
- Não anime propriedades de layout CSS.
- Desacelere com curvas exponenciais (ease-out-quart / quint / expo). Sem bounce, sem elástico.
Proibições Absolutas (Antipadrões)
Combine e recuse. Se você estiver prestes a escrever qualquer um destes, reescreva com estrutura diferente.
- Bordas laterais.
border-leftouborder-right>1px como um acento colorido em cartões, itens de lista, callouts ou alertas. Use bordas completas, fundos matizados, números/ícones iniciais ou nada. - Texto gradiente.
background-clip: text+ gradiente. Decorativo, nunca significativo. Use uma cor sólida única. Ênfase via peso ou tamanho. - Vidro fosco como padrão. Desfoques e cartões de vidro usados decorativamente. Raro e proposital, ou nada.
- O template de métrica de herói. Número grande, rótulo pequeno, estatísticas de suporte, acento gradiente. Clichê de SaaS.
- Grades de cartões idênticas. Cartões do mesmo tamanho com ícone + título + texto, repetidos infinitamente.
- Modal como primeiro pensamento. Modais são geralmente preguiça. Esgote alternativas embutidas/progressivas primeiro.
Copy
- Cada palavra merece seu lugar. Nenhum título reafirmado, nenhuma introdução que repita o título.
- Sem travessões. Use vírgulas, dois pontos, ponto e vírgula, ponto final ou parênteses.
O Teste de Slop de IA
Se alguém pudesse olhar para esta interface e dizer "IA fez isso" sem dúvida, ela falhou.
Verificação de reflexo de categoria — duas altitudes:
- Primeira ordem: se alguém pudesse adivinhar o tema + paleta apenas pela categoria ("observabilidade → azul escuro", "saúde → branco + verde-azulado", "finanças → azul-marinho + dourado", "cripto → neon sobre preto"), é o reflexo dos dados de treinamento. Retrabalhe a frase da cena e a estratégia de cor até que a resposta não seja óbvia a partir do domínio.
- Segunda ordem: se alguém pudesse adivinhar a família estética a partir da categoria mais antirreferências ("ferramenta de fluxo de trabalho de IA que não é SaaS-creme → editorial-tipográfico", "fintech que não é azul-marinho-e-dourado → modo escuro nativo de terminal"), é a armadilha um nível mais profundo. O primeiro reflexo foi evitado; o segundo não foi. Retrabalhe até que ambas as respostas não sejam óbvias.
Arquivos de Referência
Arquivos de referência detalhados estão disponíveis no diretório reference/ desta habilidade para cada comando e domínio de design. Carregue-os com skill_view(name='impeccable', file_path='reference/<nome>.md').
Principais referências de domínio de design (carregue para mergulhos profundos):
reference/brand.md— Registro de marca: marketing, landing, páginas de campanhareference/product.md— Registro de produto: UI de aplicativo, dashboards, ferramentasreference/typography.md— Sistemas tipográficos, pareamento de fontes, escalas modulares, OpenTypereference/color-and-contrast.md— OKLCH, neutros matizados, modo escuro, acessibilidadereference/spatial-design.md— Sistemas de espaçamento, grades, hierarquia visualreference/motion-design.md— Curvas de easing, escalonamento, movimento reduzidoreference/interaction-design.md— Formulários, estados de foco, padrões de carregamentoreference/responsive-design.md— Mobile-first, design fluido, consultas de containerreference/ux-writing.md— Rótulos de botões, mensagens de erro, estados vaziosreference/cognitive-load.md— Reduzir a sobrecarga cognitiva em interfacesreference/heuristics-scoring.md— Rubrica de avaliação heurística estilo Nielsen
Referências específicas de comandos (carregue ao comando correspondente):
reference/craft.md— Fluxo completo de modelagem seguida de construçãoreference/shape.md— Planejamento de UX/UI antes do códigoreference/teach.md— Configuração de PRODUCT.md e DESIGN.mdreference/document.md— Geração de DESIGN.md a partir de código existentereference/extract.md— Extração de tokens para o sistema de designreference/critique.md— Revisão de design de UXreference/audit.md— Verificações de qualidade técnicareference/polish.md— Passada de qualidade finalreference/bolder.md— Amplificar designs segurosreference/quieter.md— Suavizar designs barulhentosreference/distill.md— Reduzir à essênciareference/harden.md— Prontidão para produçãoreference/onboard.md— Fluxos de primeira execução e estados vaziosreference/animate.md— Animação propositalreference/colorize.md— Introdução estratégica de correference/typeset.md— Correções de tipografiareference/layout.md— Correções de layout e espaçamentoreference/delight.md— Personalidade e toques memoráveisreference/overdrive.md— Ir além dos limites convencionaisreference/clarify.md— Melhorias de UX copyreference/adapt.md— Adaptação a dispositivosreference/optimize.md— Desempenho de UIreference/live.md— Iteração de variante no navegador
Ferramenta CLI
O Impeccable também inclui uma CLI autônoma para detectar antipadrões de UI sem a necessidade de um harness de IA:
npx impeccable detect src/ # escanear um diretório
npx impeccable detect index.html # escanear um arquivo HTML
npx impeccable detect https://example.com # escanear uma URL (requer Puppeteer)
npx impeccable detect --fast --json . # apenas regex, saída JSON
Escaneia arquivos HTML, CSS, JSX, TSX, Vue, Svelte em busca de mais de 25 antipadrões. Código de saída 0 = limpo, 2 = problemas encontrados. Requer Node.js 18+.
Fonte
Original: github.com/pbakaus/impeccable Site: impeccable.style