normalize

Visão Geral

O que é a skill normalize?

A skill normalize audita e realinha interfaces de usuário para corresponder aos padrões, espaçamentos, tokens e padrões do seu sistema de design. Ela foi criada para equipes e profissionais que desejam garantir que sua UI permaneça visualmente consistente e siga os princípios de design estabelecidos, especialmente quando funcionalidades se desviam do sistema pretendido ou apresentam inconsistências.

Quem deve usar a normalize?

A normalize é ideal para designers de UI, engenheiros frontend e mantenedores de sistemas de design que precisam:

• Identificar e corrigir desvios no design ou estilos incompatíveis
• Alinhar funcionalidades aos tokens e padrões do sistema de design
• Auditar a UI para garantir consistência e conformidade com os padrões

Problemas que a normalize resolve

• Detecta e corrige inconsistências em componentes de UI
• Auxilia equipes a seguir as diretrizes do sistema de design
• Reduz implementações pontuais e desalinhamentos visuais

Como Usar

Passos para Instalação

1. Adicione a skill ao seu projeto:
   Use o comando abaixo para instalar a normalize do repositório Impeccable:

   npx skills add https://github.com/pbakaus/impeccable --skill normalize

2. Revise a Documentação Principal:

   • Comece pelo SKILL.md para entender o fluxo de trabalho e requisitos.
   • Consulte README.md, AGENTS.md e metadata.json para detalhes adicionais.
   • Explore as pastas rules/, resources/, references/ ou scripts/ para contexto e ferramentas extras.

Visão Geral do Fluxo de Trabalho

• Preparação Obrigatória:
  • Execute /frontend-design para acessar os princípios de design e o Protocolo de Coleta de Contexto. Se não houver contexto de design, rode /teach-impeccable primeiro.
• Planejamento:
  • Estude a documentação do seu sistema de design, diretrizes de UI e bibliotecas de componentes.
  • Analise a funcionalidade atual para identificar desvios e causas de inconsistência.
  • Elabore um plano de normalização detalhando as mudanças necessárias.
• Execução:
  • Aplique o plano, atualize os elementos da UI e garanta que todos os tokens e padrões estejam alinhados ao sistema de design.
• Finalização:
  • Revise as alterações para garantir completude e documente atualizações ou exceções.

Adaptando ao Seu Fluxo de Trabalho

A normalize é flexível — adapte suas orientações ao seu repositório, ferramentas e processos de equipe. Não copie as instruções literalmente; use a skill como referência para as melhores práticas de alinhamento de UI.

Perguntas Frequentes

Quando devo usar a normalize?

Use a normalize quando identificar inconsistências na UI, desvios no design ou tokens incompatíveis e quiser alinhar as funcionalidades ao seu sistema de design.

Quais arquivos devo revisar primeiro?

Comece pelo SKILL.md para uma visão completa do processo de normalização. Arquivos complementares como README.md e AGENTS.md oferecem contexto adicional.

A normalize faz alterações automaticamente?

Não, a normalize oferece um fluxo estruturado e melhores práticas para auditorias e realinhamentos manuais da UI. Ela orienta você na preparação, planejamento, execução e revisão.

Onde encontro mais detalhes ou scripts?

Abra a aba Files no repositório para explorar todos os recursos disponíveis, incluindo scripts auxiliares e referências para integração mais profunda.