seo-audit

Visão geral da skill seo-audit

O que a skill seo-audit faz

A skill seo-audit ajuda um agente a conduzir uma revisão estruturada de SEO, em vez de partir direto para recomendações genéricas. Ela foi feita para diagnosticar por que um site está com desempenho fraco na busca orgânica, o que inspecionar primeiro e como transformar os achados em um plano de ação priorizado.

Para quem vale instalar esta skill seo-audit

Melhor encaixe:

• marketers e founders que querem um fluxo repetível de diagnóstico de SEO
• agentes que auditam sites SaaS, de conteúdo ou institucionais
• times lidando com queda de tráfego, problemas de indexação, rankings fracos ou questões on-page pouco claras
• qualquer pessoa que queira um seo-audit guide mais robusto do que um prompt isolado

Menos indicado para:

• usuários que procuram especificamente só detalhes de implementação de schema
• usuários fazendo geração programática de páginas para SEO
• usuários focados em otimização para busca com IA, e não em auditoria clássica de busca

O trabalho real que precisa ser resolvido

A maioria das pessoas que pede uma auditoria de SEO não quer apenas um checklist. Elas querem saber:

• o que provavelmente está bloqueando rankings
• quais evidências reunir primeiro
• o que não deve ser afirmado sem o acesso adequado
• quais problemas importam mais agora

Esta skill é útil porque impõe uma ordem de auditoria: primeiro rastreabilidade e indexação, depois base técnica, otimização on-page, qualidade de conteúdo e autoridade ou links. Essa sequência evita que recomendações de baixo valor tomem o espaço de problemas mais sérios de saúde do site.

O que diferencia esta skill de um prompt genérico

Os diferenciais práticos são:

• ela orienta o agente a checar primeiro o contexto de product marketing, se existir um arquivo local de contexto
• ela pede contexto ausente sobre o negócio e o site antes de auditar no escuro
• ela usa uma ordem clara de prioridade para os achados
• ela alerta explicitamente sobre uma limitação na detecção de schema markup quando se depende apenas do HTML obtido por fetch
• ela espera uma estrutura de relatório com resumo executivo e ações priorizadas

Esses detalhes importam porque muitas auditorias fracas de SEO soam confiantes, mas pulam o básico de indexação ou exageram no que realmente pode ser verificado com acesso limitado.

Como usar a skill seo-audit

Contexto de instalação da seo-audit

Instale a partir do repositório com:

npx skills add https://github.com/coreyhaines31/marketingskills --skill seo-audit

Isso adiciona a skill a partir de skills/seo-audit no repositório coreyhaines31/marketingskills. Não existe um instalador separado dentro da própria skill, então o passo prático de seo-audit install é o comando padrão de Skills acima.

Leia estes arquivos antes do primeiro uso

Para um caminho rápido e de alto sinal na leitura do repositório, abra:

1. skills/seo-audit/SKILL.md
2. skills/seo-audit/evals/evals.json
3. skills/seo-audit/references/ai-writing-detection.md

Por que nessa ordem:

• SKILL.md traz o fluxo de auditoria e o escopo
• evals/evals.json mostra como é uma boa execução na prática
• a referência de escrita ajuda a manter a saída da auditoria mais legível e menos artificial, o que importa se você for compartilhar os achados com clientes ou stakeholders

Quais inputs a skill precisa

A qualidade do seo-audit usage depende muito dos inputs que você fornece. No mínimo, informe:

• a URL do site
• o tipo de site: SaaS, e-commerce, publisher, negócio local, marketplace etc.
• o objetivo de SEO: mais leads, mais tráfego orgânico sem marca, recuperação após queda, melhores rankings para páginas-chave
• palavras-chave-alvo ou clusters de tópicos
• problemas conhecidos: migração, redesign, troca de CMS, perda de tráfego, reclamações de indexação
• escopo: site inteiro, seção, template ou página única
• nível de acesso: apenas web pública, dados do Search Console, analytics, exports de crawl, URLs de concorrentes

Se você omitir isso, a skill continuará utilizável, mas a saída vai tender para checagens on-page visíveis e heurísticas técnicas mais amplas.

Verifique o contexto local antes de fazer perguntas

Uma das partes mais úteis — e mais fáceis de passar batido — desta skill seo-audit é a instrução de ler .agents/product-marketing-context.md ou .claude/product-marketing-context.md primeiro, se o arquivo existir. Se você estiver usando a skill dentro de um repositório de projeto, isso pode eliminar o vai e vem básico sobre público, posicionamento e páginas prioritárias.

Isso melhora a qualidade da auditoria porque recomendações de SEO funcionam muito melhor quando estão ligadas ao produto real, ao funil e ao mercado.

Transforme um pedido vago em um prompt de auditoria forte

Input fraco:

• "Do an SEO audit of our site"

Input mais forte:

• "Run an SEO audit for https://example.com. We are a B2B SaaS company selling payroll software for remote teams. Primary goal is demo signups from non-brand organic search. Priority keywords are global payroll software, employer of record payroll, and multi-country payroll. Organic traffic dropped about 25% after a site redesign six weeks ago. Focus on crawlability, indexation, title and heading quality, internal linking, and content gaps on money pages. If something cannot be verified from public fetch alone, say so clearly."

Por que isso funciona:

• traz contexto de negócio
• define sucesso
• delimita o escopo
• abre espaço para incerteza baseada em evidência, em vez de certeza fabricada

Siga a ordem de auditoria pretendida

Um erro comum é começar por ajustes de copy. Esta skill tem mais valor quando usada na sequência para a qual foi desenhada:

1. Rastreabilidade e indexação
2. Fundamentos técnicos
3. Otimização on-page
4. Qualidade de conteúdo
5. Autoridade e links

Essa ordem muda o resultado. Se as páginas estiverem bloqueadas, canonicalizadas incorretamente ou mal interligadas, reescrever meta descriptions não vai corrigir o problema central.

O que a skill seo-audit deve inspecionar na prática

Pelos sinais do repositório e pelas expectativas dos evals, um bom seo-audit usage deve incluir verificações como:

• robots.txt
• presença e qualidade do sitemap XML
• sinais de indexação e crawl
• arquitetura do site e lógica de links internos
• title tags e meta descriptions
• estrutura de headings
• relevância e otimização do conteúdo
• prováveis problemas técnicos que afetem discoverability ou performance

Depois, ela deve organizar os achados em um relatório pronto para decisão, e não em uma lista solta de observações.

Respeite a limitação na detecção de schema

Este é um detalhe real de adoção, não uma observação menor. A skill alerta explicitamente para não afirmar "no schema markup found" com base apenas em resultados simples de fetch da página. Muitos sites injetam schema no client-side ou de formas que um fetch simples não captura.

Uma boa saída deve dizer algo como:

• "Schema markup could not be reliably verified from current fetch-based inspection."
• "Validate with rendered HTML, source inspection, or a schema testing workflow before concluding it is missing."

Isso torna a seo-audit skill mais confiável do que auditorias que exageram na certeza.

Use a estrutura de relatório esperada

Para garantir qualidade prática no handoff, peça que a skill produza:

• Executive Summary
• Technical SEO Findings
• On-Page SEO Findings
• Content Findings
• Prioritized Action Plan

Isso importa porque stakeholders raramente agem com base em notas brutas. Eles agem sobre problemas ranqueados com justificativa, impacto e próximos passos.

Use os evals para julgar a qualidade da saída

skills/seo-audit/evals/evals.json é um dos melhores arquivos para decidir se vale confiar e seguir usando esta skill. Ele mostra os comportamentos esperados:

• fazer perguntas de esclarecimento quando falta contexto
• priorizar rastreabilidade antes de polimento de conteúdo
• inspecionar o básico de robots e sitemap
• evitar afirmações de schema sem sustentação
• apresentar achados em uma estrutura utilizável

Se o seu agente não estiver fazendo isso, ele não está realmente seguindo bem a skill.

FAQ da skill seo-audit

Esta skill seo-audit é boa para iniciantes?

Sim, especialmente para iniciantes que precisam de uma sequência sensata de auditoria. Ela ajuda a evitar checagens aleatórias de SEO e oferece uma estrutura inicial mais clara. Mas iniciantes ainda precisam fornecer contexto de negócio, porque a skill não substitui saber quais páginas e consultas realmente importam.

Em que isso é diferente de pedir uma auditoria de SEO direto para uma IA?

Um prompt comum pode gerar uma lista plausível de dicas de SEO. Esta skill é melhor quando você quer:

• uma ordem de auditoria definida
• perguntas de escopo melhores
• menos afirmações sem suporte
• um relatório final mais útil

A principal vantagem prática não é "mais recursos". É menos adivinhação e melhor priorização.

Posso usar seo-audit para trabalho de SEO Content?

Sim, mas com a expectativa certa. A skill dá suporte a seo-audit for SEO Content ao revisar otimização on-page, qualidade de conteúdo e prováveis problemas de relevância. Ela não é, principalmente, um gerador de briefing de conteúdo. Use-a para diagnosticar se as páginas existentes estão alinhadas com intenção de busca, metadata, headings e estrutura do site antes de decidir o que reescrever ou criar.

Ela exige acesso ao Search Console ou analytics?

Não. Você pode usá-la apenas com inspeção pública do site. Mas o teto de qualidade é menor. Sem Search Console, analytics ou exports de crawl, a skill consegue identificar problemas prováveis, não validar completamente cada afirmação sobre performance ou indexação.

Quando eu não devo usar esta skill?

Pule esta skill se a sua necessidade principal for:

• apenas adicionar ou depurar schema markup
• geração de páginas em grande escala para cobertura de palavras-chave
• estratégia de visibilidade em busca com IA, e não diagnóstico clássico de SEO

Ela também é pouco indicada quando o usuário quer implementação imediata de correções sem antes entender o problema subjacente.

A referência de escrita é realmente relevante?

Sim, se a saída da auditoria for voltada a clientes ou publicada internamente. A referência em references/ai-writing-detection.md não é um arquivo de framework de SEO, mas melhora a qualidade de entrega. Recomendações mais limpas e menos obviamente escritas por máquina tendem a ser mais fáceis para os times confiarem e adotarem.

Como melhorar a skill seo-audit

Dê mais contexto de negócio para a skill seo-audit

A forma mais rápida de melhorar a seo-audit skill é parar de tratá-la como um scanner genérico. Diga a ela:

• quem é o público
• quais páginas mais importam
• qual evento de conversão realmente importa
• o que mudou recentemente
• quais consultas interessam

Isso transforma a auditoria de "observações de SEO" em "decisões de SEO".

Reduza o escopo quando o site for grande

Para sites grandes, peça uma destas opções em vez de uma auditoria completa vaga:

• homepage mais as 5 principais páginas de receita
• um diretório ou seção de blog
• um tipo de template
• um cluster de perda de tráfego

Escopos menores produzem achados mais precisos e recomendações mais acionáveis.

Peça evidências e rótulos de incerteza

Para evitar uma saída vaga ou enfeitada, solicite:

• problema observado
• por que isso importa
• nível de confiança
• correção recomendada
• impacto esperado
• o que exige validação adicional

Isso é especialmente útil para afirmações técnicas e de indexação, em que a inspeção pública pode ser incompleta.

Evite recomendações superficiais

Falha comum: a primeira saída foca demais em titles, palavras-chave e conselhos genéricos de "melhorar a qualidade do conteúdo".

Corrija isso pedindo:

• bloqueadores de crawl e index primeiro
• padrões de template de página, e não só observações pontuais em páginas isoladas
• caminhos de links internos para páginas prioritárias
• desalinhamento entre intenção de negócio e tipos de páginas que estão ranqueando

Isso mantém a seo-audit focada em alavancas reais, não em edições cosméticas.

Forneça exemplos de páginas fortes e fracas

Se você souber quais páginas performam bem e quais não, compartilhe as duas. Assim, a skill pode comparar:

• formato de title
• profundidade de headings
• estrutura de conteúdo
• links internos
• correspondência com a intenção
• alinhamento com conversão

Inputs comparativos costumam gerar recomendações melhores do que pedir uma auditoria fria do domínio inteiro.

Faça uma segunda rodada após a primeira auditoria

A primeira passada normalmente deve gerar uma lista priorizada, não o roadmap final. Bons prompts de follow-up incluem:

• "Expand only the top 3 technical issues with validation steps."
• "Turn the content findings into page-specific rewrite priorities."
• "Separate quick wins from engineering-heavy fixes."
• "Map each recommendation to likely impact and effort."

Esta é a melhor forma de transformar seo-audit usage em um plano de execução.

Fique atento a afirmações exageradas com acesso limitado

Se o agente não puder fazer crawl, renderizar JavaScript ou inspecionar configurações da plataforma, não deixe que ele fale como se tivesse visibilidade total. A skill já aponta na direção certa aqui. Preserve essa cautela. Isso aumenta a confiança e reduz falsos positivos.

Use a saída como uma camada de triagem

Este seo-audit guide funciona melhor como uma camada diagnóstica inicial antes de um trabalho especializado. Use-o para:

• identificar bloqueadores prováveis
• ranquear caminhos de investigação
• preparar resumos para stakeholders
• decidir se você precisa de SEO técnico mais profundo, trabalho de conteúdo ou suporte de implementação

Esse é um papel mais forte do que esperar que a skill sozinha substitua ferramentas completas de SEO ou acesso ao site em tempo real.