Communitygithub.com

DevvGwardo/impeccable

Habilidade abrangente de design frontend — 23 comandos para modelar, auditar, polir e refinar UI. Use quando o usuário quiser projetar, redesenhar, modelar, criticar, auditar, polir, esclarecer, destilar, endurecer, otimizar, adaptar, animar, colorir, extrair ou melhorar uma interface frontend. Abrange sites, landing pages, dashboards, UI de produto, shells de aplicativo, componentes, formulários, configurações, onboarding e estados vazios. Lida com revisão de UX, hierarquia visual, arquitetura da informação, carga cognitiva, acessibilidade, desempenho, comportamento responsivo, temas, antipadrões, tipografia, fontes, espaçamento, layout, alinhamento, cor, movimento, microinterações, UX copy, estados de erro, casos extremos, i18n e sistemas de design/tokens reutilizáveis. Use também para designs sem graça que precisam de ousadia, designs barulhentos que precisam de calma, iteração ao vivo no navegador ou efeitos visuais ambiciosos. Não é adequado para tarefas apenas de backend ou não relacionadas a UI.

O que é impeccable?

Impeccable é uma habilidade de IA abrangente para design frontend de nível de produção. Ela oferece 23 comandos especializados que cobrem todo o ciclo de vida do design: desde a descoberta inicial e planejamento (`teach`, `shape`, `craft`), passando pela avaliação e refinamento (`critique`, `audit`, `polish`), até a correção de problemas específicos como clarificação de copy (`clarify`), adaptação responsiva (`adapt`) e otimização de desempenho (`optimize`). A habilidade é adequada para qualquer projeto que envolva interface de usuário — sites, landing pages, dashboards, componentes, formulários e estados de aplicativo — e opera com base em dois registros de design: **marca** (quando o design é o produto, como em landing pages) e **produto** (quando o design serve ao produto, como em dashboards). Impeccable também incorpora um conjunto rigoroso de leis de design compartilhadas que abrangem cor (usando o espaço de cor OKLCH), tipografia (comprimento de linha de 65–75 caracteres), layout (evitar cartões aninhados) e movimento (curvas de easing exponenciais). Além dos comandos orientados por IA, a habilidade inclui uma ferramenta CLI autônoma que escaneia arquivos HTML, CSS, JSX, TSX, Vue e Svelte em busca de mais de 25 antipadrões, como bordas laterais, texto gradiente e o template de métrica de herói, garantindo que o código de UI seja limpo e consistente. A execução de qualquer comando segue um padrão consistente (`impeccable:<comando> [alvo]`) e carrega um arquivo de referência detalhado que orienta o assistente de IA na tarefa específica.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add DevvGwardo/impeccable

Perguntar na sua IA favorita

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

Documentação

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:

  1. 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:teach primeiro.
  2. 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.
  3. 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.

ComandoCategoriaDescrição
impeccable:craft [feature]ConstruirFluxo completo de modelagem seguida de construção com iteração visual
impeccable:teachConstruirConfiguração única: reunir contexto de design, escrever PRODUCT.md e DESIGN.md
impeccable:documentConstruirGerar DESIGN.md a partir do código do projeto existente
impeccable:extract [target]ConstruirExtrair componentes e tokens reutilizáveis para o sistema de design
impeccable:shape [feature]ConstruirPlanejar UX/UI antes de escrever código
impeccable:critique [target]AvaliarRevisão de design de UX: hierarquia, clareza, ressonância emocional
impeccable:audit [target]AvaliarExecutar verificações de qualidade técnica (a11y, desempenho, responsividade)
impeccable:polish [target]RefinarPassada final, alinhamento com o sistema de design e prontidão para entrega
impeccable:bolder [target]RefinarAmplificar designs monótonos
impeccable:quieter [target]RefinarSuavizar designs excessivamente ousados
impeccable:distill [target]RefinarReduzir à essência
impeccable:harden [target]RefinarTratamento de erros, i18n, estouro de texto, casos extremos
impeccable:onboard [target]RefinarFluxos de primeira execução, estados vazios, caminhos de ativação
impeccable:animate [target]AprimorarAdicionar movimentos propositais
impeccable:colorize [target]AprimorarIntroduzir cor estratégica
impeccable:typeset [target]AprimorarCorrigir escolhas de fonte, hierarquia, dimensionamento
impeccable:layout [target]AprimorarCorrigir layout, espaçamento, ritmo visual
impeccable:delight [target]AprimorarAdicionar momentos de encanto
impeccable:overdrive [target]AprimorarAdicionar efeitos tecnicamente extraordinários
impeccable:clarify [target]CorrigirMelhorar UX copy pouco clara
impeccable:adapt [target]CorrigirAdaptar para diferentes dispositivos
impeccable:optimize [target]CorrigirMelhorias de desempenho
impeccable:liveIterarModo 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 #000 ou #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-left ou border-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 campanha
  • reference/product.md — Registro de produto: UI de aplicativo, dashboards, ferramentas
  • reference/typography.md — Sistemas tipográficos, pareamento de fontes, escalas modulares, OpenType
  • reference/color-and-contrast.md — OKLCH, neutros matizados, modo escuro, acessibilidade
  • reference/spatial-design.md — Sistemas de espaçamento, grades, hierarquia visual
  • reference/motion-design.md — Curvas de easing, escalonamento, movimento reduzido
  • reference/interaction-design.md — Formulários, estados de foco, padrões de carregamento
  • reference/responsive-design.md — Mobile-first, design fluido, consultas de container
  • reference/ux-writing.md — Rótulos de botões, mensagens de erro, estados vazios
  • reference/cognitive-load.md — Reduzir a sobrecarga cognitiva em interfaces
  • reference/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ção
  • reference/shape.md — Planejamento de UX/UI antes do código
  • reference/teach.md — Configuração de PRODUCT.md e DESIGN.md
  • reference/document.md — Geração de DESIGN.md a partir de código existente
  • reference/extract.md — Extração de tokens para o sistema de design
  • reference/critique.md — Revisão de design de UX
  • reference/audit.md — Verificações de qualidade técnica
  • reference/polish.md — Passada de qualidade final
  • reference/bolder.md — Amplificar designs seguros
  • reference/quieter.md — Suavizar designs barulhentos
  • reference/distill.md — Reduzir à essência
  • reference/harden.md — Prontidão para produção
  • reference/onboard.md — Fluxos de primeira execução e estados vazios
  • reference/animate.md — Animação proposital
  • reference/colorize.md — Introdução estratégica de cor
  • reference/typeset.md — Correções de tipografia
  • reference/layout.md — Correções de layout e espaçamento
  • reference/delight.md — Personalidade e toques memoráveis
  • reference/overdrive.md — Ir além dos limites convencionais
  • reference/clarify.md — Melhorias de UX copy
  • reference/adapt.md — Adaptação a dispositivos
  • reference/optimize.md — Desempenho de UI
  • reference/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

Habilidades Relacionadas