| name | site-content-refresh |
| description | Revisão e atualização de conteúdo antigo (blog e capítulos do livro) com foco em clareza, consistência e manutenção do site (Next.js + Contentlayer). Use esta skill quando o usuário pedir para revisar peças antigas, padronizar textos, ajustar títulos/descrições, melhorar navegação e rodar validações do build. |
Skill: Site Content Refresh
Workflow de “manutenção editorial”: atualizar conteúdo sem reescrever à toa e sem quebrar o build/export.
Objetivo
- Revisar conteúdos antigos e produzir uma lista de mudanças objetivas.
- Manter consistência de frontmatter e estrutura para o Contentlayer.
Quando usar (gatilhos)
- “Estou revisando posts antigos e preciso padronizar.”
- “Quero revisar capítulos/posts antigos do site.”
- “Quero melhorar clareza, cortar gordura e fortalecer argumentos.”
- “Quero garantir que o build continue passando.”
Exemplos de prompt
- "Revise meus posts antigos de arquitetura: aponte o que cortar, o que expandir e o que reorganizar."
- "Revise os capítulos em
content/capitulos/ para ficarem mais consistentes e objetivos."
Inputs (o que pedir ao usuário)
- Quais itens revisar (paths, lista de URLs, ou filtro por pasta/categoria).
- Meta do refresh (SEO, clareza, padronização, atualização técnica).
Opcional:
- Preferências de tom e nível de intervenção.
- Se o usuário quer manter datas originais ou atualizar a data.
Princípios e regras
Crítico (não negociar)
- Não mudar significado histórico sem confirmação (experiências/projetos).
- Não quebrar campos obrigatórios do Contentlayer.
- Mudanças devem ser “explicáveis”: cada ajuste precisa de motivo (clareza, precisão, consistência, SEO).
Padrões recomendados
- Padronizar: títulos claros, descrições específicas, seções com propósito.
- Preferir consistência ao “texto perfeito”.
Decision Tree (quando houver variações)
- O problema é conteúdo ou metadado?
- Conteúdo → revisão (usar
article-review).
- Metadado/estrutura → usar
site-frontmatter-qc.
- O item está desatualizado tecnicamente?
- Sim → adicionar “atualização” com data, ou ajustar o texto (sem reescrever tudo).
- Não → focar em clareza e concisão.
Workflow (faça em ordem)
- Inventariar itens
- Listar arquivos-alvo e seus metadados essenciais.
- Diagnóstico rápido por item
- O que está bom?
- O que está fraco?
- O que está errado/desatualizado?
- Aplicar mudanças mínimas de alto impacto
- Título/description mais específicos.
- Cortar repetições.
- Inserir exemplo concreto quando o texto está abstrato.
- Validar build do site
- Rodar
npm run build para pegar erros do Contentlayer/export.
Saída esperada
- Lista de itens revisados com “mudanças feitas” + “pendências”.
- Patches aplicados nos arquivos do
content/blog/** e/ou content/capitulos/**.
Checklist
Limitações e recomendações futuras
- Se houver muitos itens, trabalhar em lotes (ex.: 5–10 por vez).
Consulte também
site-frontmatter-qcarticle-review
