auditoria-blog

Realiza uma avaliação abrangente da saúde de todos os posts de um blog, gerando relatórios de qualidade, SEO, links e conteúdo desatualizado, com fila de ações priorizadas.

O que é auditoria-blog?

Esta skill automatiza uma auditoria completa de saúde para blogs, analisando todos os posts do projeto. Ela cobre pontuação de qualidade de conteúdo (escala de 30 pontos), otimização SEO (título, meta description, H1, alt text), validação de dados estruturados (BlogPosting, FAQ), mapeamento de links internos (detecção de páginas órfãs e sem saída), verificação de frescor (posts desatualizados há mais de 90 dias) e prontidão para citação por IA (passagens citáveis, formatação Q&A, TL;DR). A análise é feita de forma paralela por subagentes, tornando o processo rápido mesmo para blogs grandes. Ao final, gera um relatório consolidado em Markdown com dashboards, tabelas por post, fila de ações priorizadas, relatório de canibalização de tópicos e recomendações de links. É ideal para desenvolvedores que mantêm blogs técnicos e querem melhorar a qualidade geral, SEO e a capacidade de serem citados por IAs generativas, funcionando em projetos com arquivos Markdown, MDX ou HTML.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/AgriciDaniel/claude-blog/tree/main/skills/blog-audit

Installed? Explore more Programação e Desenvolvimento skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Perguntar na sua IA favorita

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

Documentação

Auditoria de Blog -- Avaliação Completa de Saúde do Site

Realiza uma avaliação abrangente da saúde do blog em todos os posts do projeto. Verifica pontuações de qualidade, páginas órfãs, canibalização de tópicos, conteúdo desatualizado e prontidão para citação por IA. Usa subagentes paralelos para análise eficiente e produz uma fila de ações priorizada.

Processo de Auditoria

Etapa 1: Descobrir Arquivos do Blog

Escaneie o projeto em busca de todos os arquivos de conteúdo do blog:

  • Use glob para *.md, *.mdx, *.html em diretórios comuns de blog
  • Caminhos comuns a verificar:
    • content/
    • posts/
    • blog/
    • src/content/
    • _posts/
    • pages/blog/
    • articles/
    • src/pages/blog/
  • Filtre arquivos que não são do blog: README, CHANGELOG, LICENSE, arquivos de configuração, SKILL.md, package.json, node_modules
  • Relate: "Encontrados N arquivos de blog em [diretórios]"

Se nenhum arquivo de blog for encontrado nos locais padrão, procure em toda a raiz do projeto por arquivos markdown com frontmatter típico de blog (title, date, description).

Etapa 2: Análise Paralela

Crie subagentes via ferramenta Task para processamento paralelo em todos os arquivos de blog descobertos:

Agente de Qualidade de Conteúdo

  • Pontue cada post na escala de qualidade de conteúdo de 30 pontos
  • Verifique o comprimento dos parágrafos (alvo 40-80 palavras, limite máximo 150)
  • Verifique o comprimento das frases (alvo 15-20 palavras)
  • Avalie a estrutura de cabeçalhos e cabeçalhos em formato de pergunta
  • Avalie a legibilidade (Flesch Reading Ease alvo 60-70)

Agente de Otimização SEO

  • Verifique elementos de SEO on-page por post:
    • Comprimento da tag title (50-60 caracteres)
    • Meta description (150-160 caracteres, inclui estatística)
    • Presença e exclusividade do H1
    • Cobertura de texto alternativo de imagens
    • Contagem de links internos e externos
    • Qualidade do slug da URL

Agente de Validação de Schema

  • Detecte dados estruturados em todos os posts
  • Valide a completude do schema BlogPosting
  • Verifique a presença e o formato do schema FAQ
  • Confirme se dateModified corresponde ao frontmatter lastUpdated
  • Sinalize schema ausente ou malformado

Agente de Saúde dos Links

  • Mapeie links internos em todos os posts
  • Construa um grafo de links direcionado
  • Detecte páginas órfãs (zero links internos de entrada)
  • Detecte páginas sem saída (zero links internos de saída)
  • Verifique alvos de links internos quebrados
  • Recomende oportunidades de links bidirecionais

Agente de Verificação de Frescor

  • Leia lastUpdated ou dateModified do frontmatter de cada post
  • Calcule dias desde a última atualização
  • Sinalize posts não atualizados há 90+ dias
  • Categorize por prioridade de atualização

Agente de Prontidão para IA

  • Pontue cada post quanto à prontidão para citação por IA
  • Verifique citabilidade em nível de passagem (seções de 120-180 palavras)
  • Avalie formatação Q&A e clareza de entidades
  • Verifique a presença de caixas TL;DR e cápsulas de citação
  • Avalie acessibilidade para rastreadores de IA

Etapa 3: Detecção de Canibalização de Tópicos

Analise todos os posts em busca de concorrência de palavras-chave:

  1. Extraia a palavra-chave/tópico principal de cada post:
    • Texto do título
    • Cabeçalho H1
    • Meta description
    • Primeiro parágrafo
  2. Normalize as palavras-chave (minúsculas, remova stop words)
  3. Detecte múltiplos posts segmentando a mesma palavra-chave principal
  4. Sinalize posts concorrentes com uma das seguintes recomendações:
    • Mesclar: Combine dois posts fracos em um post forte
    • Redirecionar: Faça um redirecionamento 301 do post mais fraco para o mais forte
    • Diferenciar: Ajuste o foco para que os posts segmentem intenções distintas

Etapa 4: Detecção de Páginas Órfãs

Construa e analise o grafo de links internos:

  1. Para cada post do blog, extraia todos os links internos (relativos e absolutos)
  2. Construa um mapa de adjacência: { página -> [páginas para as quais ela linka] }
  3. Construa um mapa reverso: { página -> [páginas que linkam para ela] }
  4. Identifique páginas órfãs: posts com zero links internos de entrada
  5. Identifique páginas sem saída: posts com zero links internos de saída
  6. Para cada órfã, recomende 2-3 posts existentes que deveriam linkar para ela com base na relevância do tópico

Etapa 5: Detecção de Conteúdo Desatualizado

Audite a atualidade do conteúdo em todos os posts:

  1. Leia campos do frontmatter: lastUpdated, dateModified, date, updated
  2. Calcule dias desde a última atualização para cada post
  3. Categorize por prioridade de atualização:
    • Alta (>180 dias): Provavelmente desatualizado, estatísticas podem estar obsoletas
    • Média (90-180 dias): Revise para verificar precisão, atualize estatísticas
    • Baixa (<90 dias): Atualizado recentemente, nenhuma ação imediata
  4. Estime esforço de atualização por post:
    • Atualização leve: Atualize estatísticas, verifique links (1-2 horas)
    • Atualização moderada: Reescreva seções, adicione novos dados (3-4 horas)
    • Atualização pesada: Reescrita completa recomendada (5+ horas)

Etapa 6: Gerar Relatório do Site Inteiro

Agregue todos os resultados em um relatório abrangente:

Painel Resumo

## Relatório de Auditoria do Blog

**Data da Auditoria:** [data]
**Total de Posts:** N
**Pontuação Média:** XX/100

### Visão Geral da Saúde
| Métrica | Contagem |
|---------|----------|
| Posts com Pontuação 90+ (Excelente) | N |
| Posts com Pontuação 70-89 (Bom) | N |
| Posts com Pontuação 50-69 (Precisa Melhorar) | N |
| Posts com Pontuação <50 (Ruim) | N |
| Páginas Órfãs | N |
| Páginas sem Saída | N |
| Problemas de Canibalização | N |
| Conteúdo Desatualizado (90+ dias) | N |

Tabela por Post

### Pontuações por Post
| Post | Pontuação | Conteúdo | SEO | E-E-A-T | Técnico | Citação IA | Problemas |
|------|-----------|----------|-----|---------|----------|-----------|----------|
| [arquivo] | XX/100 | X/25 | X/20 | X/20 | X/15 | X/20 | [contagem] |

Fila de Ações Priorizada

### Fila de Ações Priorizada (Menor Pontuação Primeiro)
| Prioridade | Post | Pontuação | Problema Principal | Ação Recomendada |
|------------|------|-----------|--------------------|------------------|
| 1 | [arquivo] | XX | [problema] | [ação] |
| 2 | [arquivo] | XX | [problema] | [ação] |

Relatório de Canibalização

### Canibalização de Tópicos
| Palavra-chave | Posts Concorrentes | Recomendação |
|---------------|--------------------|--------------|
| [palavra-chave] | post-a.md, post-b.md | Mesclar / Redirecionar / Diferenciar |

Páginas Órfãs

### Páginas Órfãs (Sem Links de Entrada)
| Página | Links de Entrada | Fontes de Link Recomendadas |
|--------|------------------|----------------------------|
| [arquivo] | 0 | post-a.md, post-b.md, post-c.md |

Conteúdo Desatualizado

### Conteúdo Desatualizado
| Post | Última Atualização | Dias Desatualizado | Prioridade | Esforço de Atualização |
|------|--------------------|--------------------|------------|------------------------|
| [arquivo] | [data] | [N] | Alta/Média/Baixa | Leve/Moderada/Pesada |

Etapa 7: Salvar Relatório

Salve o relatório completo em blog-audit-report.md na raiz do projeto.

Após salvar, informe o usuário:

  • Localização do relatório: [raiz-do-projeto]/blog-audit-report.md
  • Resumo das descobertas (total de posts, pontuação média, contagem de problemas críticos)
  • Sugira executar /blog analyze <arquivo> no post com menor pontuação primeiro
  • Sugira executar /blog geo <arquivo> para otimização de citação por IA em posts importantes

Individual skills in this repo

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

Habilidades Relacionadas