on-page-seo-auditor

Visão geral da skill on-page-seo-auditor

O que a skill on-page-seo-auditor faz

A skill on-page-seo-auditor avalia o SEO on-page de uma única página e transforma a análise em um relatório com pontuação e correções priorizadas. Ela foca nos elementos que as equipes geralmente precisam revisar primeiro quando uma página está com desempenho abaixo do esperado: title tag, meta description, cabeçalhos, qualidade do conteúdo, uso de palavras-chave, links internos, imagens e sinais técnicos básicos.

Quem deve usar

Esta skill é mais indicada para especialistas em SEO, profissionais de content marketing, editores, equipes de growth e donos de sites que querem uma auditoria estruturada de página sem precisar montar um critério de avaliação do zero toda vez. Ela é especialmente útil quando a pergunta real não é “me ensine SEO”, mas sim “me diga por que esta página não está ranqueando e o que corrigir primeiro”.

Trabalho que ela resolve

A maioria dos usuários adota a on-page-seo-auditor para diagnosticar uma URL em relação a uma palavra-chave alvo e sair com uma lista de ações que pode ser repassada para um redator, editor ou desenvolvedor. O valor não está só em um checklist. Está na combinação de:

• um modelo de pontuação repetível
• análise seção por seção
• priorização de correções
• templates de saída que mantêm as auditorias consistentes entre páginas

O que diferencia esta skill

Em comparação com um prompt genérico do tipo “audite esta página”, a skill on-page-seo-auditor tem uma estrutura operacional mais forte. O repositório inclui:

• um exemplo completo de auditoria em references/audit-example.md
• padrões reutilizáveis de saída em references/audit-templates.md
• um sistema de pontuação em references/scoring-rubric.md

Isso faz diferença se você precisa de auditorias comparáveis ao longo do tempo ou entre várias URLs, e não apenas comentários pontuais.

Casos de melhor encaixe e casos de uso inadequado

Melhor encaixe:

• auditar uma landing page, post de blog, roundup, página de produto ou URL semelhante
• verificar se uma página está alinhada com uma palavra-chave principal e com a intenção de busca
• criar um briefing prático de otimização para atualizar conteúdo

Menos ideal para:

• rastreamento completo de site
• auditorias técnicas profundas de SEO
• análise de log, depuração de indexação ou trabalho de backlinks
• situações em que você não consegue fornecer a URL da página ou o conteúdo da página

Como usar a skill on-page-seo-auditor

Contexto de instalação da on-page-seo-auditor

O repositório não expõe um comando de instalação específico da skill em SKILL.md, então a maioria dos usuários instala a partir da coleção principal de skills e depois chama esta skill pelo nome no ambiente de AI skills. O padrão mais comum de instalação é:

npx skills add aaron-he-zhu/seo-geo-claude-skills --skill on-page-seo-auditor

A skill declara compatibilidade com Claude Code, skills.sh marketplace, ClawHub e o ecossistema de skills da Vercel Labs. Nenhum pacote de sistema é necessário. WebFetch é a ferramenta permitida mais importante, e acesso opcional a rede/MCP pode ajudar se sua configuração suportar ferramentas externas de SEO.

Quais entradas a skill precisa

Para gerar uma saída útil, forneça mais do que apenas uma URL. No mínimo, informe:

• a URL da página
• a palavra-chave principal alvo
• o tipo de página, se souber
• quaisquer palavras-chave secundárias importantes
• o objetivo de negócio ou de conversão

Entradas opcionais que melhoram bastante o resultado:

• país ou idioma de destino
• segmento de público
• concorrentes conhecidos
• se a página é informacional, comercial, transacional ou navegacional
• contexto de queda recente de ranking

Sem uma palavra-chave alvo, a auditoria ainda consegue revisar a qualidade da página, mas a pontuação sobre aderência à intenção e posicionamento da palavra-chave fica menos conclusiva.

Como transformar um pedido genérico em um bom prompt

Prompt fraco:

• “Check my page SEO”

Prompt melhor:

• “Use the on-page-seo-auditor skill to audit https://example.com/best-noise-cancelling-headphones for the keyword best noise cancelling headphones. Page type is commercial roundup. Secondary keywords: wireless noise cancelling headphones, ANC headphones. Evaluate title, meta, H1-H3 structure, content gaps, internal links, image alt text, and technical basics. Give me a scored report and top 5 fixes by impact.”

Esse formato funciona melhor porque fornece à skill a consulta-alvo, a intenção provável e a expectativa de saída.

Formato de prompt sugerido para equipes de SEO Content

Se você usa a on-page-seo-auditor em fluxos de SEO Content, um formato de prompt como este costuma funcionar bem:

• URL: ...
• Primary keyword: ...
• Secondary keywords: ...
• Page type: blog post / product page / landing page / comparison / roundup
• Audience: ...
• Market: ...
• Main conversion goal: ...
• Known issue: not ranking / rankings dropped / low CTR / weak engagement
• Output needed: scored audit + prioritized fixes + rewrite suggestions

Isso reduz a ambiguidade e melhora a priorização.

O que a saída da auditoria costuma cobrir

Com base nas referências e no rubric, a skill on-page-seo-auditor foi desenhada para pontuar oito seções principais:

• title tag
• meta description
• estrutura de cabeçalhos
• qualidade do conteúdo
• otimização de palavras-chave
• links internos
• imagens
• elementos técnicos

O rubric de pontuação do repositório atribui pesos a essas seções, o que é útil se você precisa de auditorias consistentes, e não apenas conselhos impressionistas.

Leia estes arquivos do repositório primeiro

Se você quiser entender como a skill pensa antes de confiar nela, leia estes arquivos nesta ordem:

1. SKILL.md
2. references/scoring-rubric.md
3. references/audit-example.md
4. references/audit-templates.md

Por que nessa ordem:

• SKILL.md mostra o escopo e o fluxo de trabalho
• o rubric explica como as pontuações são derivadas
• o exemplo completo mostra o formato do relatório final
• os templates ajudam você a adaptar a saída ao seu próprio processo

Fluxo prático para uma auditoria de página única

Um fluxo confiável de uso da on-page-seo-auditor costuma ser assim:

1. Escolha uma URL e uma palavra-chave principal.
2. Identifique o tipo de página e a intenção de busca mais provável.
3. Rode a auditoria com a URL, a palavra-chave e o contexto.
4. Revise as pontuações ponderadas, e não apenas a nota total.
5. Corrija primeiro os pontos fracos de maior impacto, normalmente title, alinhamento com a intenção, lacunas de conteúdo e links internos.
6. Rode a auditoria novamente após as atualizações para verificar se a pontuação e os problemas prioritários melhoraram.

Isso é melhor do que auditar muitas páginas de forma solta, porque a skill é mais forte como ferramenta focada de diagnóstico de página.

Dicas que melhoram materialmente a qualidade da saída

Algumas entradas mudam perceptivelmente a qualidade do resultado:

• Diga à skill se a página mira intenção informacional ou comercial.
• Forneça a palavra-chave exata, não apenas um rótulo de tema.
• Mencione se a página é uma atualização de conteúdo antigo.
• Peça priorização das correções por impacto e esforço, não só uma lista de problemas.
• Peça para separar “quick wins” do que “requires rewrite”.

Esses detalhes ajudam o modelo a evitar recomendações genéricas de SEO e a produzir sugestões prontas para implementação.

Como usar quando os rankings caíram

Se o seu caso real for “esta página costumava ranquear”, diga isso de forma explícita. Inclua:

• data aproximada da queda
• o que mudou na página, se algo mudou
• se impressões, cliques ou CTR caíram
• se os concorrentes atualizaram o conteúdo deles

A skill on-page-seo-auditor ainda não substitui Search Console nem diagnósticos de crawl, mas esse contexto ajuda a enquadrar a auditoria de página em torno de causas prováveis, em vez de se limitar a boas práticas estáticas.

Limites que você deve conhecer antes de instalar

Isto não é um crawler nem um substituto completo do Screaming Frog. Está mais para um framework estruturado de revisão de página. Na prática, isso significa:

• excelente para diagnóstico de uma página e ajustes editoriais
• mais fraco para detectar title duplicado no site inteiro
• mais fraco para problemas de renderização em JavaScript e SEO técnico avançado
• dependente de acesso ao conteúdo da página ou da possibilidade de buscar a URL

Se a sua necessidade é QA em todo o portfólio de páginas, o ideal é usar esta skill junto com um crawler, e não no lugar dele.

FAQ da skill on-page-seo-auditor

A skill on-page-seo-auditor é boa para iniciantes?

Sim, desde que você já saiba qual página quer auditar. Os templates e o rubric de pontuação reduzem a incerteza. Iniciantes ainda podem precisar de ajuda para interpretar trade-offs, mas a skill é mais utilizável do que um prompt em branco porque impõe uma estrutura de auditoria.

Qual é a principal vantagem em relação a um prompt comum?

A principal diferença é a consistência. Um prompt comum pode gerar um bom conselho uma vez. A skill on-page-seo-auditor entrega um padrão repetível de auditoria, pontuação ponderada e exemplos que você pode reutilizar em várias revisões de conteúdo.

Posso usar a on-page-seo-auditor para qualquer tipo de página?

Na maioria dos casos, sim, mas os resultados são melhores quando você informa o tipo de página. Um artigo de blog, uma página de produto, uma landing page e uma página de roundup não devem ser avaliados exatamente da mesma forma. As referências apontam explicitamente para uma auditoria sensível ao tipo de página.

Ela exige ferramentas externas de SEO?

Não. A skill pode funcionar como uma auditoria estruturada sem ferramentas externas. Integrações opcionais de rede ou MCP podem ajudar em alguns ambientes, mas não são obrigatórias para obter recomendações úteis no nível da página.

Isto é uma auditoria técnica completa de SEO?

Não. A on-page-seo-auditor foca fatores on-page e elementos técnicos leves visíveis em uma auditoria de página. Não é a ferramenta certa para crawl budget, análise de logs, canonicalização em escala ou troubleshooting de indexação.

Ela é útil para equipes de SEO Content?

Sim. Este é um dos melhores encaixes da on-page-seo-auditor para SEO Content porque ela transforma uma revisão vaga de qualidade em um briefing de otimização de conteúdo. Redatores e editores conseguem agir sobre recomendações ligadas a cabeçalhos, cobertura de tópicos, posicionamento de palavras-chave, links internos e elementos de conteúdo ausentes.

Quando eu não devo usar esta skill?

Não use como único fluxo de trabalho quando:

• você precisa de auditorias em todo o site
• os problemas de ranking provavelmente são causados por autoridade, links ou indexação
• você não consegue definir uma palavra-chave alvo
• você precisa de uma análise competitiva de SERP, e não de uma auditoria de página

Como melhorar a skill on-page-seo-auditor

Dê à skill on-page-seo-auditor um alvo de busca mais preciso

A forma mais rápida de melhorar os resultados da on-page-seo-auditor é estreitar o alvo. Use uma palavra-chave principal, não um conjunto de frases vagamente relacionadas. Se você tiver múltiplas intenções, rode auditorias separadas ou deixe claro qual é a principal.

Informe explicitamente o tipo de página e a intenção

Um modo de falha comum é pontuar uma página com base na intenção errada. Por exemplo, uma página de produto avaliada como se fosse um guia informacional vai receber recomendações de conteúdo enganosas. Diga à skill se a página é:

• informacional
• investigação comercial
• transacional
• local
• branded/navigation-focused

Isso muda completamente o que conta como “bom”.

Peça recomendações sustentadas por evidências

Se a primeira saída parecer genérica, refine o próximo prompt:

• peça para citar o elemento exato da página que causou a pontuação
• peça sugestões de reescrita para title, meta, H1 e seções fracas
• peça uma tabela de otimização antes/depois
• peça para separar problemas observados de problemas inferidos

Isso empurra a skill de “comentário sobre SEO” para “auditoria acionável”.

Melhore a utilidade da pontuação, não apenas a precisão da nota

Os usuários costumam focar demais no número final. Um uso melhor da on-page-seo-auditor é melhorar a qualidade da decisão:

• quais problemas estão bloqueando a relevância
• quais problemas estão derrubando o CTR
• quais problemas estão enfraquecendo profundidade ou confiança
• quais correções são mais rápidas de colocar no ar

Peça prioridades por impacto, confiança e esforço para tornar o relatório mais operacional.

Use as referências para calibrar suas expectativas

Os arquivos de apoio não estão ali só para preencher espaço. Eles melhoram materialmente o uso:

• references/scoring-rubric.md ajuda você a entender por que uma página teve nota baixa
• references/audit-example.md mostra o nível de especificidade esperado
• references/audit-templates.md ajuda a padronizar as saídas em toda a equipe

Se a primeira execução parecer superficial demais, compare com o exemplo completo e ajuste seu prompt para seguir a mesma estrutura.

Modos de falha comuns para observar

Saídas fracas normalmente vêm de entradas fracas:

• nenhuma palavra-chave alvo
• nenhum tipo de página
• nenhum contexto de público ou mercado
• pedir “tudo o que está errado” em vez de correções priorizadas
• esperar conclusões sobre o site inteiro a partir de uma única URL

A maioria dos maus resultados vem de problemas de formulação do prompt, não de problemas do repositório.

Como iterar após a primeira auditoria

Muitas vezes, um bom prompt de segunda rodada funciona melhor do que um prompt inicial mais longo. Depois do relatório inicial, peça:

• “Re-rank the issues by likely ranking impact.”
• “Rewrite the title, meta description, and H1 based on this audit.”
• “Turn the content gaps into an editor brief.”
• “Give me only quick wins I can ship today.”
• “Re-audit after these edits and compare score changes.”

Isso transforma a skill on-page-seo-auditor em um fluxo de revisão, e não em um diagnóstico pontual.

Melhor forma de usar a on-page-seo-auditor com outras skills

Esta skill combina bem com skills de pesquisa de palavras-chave, content brief e reescrita. Use-a depois que o direcionamento da palavra-chave estiver definido, mas antes ou durante as revisões da página. Na prática:

1. escolha a palavra-chave
2. audite a página
3. reescreva os elementos on-page mais fracos
4. audite novamente para conferir consistência

Essa sequência costuma ser mais produtiva do que tentar auditar antes de a consulta-alvo da página estar clara.