CommunityEscrita e Ediçãogithub.com

jdevalk/skills

Audita um rascunho de postagem ou cópia de página quanto à otimização de SEO de conteúdo: adequação à intenção de busca, posicionamento da keyphrase, sinais E-E-A-T (experiência, especialização, autoridade, confiabilidade), utilidade e originalidade, atualização do conteúdo e links internos. Use quando o usuário perguntar 'isso vai rankear', 'verifique SEO deste post', 'auditoria de SEO de conteúdo' ou 'otimize este post para busca' — ou proativamente após uma passagem de legibilidade em um post que deve ranquear.

O que é skills?

O skill **jdevalk/skills** é uma ferramenta de auditoria de SEO de conteúdo para postagens e páginas. Ele avalia se o conteúdo merece ranquear com base em seis critérios-chave: adequação à intenção de busca do usuário (informacional, comercial, transacional ou navegacional), posicionamento natural da keyphrase (palavra-chave) em locais estratégicos, presença de sinais E-E-A-T (experiência, especialização, autoridade e confiabilidade), utilidade e originalidade (se o conteúdo agrega valor real), atualização (frescor) e encadeamento interno adequado. É indicado para uso em editoriais, blogs e sites que buscam ranquear, especialmente em conjunto com outros skills de legibilidade (readability-check) e metadados (metadata-check). A ferramenta detecta problemas como intenção incompatível, keyphrase forçada, falta de experiência, conteúdo desatualizado ou posts órfãos (sem links internos). Ela retorna um veredito geral ('Pronto', 'Corrigível' ou 'Conteúdo errado para a consulta') e recomenda correções concretas com trechos citados. Ideal para profissionais de marketing de conteúdo, SEOs e escritores que desejam validar se um post atende às expectativas dos mecanismos de busca e dos leitores.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/jdevalk/skills/tree/HEAD/content-seo

Installed? Explore more Escrita e Edição skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Perguntar na sua IA favorita

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

Documentação

Auditoria de SEO de conteúdo

Audite um rascunho de postagem ou página para saber se ele merece um ranking — não como ele é lido. Este skill cobre as questões de conteúdo: o post corresponde a uma intenção de busca real, ele usa as palavras que os buscadores usam, demonstra experiência e confiabilidade e dá ao buscador um motivo para ficar.

Este é o terceiro passo na cadeia de qualidade de escrita. Execute readability-check primeiro (como a prosa é lida), metadata-check no título e na meta descrição, e este skill na questão de se o conteúdo merece o clique. SEO técnico — sitemaps, dados estruturados, canônicos, desempenho — pertence ao astro-seo ou static-seo.

Antes de auditar

Você precisa de dois fatos. Se o usuário não os fornecer, deduza-os e declare sua suposição — uma suposição errada sinalizada é melhor do que uma silenciosa:

  • A keyphrase focus: a consulta exata pela qual este post deve rankear, nas palavras que um buscador digitaria. Se o usuário não conseguir nomear uma, deduza a keyphrase aparente a partir do título e dos cabeçalhos — e reporte isso como a primeira descoberta, porque um post escrito sem uma consulta-alvo geralmente não atende a nenhuma.
  • O público e seu problema: quem chega a esta página e o que eles estavam tentando resolver quando buscaram.

O leitor decide o que é qualidade, não o escritor. Cada verificação abaixo se reduz a uma pergunta: este conteúdo atende à pessoa que digitou a consulta melhor do que o que já está ranqueando?

O que verificar

Leia o post completo e, em seguida, relate cada um dos critérios abaixo. Para cada problema, cite o texto específico, referencie sua localização, explique o problema e sugira uma correção concreta.

1. Adequação à intenção de busca

Os buscadores chegam com uma de quatro intenções, e o tipo de conteúdo deve corresponder:

  • Informacional ("como X funciona") — quer um guia ou explicador, não um discurso de vendas.
  • Investigação comercial ("melhor X para Y", "X vs Z") — quer comparação e trade-offs honestos.
  • Transacional ("comprar X", "preços de X") — quer uma página de produto ou categoria com um caminho claro para a compra.
  • Navegacional ("login X", nomes de marca) — quer uma página específica; não a intercepte com um post de blog.

Verificações:

  • Nomeie a intenção dominante da keyphrase e verifique se o tipo de conteúdo corresponde. Uma página de vendas segmentando uma consulta informacional perde o visitante antes do segundo parágrafo — eles queriam uma resposta, receberam um discurso.
  • As chamadas para ação devem corresponder à intenção. Página informacional → CTA suave (leitura relacionada, newsletter); página transacional → caminho direto para o produto. Sinalize uma venda agressiva em um post informacional.
  • A resposta à pergunta do buscador deve aparecer cedo, não após 800 palavras de preâmbulo. Um buscador que precisa rolar para a resposta volta aos resultados — e esse retorno é o sinal negativo que custa rankings.

2. Posicionamento da keyphrase focus

A keyphrase confirma ao buscador — e ao mecanismo de busca — que esta página responde à consulta dela. Deve aparecer naturalmente nos lugares que ambos mais pesam:

  • O título da página e o primeiro parágrafo. Um buscador deve reconhecer sua consulta em segundos ao chegar.
  • Em pelo menos um ou dois cabeçalhos, onde se encaixe sem forçar.
  • Em várias frases centrais (a primeira frase de um parágrafo). Em um post bem estruturado que permanece no tópico, isso acontece por si só — se você tiver que forçar, o post se desviou do tópico, e essa é a verdadeira descoberta.
  • Use as palavras do buscador, não jargões internos. Se o público busca "velocidade do site" e o post diz "otimização de desempenho" em toda parte, o post é invisível para seu próprio público.

E as verificações inversas:

  • Nunca force. Se a keyphrase fizer uma frase soar errada, a frase vence. Mecanismos de busca reconhecem sinônimos e formas de palavras; leitores não perdoam prosa forçada.
  • Varie-a. A repetição mecânica da frase exata soa como preenchimento tanto para leitores quanto para mecanismos. Sinônimos e frases relacionadas cobrem mais consultas e são melhores de ler.

3. Sinais E-E-A-T

Avaliadores de qualidade de busca avaliam experiência, especialização, autoridade e confiabilidade. Esses não são virtudes abstratas — cada um é visível (ou ausente) no texto:

  • Experiência: o post mostra envolvimento de primeira mão — coisas que só alguém que realmente fez isso saberia? Números reais, capturas de tela de resultados reais, o que deu errado, o que surpreendeu o autor. Um post montado a partir de outros posts não tem nada disso, e isso aparece.
  • Especialização: o autor é identificado, com um motivo para confiar nele neste tópico? As alegações são fundamentadas — com links para referências confiáveis, em vez de apenas afirmadas?
  • Autoridade: o post cita ou se conecta a fontes reconhecidas no campo? Este é o alavanca mais fraca para a maioria dos sites — se não se aplicar, diga e pondere os outros três; não finja.
  • Confiabilidade: está claro quem é responsável por este conteúdo e como contatá-lo? As alegações são precisas e atuais? Para tópicos YMYL — saúde, dinheiro, segurança, jurídico — segure cada alegação ao padrão mais rigoroso; uma alegação médica ou financeira sem fonte é um ✗, não um ⚠.

4. Utilidade e originalidade

O teste de pessoas primeiro: este post existiria se os mecanismos de busca não existissem?

  • O post adiciona algo que os principais resultados atuais não têm — dados de primeira mão, um ângulo mais preciso, um exemplo trabalhado, uma limitação honesta? Um rehash competente do que já ranqueia não dá ao buscador motivo para preferi-lo e não dá ao mecanismo motivo para ranqueá-lo.
  • A resposta é completa? O buscador não deve precisar retornar aos resultados para terminar o trabalho. Sinalize perguntas que o post levanta mas não responde, e etapas que menciona mas não explica.
  • O problema do leitor é nomeado explicitamente e resolvido até o final? Um post que é sobre um tópico mas não resolve nada serve ao escritor, não ao leitor.

5. Atualização (frescor)

  • Sinalize conteúdo que envelhecerá: números de versão, preços, capturas de tela de interfaces de usuário, frase "ano passado" / "recentemente", referências a eventos atuais. Ou torne-os perenes ou date-os explicitamente para que o desatualização seja visível.
  • Sinalize conteúdo que já envelheceu: fatos desatualizados, ferramentas obsoletas, conselhos ultrapassados.
  • Para tópicos sensíveis ao tempo, recomende uma cadência de revisão. Um post que está certo hoje e errado daqui a seis meses precisa de uma entrada no calendário, não apenas de um botão de publicar.

6. Links internos e adequação ao site

Um post não ranqueia isoladamente — ranqueia como parte de um site:

  • O post deve linkar para conteúdo relacionado no mesmo site, especialmente o artigo principal sobre seu tópico, com texto âncora descritivo ("nosso guia de pesquisa de palavras-chave", nunca "clique aqui").
  • Posts relacionados devem linkar de volta. Um novo post sem links internos de entrada é um órfão — sinalize-o e nomeie os posts existentes que deveriam linkar para ele, se o usuário deu a você acesso ao site ou ao inventário de conteúdo.
  • Verifique canibalização: um post existente no mesmo site já segmenta esta keyphrase? Dois posts competindo por uma consulta dividem sua força; recomende mesclar, diferenciar ou redirecionar um deles.

Pontuação

Status por categoria — para cada uma das 6 verificações acima, atribua um de:

  • ✓ Passou — nenhum problema significativo.
  • ⚠ Precisa de trabalho — alguns problemas corrigíveis; listados abaixo.
  • ✗ Problema — problema sistêmico em todo o post.

Veredito geral — um de três:

  • Pronto — publique como está; apenas problemas menores.
  • Corrigível — conteúdo certo para a consulta, mas os problemas listados o seguram.
  • Conteúdo errado para a consulta — a incompatibilidade de intenção ou lacuna de originalidade não pode ser editada; o post precisa de um ângulo diferente ou de uma keyphrase alvo diferente. Diga isso claramente quando for verdade — polir um post que segmenta a consulta errada perde tempo do escritor.

Formato de saída

## Auditoria de SEO de conteúdo: [título do post]

### Alvo
- Keyphrase focus: [frase] ([declarada pelo usuário / deduzida — suposição])
- Intenção: [informacional / comercial / transacional / navegacional]
- Veredito: [Pronto / Corrigível / Conteúdo errado para a consulta]
- Por categoria: 1. ✓  2. ⚠  3. ✓  4. ✗  5. ✓  6. ⚠

### Resumo
[Um parágrafo: qual consulta este post atende, quão bem atende e a única ou duas mudanças que mais o moveriam.]

### Problemas encontrados
[Agrupados por categoria. Para cada: localização, texto citado, por que é um problema, correção concreta.]

### O que está funcionando
[Elementos específicos que ganham o ranking — um exemplo genuinamente de primeira mão, uma resposta completa colocada no início, uma referência principal bem linkada. Cite-os para que o escritor possa calibrar.]

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

jdevalk/skills

Sets up GitHub Actions CI/CD workflows for Astro sites — `astro check` (TypeScript + content schema), ESLint, Prettier, build verification, Vitest testing, Lighthouse CI, link checking, npm audit, and automated deployment to GitHub Pages, Cloudflare Pages, Netlify, or Vercel. ALWAYS use this skill when a user wants to create, add, set up, or configure GitHub Actions, CI/CD, automated checks, or deployment workflows for an Astro site — even if they don't use the exact phrase "GitHub Actions". This includes any request to: add automated type-checking or linting to an Astro repo; set up `astro check` in CI; add Lighthouse or accessibility checks to PRs; configure Vitest in CI for an Astro project; auto-deploy an Astro site to GitHub Pages, Cloudflare Pages, Netlify, or Vercel from GitHub; add link checking or broken-link detection; add security scanning to an Astro pipeline; or generally "add CI", "add automated checks", "set up workflows", or "automate" anything related to an Astro site's GitHub repository. ...

jdevalk/skills

Audits and improves SEO for Astro sites. Use when the user asks to audit, set up, or improve SEO on an Astro site, or mentions head metadata, structured data, JSON-LD, sitemaps, IndexNow, Open Graph images, schema endpoints, NLWeb, hreflang, or search engine indexing in an Astro project. Produces drop-in code routed through `@jdevalk/astro-seo-graph` and chains into `metadata-check` for generated SEO strings.

jdevalk/skills

Audits and improves SEO for static HTML sites. Use when the user asks to audit, set up, or improve SEO on a static site (Hugo, Jekyll, 11ty, Gatsby, Next.js static export, hand-rolled HTML, or `wp-static-clone` output), or mentions head metadata, structured data, JSON-LD, sitemaps, IndexNow, Open Graph images, schema endpoints, NLWeb, hreflang, or search engine indexing for a static site. For Astro projects, use `astro-seo` instead — its recipes produce less hand-rolled boilerplate by routing through `@jdevalk/astro-seo-graph`.

Habilidades Relacionadas