AgentSkillsCN

site-seo-and-sitemap

为本 Next.js 网站维护 SEO 元数据，并确保站点地图与 robots.txt 的正确生成。当您需要更改标题、描述、OG 图片、规范 URL、NEXT_PUBLIC_SITE_URL、next-seo 配置，或通过 next-sitemap 添加 sitemap.xml/robots.txt 时，可使用此技能。

SKILL.md
--- frontmatter
name: site-seo-and-sitemap
description: Maintain SEO metadata and sitemap/robots generation for this Next.js site. Use when changing titles/descriptions/OG images, canonical URLs, NEXT_PUBLIC_SITE_URL, next-seo configuration, or when adding sitemap.xml/robots.txt via next-sitemap.

site-seo-and-sitemap

Guia prático para manter SEO consistente no build e em produção.

Objetivo

  • •Garantir metas (title/description/canonical/OG/Twitter) coerentes em todas as páginas.
  • •Manter sitemap e robots coerentes com a URL pública final.

Quando usar (gatilhos)

  • •“Atualize Open Graph”, “corrija canonical”, “melhore SEO”, “adicione sitemap/robots”.
  • •Mudanças em NEXT_PUBLIC_SITE_URL, src/data/SeoConfig.js, src/layouts/AppLayout.js, next-sitemap.config.js.
  • •Problemas em preview/prod: OG com URL errada, ícones quebrados, canonical vazio.

Exemplos de prompt

  • •“A imagem de preview do LinkedIn está errada; corrija OG.”
  • •“Gere sitemap.xml e robots.txt no build.”
  • •“Padronize title/description/canonical por página.”

Inputs (o que pedir ao usuário)

  • •URL pública final (ex.: https://josenaldo.github.io).
  • •Para mudanças por página: quais rotas e quais títulos/descrições.

Princípios e regras

Crítico (não negociar)

  • •NEXT_PUBLIC_SITE_URL deve existir no build (local e CI). Ele alimenta SeoConfig e OG images.
  • •Canonical e OG devem ser URLs absolutas em produção.
  • •Arquivos gerados (sitemap.xml, robots.txt) precisam cair em public/ para serem servidos em produção.

Padrões recomendados

  • •Centralizar defaults em src/data/SeoConfig.js (via DefaultSeo em _app.js).
  • •Para páginas específicas, usar NextSeo no layout/página (já existe em AppLayout).

Workflow (faça em ordem)

  1. •Confirmar URL do site
  • •Definir/validar NEXT_PUBLIC_SITE_URL.
  • •Para dev local, considerar .env.local (não commitar secrets).
  1. •Revisar defaults
  • •Conferir src/data/SeoConfig.js: canonical, openGraph.url, images.url, ícones em additionalLinkTags.
  1. •Revisar por página
  • •Onde existir AppLayout, garantir title, description, image coerentes.
  • •Evitar meta duplicada/ruim em _app.js (o Head do template do Next pode conflitar com DefaultSeo).
  1. •Sitemap e robots
  • •Config em next-sitemap.config.js já existe.
  • •Se sitemap.xml/robots.txt não estiverem sendo gerados, adicionar execução do next-sitemap no pipeline (por exemplo, postbuild).
  1. •Validar
  • •Rodar npm run build e verificar se os arquivos finais estão no output publicado.

Saída esperada

  • •Patch com ajustes em SEO (config/layout) e instruções claras para setar NEXT_PUBLIC_SITE_URL.
  • •Se solicitado, incluir ajuste no build para gerar sitemap/robots.

Checklist

  • • NEXT_PUBLIC_SITE_URL definido para dev e CI.
  • • Canonical/OG usam URLs absolutas.
  • • Preview (Open Graph) aponta para imagem válida.
  • • Sitemap/robots gerados e publicados.

Consulte também

  • •web-design-guidelines (skill instalada)