audit

Visão Geral

O que é a skill audit?

A skill audit foi criada para desenvolvedores frontend e equipes que precisam avaliar sistematicamente a qualidade técnica do código. Ela verifica acessibilidade (A11y), desempenho, consistência de temas, design responsivo e padrões inadequados comuns. A skill gera um relatório pontuado com classificações de severidade (P0-P3) e planos de ação, ajudando a priorizar melhorias e manter altos padrões.

Quem deve usar a audit?

• Engenheiros frontend que querem validar a qualidade do código
• Equipes de QA focadas em acessibilidade e desempenho
• Líderes de projeto preparando para conformidade ou lançamento
• Qualquer pessoa que precise de uma auditoria estruturada a nível de código (não uma crítica de design)

Problemas que resolve

• Identifica lacunas de acessibilidade (contraste, ARIA, navegação por teclado, HTML semântico, texto alternativo, formulários)
• Detecta gargalos de desempenho
• Destaca problemas de theming e design responsivo
• Aponta padrões inadequados e dívida técnica
• Fornece classificações claras de severidade e próximos passos

Como Usar

Passos para instalação

1. Instale a skill audit usando:

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

2. Consulte o arquivo SKILL.md para instruções detalhadas e critérios de pontuação.

Preparação

• Antes de rodar a audit, invoque /frontend-design para coletar contexto de design e padrões inadequados. Se não houver contexto de design, execute /teach-impeccable primeiro.
• A skill audit foca em aspectos técnicos mensuráveis; ela não corrige problemas, apenas os documenta para acompanhamento.

Executando a audit

• Use a skill para escanear seu código frontend. Ela verifica cinco dimensões principais:
  • Acessibilidade (A11y)
  • Desempenho
  • Theming
  • Design responsivo
  • Padrões inadequados
• Cada dimensão recebe uma pontuação de 0 (problemas críticos) a 4 (conformidade excelente).
• O resultado é um relatório completo com classificações de severidade (P0-P3) e recomendações práticas.

Estrutura de arquivos e revisão

• Comece pelo SKILL.md para entender o fluxo de trabalho e detalhes da pontuação.
• Explore arquivos de suporte como README.md, AGENTS.md, metadata.json e pastas como rules/, resources/, references/ ou scripts/ para contexto adicional.

Perguntas Frequentes

A audit é adequada para revisões de design?

Não. A skill audit realiza verificações técnicas a nível de código. Para críticas de design, use /frontend-design ou skills relacionadas.

O que o relatório da audit inclui?

O relatório cobre acessibilidade, desempenho, theming, design responsivo e padrões inadequados, cada um pontuado e priorizado por severidade.

A audit corrige problemas automaticamente?

Não. A audit documenta os problemas e oferece planos de ação. Use outras skills ou correções manuais para resolver os achados.

Onde encontro os critérios de pontuação?

Os detalhes e checklists de pontuação estão no SKILL.md. Abra a aba Files para ver a árvore completa de arquivos e scripts auxiliares.

Quando devo usar a audit?

Use a audit antes de lançamentos, verificações de conformidade ou como parte de revisões regulares de qualidade de código para garantir que seu frontend atenda aos padrões técnicos.