content-refresher

Visão geral da skill content-refresher

O que a content-refresher faz

content-refresher é uma skill de fluxo de trabalho de SEO voltada para atualizar artigos antigos que perderam frescor, posições ou tráfego. Ela foi criada para um trabalho específico: diagnosticar a deterioração do conteúdo, decidir se vale a pena atualizar uma página e produzir um plano de refresh estruturado, em vez de edições vagas do tipo “melhore isso aqui”.

Quem deve usar esta skill

Melhor encaixe:

• redatores de SEO e estrategistas de conteúdo que gerenciam acervos de blog mais antigos
• agências que trabalham na recuperação de rankings de páginas já existentes
• donos de sites que perceberam que “o tráfego está caindo” e precisam de um processo de refresh repetível
• equipes que querem um briefing de atualização mais claro antes de reescrever conteúdo

Ela é menos útil se você estiver criando um artigo totalmente novo do zero ou investigando primeiro problemas de SEO técnico.

O trabalho real que ela resolve

A maioria dos usuários não quer apenas um texto reescrito. Quer responder a perguntas como:

• esta página está realmente entrando em declínio, ou há outro problema?
• o que deve ser atualizado primeiro?
• o que pode continuar como está?
• quais novas seções, estatísticas e sinais de frescor têm mais chance de recuperar a performance?

A content-refresher é mais forte quando você precisa dessa camada de decisão, e não apenas de geração de texto.

O que diferencia a content-refresher

O principal diferencial é a estrutura. A skill inclui:

• orientação para detectar declínio de conteúdo com faixas de severidade
• verificações de falso positivo para você não culpar o conteúdo por sazonalidade ou problemas técnicos
• templates de planejamento de refresh
• um exemplo pronto mostrando o formato de saída esperado

Isso a torna mais útil do que um prompt genérico de “atualize este artigo para SEO”, especialmente quando várias partes interessadas precisam de um plano defensável.

O que analisar antes de instalar

Leia estes arquivos primeiro:

• optimize/content-refresher/SKILL.md
• optimize/content-refresher/references/content-decay-signals.md
• optimize/content-refresher/references/refresh-example.md
• optimize/content-refresher/references/refresh-templates.md

Se esses arquivos combinarem com a forma como sua equipe já avalia conteúdos em queda, a content-refresher provavelmente será uma boa escolha.

Como usar a skill content-refresher

Contexto de instalação da content-refresher

O repositório indica compatibilidade com Claude Code, skills.sh marketplace, ClawHub e o ecossistema de skills da Vercel Labs. Não há dependência de pacotes de sistema. Acesso opcional à rede ou a MCP só importa se você quiser dados ao vivo de ferramentas de SEO durante a análise.

Se o seu ambiente oferece suporte direto a skills do GitHub, instale a partir do caminho do repositório que contém optimize/content-refresher.

Comece pelos arquivos certos do repositório

Não comece apenas pelo corpo completo da skill. Use esta ordem:

1. SKILL.md para condições de acionamento e fluxo de trabalho
2. references/content-decay-signals.md para a lógica de priorização
3. references/refresh-example.md para ver o formato de análise esperado
4. references/refresh-templates.md para transformar os achados em entregáveis úteis

Esse caminho de leitura reduz suposições e mostra se a saída da skill realmente atende ao que sua equipe precisa.

Quais entradas a content-refresher precisa

A content-refresher funciona melhor quando você fornece mais do que uma URL e “por favor, atualize isso”. Entradas fortes incluem:

• URL da página
• título atual e data de publicação
• data da última atualização
• palavra-chave alvo ou cluster de tópicos
• rankings atuais ou tendência de tráfego
• concorrentes conhecidos que agora estão acima da página
• texto do artigo ou outline por seções
• estatísticas, produtos, screenshots ou links desatualizados que você já suspeita
• objetivo de negócio: recuperar rankings, melhorar conversões, ganhar snippets ou apoiar visibilidade em GEO

Sem esse contexto, a skill ainda consegue montar um plano, mas as recomendações tendem a ficar mais genéricas.

Transforme um objetivo vago em um prompt útil

Prompt fraco:

• “Refresh this article for SEO.”

Prompt melhor:

• “Use the content-refresher skill on this post: [URL]. Traffic is down 32% YoY and rankings dropped from positions 4-5 to 10-12 for [keyword]. Published in 2023, never updated. I need a refresh plan that identifies what to keep, what to update, what new sections to add, stale statistics to replace, and whether the title should change.”

Esse prompt dá à skill um gatilho, um grau de severidade, um objetivo de negócio e um formato de saída.

Melhor padrão de prompt para usar a content-refresher

Uma estrutura prática é:

1. indicar o sinal de declínio
2. fornecer o contexto da página
3. definir o objetivo
4. pedir uma saída em etapas

Exemplo:

• “Apply content-refresher to this blog post. First, check whether the decline looks like true content decay versus seasonality or technical issues. Second, score refresh priority. Third, produce a refresh plan with section-level actions, updated title options, FAQ opportunities, source gaps, and a prioritized rewrite checklist.”

Isso se alinha de perto com as referências nativas da skill.

Fluxo de trabalho sugerido para projetos reais de refresh

Use a skill em quatro passagens:

1. Diagnóstico: confirmar o declínio e eliminar falsos positivos
2. Planejamento: identificar quais seções manter, expandir, remover ou adicionar
3. Briefing de reescrita: gerar instruções concretas para o redator
4. Revisão de execução: comparar o rascunho revisado com o plano de refresh

Esse fluxo funciona melhor do que pedir uma reescrita completa logo de cara, porque evita retrabalho desnecessário e preserva o que ainda está útil.

Como usar corretamente os sinais de performance

Uma das partes mais fortes da content-refresher para SEO Content é a estrutura de sinais de declínio. O arquivo de referência usa limites para queda de tráfego e de ranking, além de faixas de urgência como watch, warning, critical e emergency.

Use esses limites como apoio à decisão, não como verdade absoluta. Antes de atualizar, verifique:

• sazonalidade com comparações ano contra ano
• updates conhecidos de algoritmo
• problemas de crawl/indexação
• mudanças no rastreamento de analytics
• mudanças de produto ou de mercado que alteraram a intenção de busca

Se você pular essa etapa, pode atualizar a página errada ou resolver o problema errado.

Quais saídas esperar

Uma boa saída da content-refresher deve incluir:

• uma avaliação rápida da qualidade ou confiabilidade do conteúdo
• evidências de que a página realmente está desatualizada
• ações de refresh priorizadas
• recomendações de título e estrutura
• estatísticas e links a atualizar
• novas seções ou blocos de FAQ para adicionar
• um escopo de reescrita que separe “manter” de “substituir”

Se a saída pular direto para parágrafos reescritos sem explicar a lógica do refresh, peça primeiro o plano.

Quando pedir uma reescrita completa

Peça a reescrita apenas depois que o plano de refresh estiver consistente. A melhor sequência costuma ser:

• primeiro prompt: diagnóstico + plano de refresh
• segundo prompt: reescrita seção por seção com base no plano aprovado
• terceiro prompt: metadata, FAQ, links internos e atualizações de frescor on-page

Esse uso em etapas da content-refresher dá mais controle editorial do que uma geração em uma única passada.

Dicas práticas para melhorar a qualidade da saída

• Cole os headings atuais para o modelo marcar decisões de manter/atualizar/remover.
• Forneça deltas de tráfego ou ranking, não apenas “caiu”.
• Cite os concorrentes de SERP que tomaram sua posição.
• Diga ao modelo se a página deve continuar evergreen ou passar a ser específica de ano.
• Peça placeholders de substituição de fontes quando não houver verificação web ao vivo.
• Solicite “minimal necessary changes” se você quer recuperar rankings sem mexer demais na estrutura.

Casos de baixa aderência e barreiras de adoção

Não use a content-refresher como primeiro passo quando:

• a página nunca ranqueou de verdade
• o principal problema é SEO técnico
• a intenção de busca mudou completamente e a página precisa ser substituída, não atualizada
• você precisa de um fluxo de publicação com revisão de compliance e validação automática de citações

A skill é uma estrutura forte de planejamento, mas não elimina a necessidade de verificação factual e julgamento editorial.

FAQ da skill content-refresher

A content-refresher é melhor do que um prompt comum de SEO?

Na maioria dos casos, sim, se o problema for queda de performance em uma página existente. Um prompt comum pode reescrever texto, mas a content-refresher entrega um processo específico de refresh: detectar declínio, evitar falsos positivos, priorizar mudanças e estruturar a atualização.

A content-refresher é amigável para iniciantes?

Sim, mais do que muitas skills de SEO, porque as referências mostram limites, exemplos e templates. Ainda assim, iniciantes precisam entender métricas básicas de página e saber avaliar se uma fonte ou estatística está atualizada.

Posso usar a content-refresher sem ferramentas de SEO?

Sim. Você pode fornecer manualmente sinais de queda de tráfego, ranking ou sinais qualitativos de declínio. O resultado será melhor se você incluir dados do Search Console, analytics ou ferramentas de rank de terceiros, mas a skill não depende disso para funcionar.

A content-refresher serve só para posts de blog?

Não, mas posts de blog e páginas editoriais evergreen são o caso de uso mais claro. Ela também pode ajudar com guias, listicles, páginas comparativas e landing pages informativas. É menos natural para páginas de produto ou conteúdo altamente programático.

O que torna a content-refresher para SEO Content útil?

O valor dela não está apenas em “atualizar texto antigo”. Ela ajuda a decidir:

• se vale a pena salvar a página
• quais sinais de frescor realmente importam
• quanto da estrutura original deve permanecer
• onde novas seções, FAQs e evidências atualizadas podem aumentar a relevância

Isso é especialmente útil para equipes de conteúdo que gerenciam muitas URLs envelhecendo ao mesmo tempo.

Quando eu não devo usar a content-refresher?

Evite usar quando a página tiver problemas técnicos de indexação, canibalização ou um desalinhamento total com a intenção atual das SERPs. Nesses casos, ajuste primeiro a arquitetura ou o direcionamento da página antes de rodar um fluxo de refresh.

A skill gera o texto final pronto para publicar?

Ela pode ajudar nisso, mas seu valor mais forte está antes: análise, planejamento e orientação de reescrita. Trate-a primeiro como uma ferramenta de decisão e briefing.

Como melhorar a skill content-refresher

Dê à content-refresher evidências melhores

O maior salto de qualidade na saída vem de entradas melhores. Inclua:

• título antigo e atual
• histórico de publicação
• janelas de mudança de ranking e tráfego
• principais consultas afetadas
• páginas concorrentes que agora estão vencendo
• afirmações, screenshots, exemplos ou dados de preço desatualizados
• links internos apontando para a página

Isso permite que a skill produza um plano de refresh acionável, em vez de conselhos amplos demais.

Peça decisões em nível de seção

Um modo de falha comum é receber recomendações genéricas como “adicione mais profundidade”. Evite isso pedindo:

• “For each current H2, label keep, update, merge, remove, or replace.”
• “List exact new sections to add and why.”
• “Flag outdated year references, stats, products, and broken links.”

Assim, a content-refresher vira uma ferramenta de operação editorial, e não apenas um gerador de ideias.

Separe diagnóstico de reescrita

Se você pedir tudo de uma vez, o modelo pode reescrever demais antes de provar que a página realmente precisa ser atualizada. Para melhorar os resultados, use a content-refresher em etapas:

1. validação do declínio
2. plano de refresh
3. reescrita
4. QA em relação ao plano

Essa sequência normalmente aumenta a confiança na saída e reduz edição desperdiçada.

Force atualizações orientadas por fontes

Outro modo de falha comum é o falso frescor: trocar a redação sem atualizar as evidências. Peça que a skill produza:

• uma lista de estatísticas que precisam ser substituídas
• placeholders de citação para fontes atuais
• afirmações que exigem fact-check
• exemplos que devem ser trocados por versões mais recentes

Para SEO content, sinais de frescor só ajudam se a informação de base estiver realmente atualizada.

Restrinja a reescrita à sua intenção

Diga à skill se você quer:

• um refresh conservador para recuperar rankings
• uma expansão maior para competir com SERPs mais fortes
• adições de FAQ orientadas a GEO
• atualizações focadas em conversão preservando a intenção de busca

Sem essa orientação, a saída pode derivar para uma reescrita maior do que o necessário.

Use as referências fornecidas como templates reutilizáveis

A forma mais forte de melhorar o uso da content-refresher é reaproveitar seus arquivos de referência como formato de trabalho:

• limites de declínio em references/content-decay-signals.md
• formato de saída em references/refresh-example.md
• planejamento de seções em references/refresh-templates.md

Isso acelera as revisões em equipe, porque todo mundo passa a trabalhar com a mesma gramática de refresh.

Fique atento a estes modos de falha comuns

• tratar quedas sazonais como deterioração de conteúdo
• atualizar o texto, mas manter números ou links desatualizados
• adicionar seções que diluem a intenção de busca original
• mudar títulos de forma agressiva sem considerar a continuidade de URL/tópico
• atualizar páginas que, na prática, deveriam ser consolidadas ou substituídas

A maioria dos resultados ruins vem de diagnóstico incorreto, não de escrita fraca.

Itere depois da primeira saída

Depois do primeiro plano, faça perguntas de follow-up como:

• “Which 3 changes are highest ROI if I can only edit for one hour?”
• “What should I update without changing the URL?”
• “Which additions are most likely to improve snippet capture?”
• “What evidence gaps would block publication?”

Esses follow-ups tornam a content-refresher mais prática para prazos reais.

Como avaliar se o plano de refresh é bom

Um plano forte é específico o suficiente para que um redator execute sem precisar adivinhar. Ele deve deixar claro:

• por que a página perdeu performance
• se refresh é mesmo a correção certa
• o que permanece inalterado
• o que precisa ser atualizado agora
• como a estrutura revisada vai se alinhar melhor às SERPs atuais

Se essas respostas estiverem faltando, faça mais uma rodada antes de partir para o rascunho.