audit

Visão Geral

O que é a skill audit?

A skill audit foi criada para desenvolvedores frontend e equipes que precisam verificar sistematicamente a qualidade técnica de suas interfaces web. Ela realiza auditorias no nível de código em acessibilidade, desempenho, theming, design responsivo e anti-padrões comuns. A skill gera um relatório com pontuação, classificando os problemas de P0 (crítico) a P3 (menor), e oferece recomendações práticas para melhorias. Isso a torna ideal para projetos que buscam atender aos padrões de acessibilidade, otimizar desempenho e manter código frontend de alta qualidade.

Quem deve usar a audit?

• Desenvolvedores frontend que querem aprimorar a qualidade do código
• Equipes se preparando para revisões de acessibilidade ou desempenho
• Projetos que buscam conformidade com WCAG e melhores práticas de design responsivo
• Qualquer pessoa que precise de uma auditoria técnica estruturada antes do lançamento ou refatoração

Problemas que resolve

• Identifica lacunas de acessibilidade (contraste, ARIA, navegação por teclado, HTML semântico, texto alternativo, formulários)
• Detecta gargalos de desempenho e anti-padrões
• Verifica consistência de theming e problemas de design responsivo
• Documenta problemas para ações futuras sem alterar diretamente o código

Como usar

Passos para instalação

1. Instale a skill audit usando:
   npx skills add https://github.com/pbakaus/impeccable --skill audit

Configuração inicial

• Comece pelo arquivo SKILL.md para uma visão detalhada do fluxo de trabalho da audit.
• Revise arquivos de apoio como README.md, AGENTS.md e metadata.json para contexto.
• Explore pastas como rules/, resources/, references/ e scripts/ para orientações adicionais e scripts auxiliares.

Orientações do fluxo de trabalho

• Antes de rodar a audit, invoque /frontend-design para coletar o contexto de design e siga o Protocolo de Coleta de Contexto.
• Se não houver contexto de design, execute /teach-impeccable primeiro, conforme necessário.
• A skill realiza varreduras diagnósticas em cinco áreas principais, pontuando cada uma de 0 (crítico) a 4 (excelente).
• Use o argumento hint para especificar a área a auditar (ex: feature, page, component).
• A skill documenta os problemas, mas não os corrige; utilize outros comandos para remediação.

Arquivos recomendados para pré-visualização

• SKILL.md (fluxo principal e critérios de pontuação)

Perguntas Frequentes

O que a skill audit verifica?

A skill audit verifica acessibilidade, desempenho, theming, design responsivo e anti-padrões no nível de implementação do código. Ela pontua cada área e gera um relatório com recomendações práticas.

A audit é adequada para críticas de design?

Não, a audit foca na qualidade técnica do código. Para revisões de design, use /frontend-design ou skills relacionadas.

Como me preparo para uma auditoria?

Siga o Protocolo de Coleta de Contexto via /frontend-design. Se o contexto de design estiver ausente, execute /teach-impeccable primeiro.

Onde encontro scripts e referências de apoio?

Abra a aba Files para explorar toda a árvore de arquivos, incluindo referências aninhadas e scripts auxiliares para contexto mais aprofundado.