Skill: Site Frontmatter QC

Evita erros silenciosos e quebras no build: Contentlayer exige campos obrigatórios por tipo de documento.

Objetivo

• •Validar e padronizar frontmatter dos conteúdos do site.
• •Reduzir inconsistências (campos faltando, tipos errados, imagem inexistente).

Quando usar (gatilhos)

• •“O build quebrou por causa do Contentlayer.”
• •“Quero padronizar frontmatter dos posts/projetos/experiências.”
• •“Alguma página não aparece / está com metadados errados.”
• •“Quero revisar conteúdo antigo sem quebrar nada.”

Exemplos de prompt

• •"Verifique todos os arquivos em content/blog/ e aponte frontmatter faltando/inconsistente."
• •"Corrija o frontmatter deste projeto para ficar compatível com o Contentlayer."

Inputs (o que pedir ao usuário)

• •Escopo: pasta(s) alvo ou lista de arquivos.
• •Se existe alguma taxonomia desejada (categorias válidas, convenção de imagens).

Princípios e regras

Crítico (não negociar)

• •Seguir os campos obrigatórios definidos em contentlayer.config.js.
• •Não alterar URLs computadas; elas dependem do path do arquivo.
• •Datas devem ser datas válidas; booleans devem ser true/false.

Padrões recomendados

• •description específico: dizer o que o leitor ganha (não “sobre X” genérico).
• •image deve apontar para um asset em public/ (ex.: /images/...).

Decision Tree (quando houver variações)

1. •É erro de campo obrigatório ou qualidade editorial?

• •Obrigatório → corrigir primeiro.
• •Editorial → tratar com site-content-refresh/article-review.

Workflow (faça em ordem)

1. •Identificar o tipo de documento pelo path

Conforme contentlayer.config.js:

• •Blog (content/blog/**/*.md) → title, description, date, author, category, image
• •Pages (content/pages/**/*.md) → title, description, image
• •Projects (content/projects/**/*.md) → id (number), title, description, projectUrl, pin (boolean), image
• •Experiences (content/experiences/**/*.md) → id (number), title, company, location, period, show (boolean)
• •Testimonials (content/testimonials/**/*.md) → name, position, testimonial, image
• •Skills (content/skills/**/*.md) → name, level, firstContact (number)
• •Courses (content/courses/**/*.md) → name, institution, completionDate (date), workload (number), courseLink, certificateLink

1. •Checar presença e tipo

• •Campos faltando
• •Tipos errados (ex.: id como string)

1. •Checar consistência prática

• •image existe e segue convenção
• •projectUrl é URL válida

1. •Validar via build

• •Rodar npm run build para garantir que Contentlayer gerou sem erro.

Saída esperada

• •Lista de inconsistências encontradas
• •Patch nos arquivos afetados (quando solicitado)

Checklist

• • Campos obrigatórios presentes por tipo
• • Tipos corretos (date/number/boolean)
• • Imagens com caminho válido em public/
• • Build passa (npm run build)

Limitações e recomendações futuras

• •Esta skill não valida semanticamente “categoria boa”; isso depende de taxonomia definida pelo usuário.

Consulte também

• •site-content-refresh