Communitygithub.com

bish-x/claude-bishx

Auditoria completa de sites — design UX/UI, marketing, SEO, acessibilidade, desempenho e conversão. Rastreia o site (até 100 páginas) via navegador cmux e gera uma crítica visual detalhada com recomendações acionáveis.

O que é claude-bishx?

Este skill realiza uma auditoria autônoma e abrangente de websites, indo além de métricas técnicas superficiais. Ele rastreia até 100 páginas usando um navegador headless (cmux) e avalia o site sob múltiplas perspectivas: design UX/UI, marketing, SEO, acessibilidade, desempenho, conversão, consistência de marca e arquitetura de informação. O resultado é um documento de crítica visual detalhada, focado em recomendações acionáveis de UX e marketing, e não na inspeção de código-fonte. A força do skill reside em seu princípio fundamental de "Avaliação Centrada no Humano". Em vez de aplicar uma checklist mecânica, ele prioriza entender quem é o visitante, qual é sua necessidade naquele momento e se cada elemento da página serve a essa necessidade. A auditoria é estruturada em cinco camadas (Para Quem, O Quê, Como, Sentimento, Comportamento) mais uma metacamada de Jornada, garantindo que a avaliação seja holística e contextual. Projetado para agentes de IA como Claude Code, Cursor e Codex, o skill fornece um conjunto de ferramentas (toolkit), não uma checklist rígida. Os limites numéricos são indicadores, e o agente deve usar seu julgamento — guiado pelo princípio fundamental — para decidir se um achado é relevante. Cerca de 15-20% dos alertas de limite são esperados como falsos positivos, que devem ser ignorados ou rebaixados, promovendo uma análise mais inteligente e menos mecânica.

Funciona com✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/bish-x/claude-bishx/tree/HEAD/skills/site

Perguntar na sua IA favorita

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

Documentação

Bishx-Site: Auditoria Completa de Site

Skill de auditoria autônoma de websites. Rastreia o site (até 100 páginas) via navegador cmux, analisando design UX/UI, marketing, SEO, acessibilidade, desempenho, conversão, consistência de marca e arquitetura de informação. Produz um único documento de crítica visual detalhada com recomendações acionáveis.

O resultado é uma CRÍTICA DE DESIGN, não código. Sem inspeção de código-fonte, sem detalhes de implementação técnica. Perspectiva pura de UX/marketing/visual: o que está errado, como alterar, onde exatamente mover e por que funciona melhor — em um nível de detalhe que um designer ou outro agente possa executar sem uma única pergunta de esclarecimento.


PRINCÍPIO FUNDAMENTAL: Avaliação Centrada no Humano

Esta é a base de toda a auditoria. Cada módulo, cada verificação, cada descoberta deriva deste princípio. As verificações específicas de cada módulo (posicionamento de CTA, contrastes, estrutura de cabeçalhos, velocidade de página) são INSTÂNCIAS CONCRETAS deste princípio abstrato — não regras independentes.

O Princípio

Todo elemento em uma página existe para servir a um humano específico em um momento específico. Quando uma página é organizada pela lógica do criador em vez da necessidade do visitante — isso é uma falha, independentemente de quão tecnicamente correta a página seja.

Um site pode obter 100 no Lighthouse, passar em todas as verificações WCAG, ter SEO perfeito — e ainda assim falhar com o humano que o visita.

Cinco Camadas + Metacamada

Toda avaliação de página — em qualquer módulo — passa por esta lente:

CAMADA 1 — PARA QUEM (a pessoa certa está sendo atendida?)

  • O conteúdo é escrito para a pessoa que realmente está olhando para esta página?
  • O tom corresponde ao estado emocional do visitante neste ponto? (ansioso na página de pagamento → precisa de segurança, não de empolgação; frustrado na página de erro → precisa de empatia, não de branding)
  • A página assume apenas o que o visitante realmente sabe? (sem jargões não explicados, sem referências a conceitos internos)

Estados do Visitante Além da "Primeira Visita":

Ao identificar QUEM está na página (HB1), considere estes estados:

EstadoO Que PrecisaO Que Falha
Comparação com várias abas (3-5 sites concorrentes abertos)Pontos de dados digitalizáveis (preço, recursos). Formato comparável. Extração rápida.Preços enterrados. Terminologia única. Métricas não padronizadas.
Frustrado / recuperação de erro (link quebrado, pagamento com falha, busca ruim)Reconhecimento da falha. Caminho claro de recuperação. Contexto preservado.Erro genérico. Dados de formulário perdidos. Nenhuma sugestão alternativa.
Urgente (informação de emergência, crítica em tempo)UM fato em <2 segundos. Zero interação necessária.Hierarquia de conteúdo que esconde a resposta. Popups. Atrasos de carregamento.
Relutante / forçado (deve usar, sem alternativa)Caminho mínimo para conclusão. Sem atrito desnecessário.Etapas extras. Upsells. Texto de marketing em páginas utilitárias.
Indicado (amigo enviou link, alta confiança, zero contexto)Página que se mantém sozinha sem contexto da página inicial.Assume navegação anterior. Jargão sem explicação.
Especialista / usuário avançado (conhece o domínio, busca dados específicos)Ir direto ao ponto de dados. Pular preâmbulo. Pesquisa aprofundada.Leitura linear forçada. Sem links de âncora. Sem detalhes expansíveis.
Sensível a preço (procurando custo total, taxas ocultas)Custo total transparente desde o início. Comparação clara."a partir de R$X" sem explicação. Taxas adicionadas no checkout.
Limitado pela situação (sol forte, uma mão, conexão lenta, tela pequena)Degradação graciosa. Alto contraste. Alvos grandes. Uso mínimo de dados.Texto cinza claro. Botões minúsculos. Ativos pesados sem lazy-load.

Estes NÃO são verificações separadas. São PERSPECTIVAS para o heartbeat HB1. Ao identificar o visitante, considere: em qual destes estados ele pode estar? A página deve funcionar para TODOS os estados prováveis do visitante, não apenas para o visitante "ideal" de desktop pela primeira vez.

CAMADA 2 — O QUÊ (o conteúdo certo está sendo mostrado?)

  • A página está organizada pela lógica do VISITANTE ou pela lógica do CRIADOR? (criador: recursos, departamentos, cronologia; visitante: problema, solução, prova, ação)
  • A profundidade corresponde à prontidão do visitante? (primeira visita → visão geral; fase de comparação → detalhes; pronto para agir → especificidades)
  • Nada desnecessário, nada crítico faltando?

CAMADA 3 — COMO (a apresentação está correta?)

  • O formato corresponde ao modo cognitivo do visitante? (escaneando → cabeçalhos, ícones, sinais visuais; lendo → texto completo, argumentos; decidindo → tabelas de comparação, calculadoras; fazendo → passo a passo, não prosa)
  • A informação está na ordem que o visitante precisa?

CAMADA 4 — SENSAÇÃO (como a página PARECE para usar?)

  • Controle: O visitante gerencia sua experiência, não o contrário. Sem reprodução automática sem consentimento. Sem registro forçado antes de mostrar conteúdo. Sem sequestro de rolagem. Sem popups interrompendo o fluxo. Botão voltar funciona. O visitante pode marcar, compartilhar e retornar a qualquer estado.
  • Padrões familiares: O site funciona como o resto da web (Lei de Jakob). Logo no canto superior esquerdo leva à página inicial. Busca no cabeçalho. Carrinho no canto superior direito. Botão "Avançar" à direita, "Voltar" à esquerda. Violar convenções da web custa esforço cognitivo — cada desvio deve ser justificado.
  • Proteção contra sobrecarga: A demanda cognitiva TOTAL da página é gerenciável. Cada elemento pode ser justificado individualmente, mas 5 CTAs + 3 banners + popup + ticker + widget de chat + animação JUNTOS = sobrecarga. Não se trata de elementos individuais — trata-se da SOMA de tudo competindo pela atenção.

CAMADA 5 — COMPORTAMENTO (como o site RESPONDE ao visitante?)

  • Previsibilidade: Cada elemento mostra o que acontecerá quando interagido. Botão rotulado "Baixar" baixa, não abre um formulário de registro. Link para "Preços" mostra preços, não "Fale com Vendas". Se o resultado não pode ser previsto pelo rótulo — é uma falha.
  • Transparência: Sem agenda oculta. Sem opt-ins pré-marcados. Sem taxas reveladas apenas no checkout. Sem "teste grátis" que exige cartão de crédito. Sem padrões escuros. O site trabalha A FAVOR do visitante, não CONTRA ele.
  • Feedback: Toda ação do visitante recebe reconhecimento. Clicar no botão → o botão responde visualmente. Enviar formulário → confirmação aparece. Adicionar ao carrinho → contador atualiza. Excluir item → mensagem "Excluído" com opção de desfazer. Silêncio após ação = o visitante não sabe se funcionou.
  • Perdão: O site assume que humanos cometem erros — e os torna reversíveis. Excluiu acidentalmente → pode recuperar. Fechou a aba → dados do formulário salvos. Botão errado → pode voltar. Entrada errada → pode editar sem recomeçar. Desfazer está sempre disponível para ações destrutivas.
  • Progresso: O visitante vê impulso para frente em direção ao seu objetivo. Formulário longo → barra de progresso. Processo de várias etapas → "Etapa 2 de 4." Artigo longo → tempo estimado de leitura. Carregamento → indicador de progresso. "Quanto falta?" deve sempre ter uma resposta.
  • Respeito pelo tempo: Cada elemento justifica seu custo de tempo. Sem vídeo de reprodução automática que força uma espera. Sem intersticial antes do conteúdo. Sem popup de "inscreva-se" 3 segundos após o carregamento. Sem etapas desnecessárias. Cada atraso ou interrupção diz "meu tempo importa mais que o seu".

METACAMADA — A JORNADA (a página funciona no contexto?)

  • Promessa = Realidade: O que o ponto de entrada prometeu (texto do botão, link, resultado de busca) corresponde ao que a página entrega
  • Esforço ≤ Valor: A página não pede mais do que dá (formulário de 10 campos para um PDF de 2 páginas = violação)
  • Confiança corresponde ao pedido: Quanto maior o compromisso solicitado (pagamento, dados pessoais), mais confiança a página deve conquistar primeiro
  • Próximo passo é claro: O visitante sabe o que fazer após esta página
  • Memorabilidade: Depois que o visitante sai — algo ficou? Eles conseguem descrever o site em uma frase? Eles lembram como ele difere dos concorrentes? Eles o encontrarão novamente? O preview do link compartilhado (tags OG) representa bem a página?

Como os Módulos Aplicam Este Princípio

Cada módulo é uma APLICAÇÃO DOMÍNIO-ESPECÍFICA deste princípio:

MóduloCamadas 1-3 (Conteúdo)Camadas 4-5 (Experiência)Meta (Jornada)
Design UXA composição guia a atenção para o que o VISITANTE precisa primeiro, não o que o criador quer mostrarProteção contra sobrecarga: carga visual total gerenciável. Padrões de layout familiares respeitados.Memorabilidade: identidade visual distinta
Conteúdo de MarketingA cópia atende à necessidade do visitante em seu idioma, profundidade e tom. Adequação conteúdo-público.Transparência: sem cópia manipuladora, sem urgência falsa. Previsibilidade: rótulos de CTA correspondem aos resultados.Promessa do título = conteúdo da página
ConversãoO caminho segue a lógica de decisão do visitante. Informação certa em cada ponto de decisão.Controle: sem portões forçados. Feedback: toda ação de formulário confirmada. Perdão: erros reversíveis. Progresso visível.Esforço ≤ valor. Confiança proporcional ao pedido.
SEO TécnicoA estrutura da página leva o visitante certo à página certa.Previsibilidade: snippet de busca corresponde ao conteúdo da página.Promessa = realidade no nível da busca
Conteúdo de SEOResponde à pergunta do visitante na profundidade necessária em seu idioma.Respeito pelo tempo: o conteúdo não é inflado. Cada parágrafo merece seu lugar.Visitante pode descrever o que aprendeu
AcessibilidadeTodo visitante acessa o conteúdo independentemente da habilidade.Controle: teclado funciona. Feedback: leitor de tela recebe anúncios. Perdão: erros explicados.A camada centrada no humano definitiva
DesempenhoA página carrega rápido o suficiente para preservar a intenção do visitante.Respeito pelo tempo: sem esperas desnecessárias. Progresso: indicadores de carregamento presentes.Rápido o suficiente para que o impulso não seja quebrado
Arquitetura de InformaçãoA navegação segue o modelo mental do visitante, não o organograma.Padrões familiares: posicionamento padrão da navegação. Previsibilidade: rótulos de links correspondem aos destinos.Visitante sempre sabe onde está e para onde ir
Consistência de MarcaExperiência consistente = visitante foca no conteúdo, não em "este é o mesmo site?"Familiar dentro do site: mesmos padrões em todos os lugares.Confiança através da consistência

Para Agentes: Como Usar Isto

Ao avaliar QUALQUER elemento em QUALQUER página:

  1. Primeiro — identifique QUEM está olhando para esta página e O QUE eles precisam agora
  2. Depois — verifique se o elemento atende a essa necessidade (Camada 1-2-3)
  3. Depois — verifique se o elemento funciona no contexto da jornada (Metacamada)
  4. Só então — aplique as verificações técnicas específicas do seu módulo

Se uma verificação técnica PASSAR mas o princípio for VIOLADO — isso é um achado. Se uma verificação técnica FALHAR mas o princípio for SATISFEITO — anote, mas prioridade menor.

O princípio não substitui verificações técnicas. Ele as PRIORIZA e CONTEXTUALIZA.

Kit de Ferramentas, Não Checklist

As verificações específicas de cada módulo (limiares FALHA/ALERTA) são um KIT DE FERRAMENTAS de padrões comuns — não uma checklist obrigatória a ser executada mecanicamente em toda página.

Como os limiares funcionam:

  • O Princípio Fundamental é seu guia PRIMÁRIO. Sempre.
  • Os limiares (ex.: ">3 CTAs = ALERTA") são AJUDANTES que capturam coisas que você pode perder
  • Quando limiar e princípio CONCORDAM — ótimo, relate o achado
  • Quando eles DISCORDAM — o princípio vence. Explique a discordância brevemente.
  • A substituição É esperada: em uma auditoria típica, ~15-20% dos acionamentos de limiar são falsos positivos que devem ser descartados ou rebaixados. Se você substituir ZERO limiares, está trabalhando mecanicamente — isso é a falha real.
  • NÃO substituir quando o princípio diz o contrário é pior do que substituir incorretamente

Avaliação em nível de propósito: Cada verificação em um módulo descreve O QUE avaliar, não COMO verificar mecanicamente.

  • "Verifique se a chamada para ação da página é clara" — NÃO "conte os botões e compare com 3"
  • "Verifique se a tabela é utilizável" — NÃO "verifique se cada célula tem contraste mínimo"
  • "Verifique se o formulário é acessível" — NÃO "conte os campos e compare com 5"

Os números/limiares específicos são EXEMPLOS do que comumente indica um problema. O agente aplica julgamento à página real, usando o princípio como guia.

Exemplo: Uma página de preços com 4 botões de CTA pode PASSAR se cada um servir a um plano diferente claramente. Uma página de preços com 1 botão de CTA pode FALHAR se for invisível ou enganoso. O número de CTAs é um indicador. O princípio ("o próximo passo está claro?") é o teste.

Protocolo para Elementos Desconhecidos

Quando um agente encontrar um elemento, widget ou padrão NÃO coberto pelo kit de ferramentas do módulo:

NÃO o ignore. Aplique o Princípio Fundamental diretamente:

  1. Identifique: O que é este elemento? (tour 3D, calculadora de hipoteca, mapa interativo, widget personalizado, aplicativo incorporado, visualização de dados, etc.)
  2. Propósito: O que ele deve fazer para o visitante?
  3. Avalie através das 5 camadas:
    • Camada 1: É para o público certo? Tom certo?
    • Camada 2: Contém o conteúdo certo na profundidade certa?
    • Camada 3: O formato é apropriado para o modo do visitante?
    • Camada 4: O visitante se sente no controle? É avassalador? Familiar o suficiente?
    • Camada 5: É previsível? Transparente? Dá feedback? Perdão?
  4. Meta: Se encaixa na jornada? Promessa = realidade?
  5. Se um problema for encontrado — crie um achado usando o modelo padrão. Marque-o como [Elemento Desconhecido] para que SYNTHESIZE possa rastrear novos achados.

Portão de significância: Aplique este protocolo apenas a elementos que sejam SIGNIFICATIVOS para o objetivo do visitante nesta página. Pule elementos decorativos/coséticos. Uma calculadora de hipoteca em uma página de propriedade = significativa. Uma animação decorativa = pule.

Protocolo de Heartbeat do Princípio

Agentes ESQUECERÃO o princípio durante a execução. Este protocolo evita isso.

Pontos de verificação obrigatórios — agentes DEVEM pausar e reaplicar o princípio nestes EXATOS momentos:

Heartbeat 1 — ANTES de iniciar a análise de cada página:

[HB1] Página: {url} | Complexidade: {simples/padrão/complexa}
Visitante: {quem} | Necessidades: {o quê} | Estado: {emoção}
Mente do Visitante (5 seg): {primeira impressão como visitante de primeira viagem — o que…

Habilidades Relacionadas